Consolider une couche (Gestion des données)

Synthèse

Consolide une ou plusieurs couches en copiant toutes les sources de données référencées dans un seul dossier.

Utilisation

  • Un avertissement est émis lorsque cet outil détecte un type de couche non pris en charge. La couche non prise en charge ne sera pas écrite dans la sortie.

  • Si le paramètre Convertir les données en géodatabase fichier est coché, voici ce qui se passe :

    • Chaque source de données unique correspond à une géodatabase fichier créée dans le dossier ou paquetage consolidé.
    • Les formats raster et vectoriel compressés sont convertis en une géodatabase fichier et la compression est perdue.
    • Les données des géodatabases d'entreprise ne sont pas consolidées. Pour convertir les données de géodatabases d’entreprise en une géodatabase fichier, activez le paramètre Inclure les données de géodatabase d’entreprise plutôt que de référencer les données.

  • Si le paramètre Convertir les données en géodatabase fichier n’est pas coché, voici ce qui se passe :

    • Le format source des données des couches en entrée est préservé lorsque cela est possible.
    • Les formats raster ADRG, CADRG/ECRG, CIB et RPF sont convertis en rasters de géodatabase fichier. ArcGIS ne peut pas écrire ces formats de manière native. Ils sont convertis en rasters de géodatabase fichier pour des raisons d’efficacité.
    • Dans la structure de dossier en sortie, les géodatabases fichier sont consolidées dans un dossier propre à chaque version, et tous les autres formats sont consolidés dans le dossier commonData.
    • Les formats vectoriels et raster compressés ne sont pas découpés, même si une étendue est spécifiée dans le paramètre Extent (Étendue).

  • Pour les couches qui contiennent une jointure ou qui font partie d’une classe de relations, toutes les sources de données jointes ou associées sont consolidées dans le dossier en sortie. Par défaut, les sources de données jointes ou associées sont consolidées dans leur intégralité ou, en fonction du paramètre Sélectionner les lignes associées, selon l'étendue spécifiée à l'aide du paramètre Étendue.

  • Pour les couches d'entités, le paramètre Etendue permet de sélectionner les entités qui sont consolidées. Pour les couches raster, le paramètre Etendue permet de découper les jeux de données raster.

  • Certains jeux de données font référence à d'autres jeux de données. Par exemple, vous pouvez avoir un jeu de données de topologie qui référence quatre classes d'entités. Les réseaux géométriques, les réseaux et les localisateurs sont d'autres exemples de jeux de données référençant d'autres jeux de données. Lorsque vous consolidez ou empaquetez une couche en fonction de ces types de jeux de données, les jeux de données participants sont consolidés ou empaquetés.

  • Lorsque le paramètre Structure uniquement est sélectionné, seule la structure des sources de données en entrée est consolidée ou empaquetée. Une structure correspond à la structure ou à la conception d'une classe d'entités ou d'une table qui consiste en des définitions de champ et de table, des propriétés de système de coordonnées, une symbologie, des ensembles de définition, etc. Les données ou enregistrements ne sont ni consolidés, ni empaquetés.

  • Les sources de données qui ne prennent pas en charge la structure seule ne sont ni consolidées, ni empaquetées. Si le paramètre Schema only (Structure uniquement) est sélectionné et que l'outil détecte une couche qui n'est pas prise en charge pour la structure uniquement, un message d'avertissement apparaît et cette couche est ignorée. Si la structure seule n'est pas prise en charge pour l'unique couche spécifiée, l'outil échouera.

Paramètres

ÉtiquetteExplicationType de données
Couche en entrée

Couches en entrée qui sont consolidées.

Layer
Dossier en sortie

Dossier en sortie qui contient les fichiers de couche et les données consolidées.

Si le dossier spécifié n’existe pas, un nouveau dossier est créé.

Folder
Convertir les données en géodatabase fichier
(Facultatif)

Spécifie si les couches en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.

  • Activé - toutes les données sont converties en une géodatabase fichier. Cette option ne s'applique pas aux sources de données de géodatabases d'entreprise. Pour inclure des données de géodatabases d’entreprise, activez le paramètre Inclure les données de géodatabase d’entreprise plutôt que de référencer les données.
  • Désactivé : les formats de données sont conservés lorsque cela est possible. Il s’agit de l’option par défaut.
Boolean
Inclure les données de géodatabase d'entreprise plutôt que de référencer les données
(Facultatif)

Spécifie si les couches de géodatabases d'entreprise en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.

  • Activé - Toutes les sources de données de géodatabase d'entreprise sont converties en une géodatabase fichier. Il s’agit de l’option par défaut.
  • Désactivé - Toutes les sources de données de géodatabases d'entreprise sont conservées et référencées dans le paquetage obtenu.
Boolean
Étendue
(Facultatif)

Spécifie l'étendue utilisée pour sélectionner ou découper les entités.

  • Current Display Extent (Étendue actuellement affichée) Vue cartographique : l’étendue repose sur la carte ou la scène active. Cette option est uniquement disponible lorsqu’une carte est active.
  • Extent of a Layer (Étendue d’une couche) Layer : l’étendue repose sur une couche de carte active. Utilisez la liste déroulante pour choisir une couche disponible ou utilisez l’option Extent of data in all layers (Étendue des données dans toutes les couches) pour obtenir l’étendue combinée de toutes les couches de carte actives, y compris le fond de carte. Cette option est uniquement disponible lorsqu’une carte avec des couches est active.
  • Browse (Parcourir) Parcourir : l’étendue repose sur un jeu de données existant.
  • Intersection of Inputs (Intersection des entrées) Intersecter : l’étendue repose sur l’étendue minimale ou l’étendue d’intersection de toutes les entrées. S’il n’existe aucune intersection entre les entrées, il en résulte une étendue nulle avec uniquement des zéros.
  • Union of Inputs (Union des entrées) Agréger : l’étendue est basée sur l’étendue maximale ou combinée de toutes les entrées.
  • Reset Extent (Réinitialiser l’étendue) Réinitialiser : la valeur par défaut de l’étendue est rétablie.
  • Manually entered coordinates (Coordonnées saisies manuellement) : les coordonnées doivent être des valeurs numériques incluses dans le système de coordonnées de la carte active.

    La carte peut utiliser des unités d’affichage différentes

Extent
Appliquer l'étendue aux couches de géodatabases d'entreprise uniquement
(Facultatif)

Indique si l’étendue spécifiée est appliquée à toutes les couches ou aux couches de géodatabases d’entreprise.

  • Désactivé : l'étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • Activé : l'étendue spécifiée n'est appliquée qu'aux couches de géodatabases d'entreprise.
Boolean
Structure uniquement
(Facultatif)

Spécifie si seule la structure des couches en entrée est consolidée ou empaquetée.

  • Désactivé : toutes les entités et tous les enregistrements des couches en entrée sont inclus dans le dossier ou le paquetage consolidé. Il s’agit de l’option par défaut.
  • Activé : seule la structure des couches en entrée est consolidée ou empaquetée. Aucune entité ou aucun enregistrement n'est consolidé ou empaqueté dans le dossier en sortie.
Boolean
Keep only the rows which are related to features within the extent (Conserver uniquement les lignes associées aux entités dans l’étendue)
(Facultatif)

Détermine si l’étendue définie est appliquée aux sources de données associées.

  • Désactivée - Les sources de données associées sont consolidées dans leur globalité. Il s’agit de l’option par défaut.
  • Activée - Seules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées.
Boolean
Conserver la géodatabase mobile
(Facultatif)

Indique si les données de géodatabase mobile en entrée sont conservées dans la sortie ou si elles sont écrites au format de géodatabase fichier. Si les données en entrée sont un jeu de données réseau d’une géodatabase mobile, la sortie est une géodatabase mobile.

Ce paramètre remplace le paramètre Convertir les données en géodatabase fichier lorsque les données en entrée sont une géodatabase mobile.

  • Désactivé : les données de géodatabase mobile sont converties en géodatabase fichier. Il s’agit de l’option par défaut.
  • Activé : les données de géodatabase mobile sont conservées en tant que géodatabase mobile dans la sortie. La géodatabase est incluse dans son intégralité.
Boolean
Exclure le jeu de données réseau
(Facultatif)

Pour les couches d’analyse de réseau, spécifie si le jeu de données réseau est également consolidé.

  • Désactivé : le jeu de données réseau est inclus et consolidé. Il s’agit de l’option par défaut.
  • Activé : le jeu de données réseau n’est pas inclus. Seules les couches d’analyse de réseau sélectionnées sont consolidées.
Boolean

arcpy.management.ConsolidateLayer(in_layer, output_folder, {convert_data}, {convert_arcsde_data}, {extent}, {apply_extent_to_arcsde}, {schema_only}, {select_related_rows}, {preserve_sqlite}, {exclude_network_dataset})
NomExplicationType de données
in_layer
[in_layer,...]

Couches en entrée qui sont consolidées.

Layer
output_folder

Dossier en sortie qui contient les fichiers de couche et les données consolidées.

Si le dossier spécifié n’existe pas, un nouveau dossier est créé.

Folder
convert_data
(Facultatif)

Spécifie si les couches en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.

  • CONVERTLes données sont converties en une géodatabase fichier. Cette option ne s'applique pas aux sources de données de géodatabases d'entreprise. Pour convertir les données des géodatabases d’entreprise, définissez le paramètre convert_arcsde_data sur CONVERT_ARCSDE.
  • PRESERVELes formats de données sont conservés lorsque cela est possible. Il s’agit de l’option par défaut.
Boolean
convert_arcsde_data
(Facultatif)

Spécifie si les couches de géodatabases d'entreprise en entrée seront converties en une géodatabase fichier ou si leur format original sera conservé.

  • CONVERT_ARCSDELes données de géodatabases d'entreprise seront converties en une géodatabase fichier et incluses dans le dossier ou paquetage consolidé. Il s’agit de l’option par défaut.
  • PRESERVE_ARCSDELes données de géodatabases d'entreprise sont conservées et référencées dans le dossier ou paquetage consolidé obtenu.
Boolean
extent
(Facultatif)

Spécifie l'étendue utilisée pour sélectionner ou découper les entités.

  • MAXOF : l’étendue maximale de toutes les entrées est utilisée.
  • MINOF : l’étendue minimale commune à toutes les entrées est utilisée.
  • DISPLAY : l’étendue est égale à l’affichage visible.
  • Nom de la couche : l’étendue de la couche spécifiée est utilisée.
  • Objet Extent : l’étendue de l’objet spécifié est utilisée.
  • Chaîne délimitée par des espaces de coordonnées géographiques : l’étendue de la chaîne spécifiée est utilisée. Les coordonnées sont exprimées dans l’ordre x-min, y-min, x-max, y-max.
Extent
apply_extent_to_arcsde
(Facultatif)

Indique si l’étendue spécifiée est appliquée à toutes les couches ou aux couches de géodatabases d’entreprise.

  • ALLL’étendue spécifiée est appliquée à toutes les couches. Il s’agit de l’option par défaut.
  • ARCSDE_ONLYL’étendue spécifiée est appliquée uniquement aux couches de géodatabases d’entreprise.
Boolean
schema_only
(Facultatif)

Spécifie si seule la structure des couches en entrée est consolidée ou empaquetée.

  • ALLToutes les entités et tous les enregistrements sont consolidés ou empaquetés. Il s’agit de l’option par défaut.
  • SCHEMA_ONLYSeule la structure des couches en entrée est consolidée ou empaquetée.
Boolean
select_related_rows
(Facultatif)

Détermine si l’étendue définie est appliquée aux sources de données associées.

  • KEEP_ONLY_RELATED_ROWSSeules les données associées correspondant aux enregistrements situés dans l’étendue définie sont consolidées.
  • KEEP_ALL_RELATED_ROWSLes sources de données associées sont consolidées dans leur globalité. Il s’agit de l’option par défaut.
Boolean
preserve_sqlite
(Facultatif)

Indique si les données de géodatabase mobile sont conservées dans la sortie ou si elles sont écrites au format de géodatabase fichier. Si les données en entrée sont un jeu de données réseau d’une géodatabase mobile, la sortie est une géodatabase mobile.

Ce paramètre remplace le paramètre convert_data lorsque les données en entrée sont une géodatabase mobile.

  • CONVERT_SQLITELes données de géodatabase mobile sont converties en géodatabase fichier. Il s’agit de l’option par défaut.
  • PRESERVE_SQLITELes données de géodatabase mobile sont conservées dans la sortie. La géodatabase est incluse dans son intégralité.
Boolean
exclude_network_dataset
(Facultatif)

Pour les couches d’analyse de réseau, spécifie si le jeu de données réseau est également consolidé.

  • INCLUDE_NETWORK_DATASETLe jeu de données réseau est inclus et consolidé. Il s’agit de l’option par défaut.
  • EXCLUDE_NETWORK_DATASETLe jeu de données réseau n’est pas inclus. Seules les couches d’analyse de réseau sont consolidées.
Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction ConsolidateLayer (fenêtre Python)

Le script ci-dessous pour la fenêtre Python illustre l’utilisation de la fonction ConsolidateLayer en mode immédiat.

import arcpy
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers' 
arcpy.management.ConsolidateLayer('Parcels.lyr', 'Consolidated_folder', 'PRESERVE', 'CONVERT_ARCSDE')
Exemple 2 d’utilisation de la fonction ConsolidateLayer (script autonome)

Rechercher et créer des dossiers consolidés individuels pour tous les fichiers de couche qui se trouvent dans un dossier spécifié.

# Import system modules
import os 
import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers' 

# Loop through the workspace, find all the layer files (.lyr) and create a consolidated folder for each 
# layer file found using the same name as the original layer file.
for lyr in arcpy.ListFiles('*.lyr'):
    print('Consolidating {}'.format(lyr))
    arcpy.management.ConsolidateLayer(lyr, os.path.splitext(lyr)[0], 'PRESERVE', 'CONVERT_ARCSDE')

Environnements

Cas particuliers

Facteur de traitement parallèle

Si l’environnement n’est pas spécifié, l’outil utilise une moitié des cœurs disponibles.