Beschriftung | Erläuterung | Datentyp |
Eingabe-Layer | Die Eingabe-Layer, die konsolidiert werden sollen. | Layer |
Ausgabeordner | Der Ausgabeordner, der die Layer-Dateien und die konsolidierten Daten enthält. Wenn der angegebene Ordner nicht vorhanden ist, wird ein neuer Ordner erstellt. | Folder |
Daten in File-Geodatabase konvertieren (optional) | Gibt an, ob Eingabe-Layer in eine File-Geodatabase konvertiert oder im ursprünglichen Format beibehalten werden.
| Boolean |
Enterprise-Geodatabase-Daten einbeziehen statt Daten zu referenzieren (optional) | Gibt an, ob Eingabe-Geodatabase-Layer in eine File-Geodatabase konvertiert oder im ursprünglichen Format beibehalten werden.
| Boolean |
Ausdehnung (optional) | Gibt die Ausdehnung an, die zum Auswählen oder Ausschneiden von Features verwendet werden soll.
| Extent |
Ausdehnung nur auf Enterprise-Geodatabase-Layer anwenden (optional) | Gibt an, ob die angegebene Ausdehnung auf alle Layer oder nur auf Enterprise-Geodatabase-Layer angewendet wird.
| Boolean |
Nur Schema (optional) | Gibt an, ob nur das Schema der Eingabe-Layer konsolidiert oder gepackt wird.
| Boolean |
Nur die Zeilen beibehalten, die sich auf Features in der Ausdehnung beziehen (optional) | Gibt an, ob die angegebene Ausdehnung auf zugehörige Datenquellen angewendet wird.
| Boolean |
Mobile-Geodatabase beibehalten (optional) | Gibt an, ob die Eingabe-Mobile-Geodatabase in der Ausgabe erhalten bleibt oder in das Format der File-Geodatabase konvertiert wird. Wenn es sich bei den Eingabedaten um ein Netzwerk-Dataset einer Mobile-Geodatabase handelt, erfolgt die Ausgabe als Mobile-Geodatabase. Der Parameter Daten in File-Geodatabase konvertieren wird von diesem Parameter überschrieben, wenn die Eingabedaten eine Mobile-Geodatabase sind.
| Boolean |
Netzwerk-Dataset ausschließen (optional) | Gibt für Netzwerkanalyse-Layer an, ob das Netzwerk-Dataset auch konsolidiert werden soll.
| Boolean |
Zusammenfassung
Konsolidiert einen oder mehrere Layer durch Kopieren aller referenzierten Datenquellen in einen einzelnen Ordner.
Verwendung
Eine Warnung wird ausgegeben, wenn dieses Werkzeug einen nicht unterstützten Layer-Typ feststellt. Der nicht unterstützte Layer wird nicht in die Ausgabe geschrieben.
Wenn der Parameter Daten in File-Geodatabase konvertieren aktiviert ist, passiert Folgendes:
- Für jede eindeutige Datenquelle wird im konsolidierten Ordner oder Paket eine File-Geodatabase erstellt.
- Komprimierte Raster- und Vektorformate werden in eine File-Geodatabase konvertiert, und die Komprimierung geht verloren.
- Enterprise-Geodatabase-Daten werden nicht konsolidiert. Um Enterprise-Geodatabase-Daten in eine File-Geodatabase zu konvertieren, aktivieren Sie den Parameter Enterprise-Geodatabase-Daten einbeziehen statt Daten zu referenzieren.
Wenn der Parameter Daten in File-Geodatabase konvertieren nicht aktiviert ist, passiert Folgendes:
- Das Datenquellenformat der Eingabe-Layer bleibt wenn möglich erhalten.
- Raster im Format ADRG, CADRG/ECRG, CIB und RPF werden in File-Geodatabase-Raster konvertiert. ArcGIS kann diese Formate nicht intern schreiben. Sie werden aus Effizienzgründen in File-Geodatabase-Raster konvertiert.
- File-Geodatabases werden in der Ausgabeordnerstruktur in einen versionsspezifischen Ordner konsolidiert, alle anderen Formate werden in den Ordner "commonData" konsolidiert.
- Komprimierte Raster- und Vektorformate werden nicht ausgeschnitten. Dies gilt auch, wenn im Parameter Ausdehnung eine Ausdehnung angegeben ist.
Für Layer, die eine Verbindung enthalten oder an einer Beziehungsklasse beteiligt sind, werden alle verbundenen oder verwandten Datenquellen im Ausgabeordner konsolidiert. Standardmäßig werden verbundene oder zugehörige Datenquellen vollständig konsolidiert. In Abhängigkeit vom Parameterwert Zugehörige Zeilen auswählen kann sich die Konsolidierung aber auch nach der im Parameter Ausdehnung angegebenen Ausdehnung richten.
Für Feature-Layer wird der Parameter Ausdehnung verwendet, um die Features auszuwählen, die konsolidiert werden sollen. Für Raster-Layer wird der Parameter Ausdehnung verwendet, um die Raster-Datasets auszuschneiden.
Einige Datasets verweisen auf andere Datasets. Sie können z. B. ein Topologie-Dataset verwenden, das auf vier Feature-Classes verweist. Weitere Beispiele für Datasets, die auf andere Datasets verweisen, sind geometrische Netzwerke, Netzwerke und Locators. Beim Konsolidieren oder Packen eines Layers basierend auf diesen Typen von Datasets werden die beteiligten Datasets ebenfalls konsolidiert oder gepackt.
Wenn der Parameter Nur Schema aktiviert ist, wird nur das Schema der Eingabedatenquellen konsolidiert oder gepackt. Ein Schema ist die Struktur oder der Entwurf einer Feature-Class oder -Tabelle, die aus Feld- und Tabellendefinitionen, Eigenschaften des Koordinatensystems, Symbolisierung, Definitionsabfragen usw. besteht. Daten oder Datensätze werden nicht konsolidiert oder gepackt.
Datenquellen, die "Nur Schema" nicht unterstützen, werden nicht konsolidiert oder gepackt. Wenn der Parameter Nur Schema aktiviert ist und das Werkzeug auf einen dafür nicht unterstützten Layer stößt, wird eine Warnmeldung angezeigt. Der Layer wird übersprungen. Falls der einzige angegebene Layer "Nur Schema" nicht unterstützt, tritt beim Ausführen des Werkzeugs ein Fehler auf.
Parameter
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})
Name | Erläuterung | Datentyp |
in_layer [in_layer,...] | Die Eingabe-Layer, die konsolidiert werden sollen. | Layer |
output_folder | Der Ausgabeordner, der die Layer-Dateien und die konsolidierten Daten enthält. Wenn der angegebene Ordner nicht vorhanden ist, wird ein neuer Ordner erstellt. | Folder |
convert_data (optional) | Gibt an, ob Eingabe-Layer in eine File-Geodatabase konvertiert oder im ursprünglichen Format beibehalten werden.
| Boolean |
convert_arcsde_data (optional) | Gibt an, ob Eingabe-Geodatabase-Layer in eine File-Geodatabase konvertiert oder im ursprünglichen Format beibehalten werden.
| Boolean |
extent (optional) | Gibt die Ausdehnung an, die zum Auswählen oder Ausschneiden von Features verwendet werden soll.
| Extent |
apply_extent_to_arcsde (optional) | Gibt an, ob die angegebene Ausdehnung auf alle Layer oder nur auf Enterprise-Geodatabase-Layer angewendet wird.
| Boolean |
schema_only (optional) | Gibt an, ob nur das Schema der Eingabe-Layer konsolidiert oder gepackt wird.
| Boolean |
select_related_rows (optional) | Gibt an, ob die angegebene Ausdehnung auf zugehörige Datenquellen angewendet wird.
| Boolean |
preserve_sqlite (optional) | Gibt an, ob Daten der Mobile-Geodatabase in der Ausgabe als Mobile-Geodatabase beibehalten oder in das Format der File-Geodatabase konvertiert werden. Wenn es sich bei den Eingabedaten um ein Netzwerk-Dataset einer Mobile-Geodatabase handelt, erfolgt die Ausgabe als Mobile-Geodatabase. Der Parameter convert_data wird von diesem Parameter überschrieben, wenn die Eingabedaten eine Mobile-Geodatabase sind.
| Boolean |
exclude_network_dataset (optional) | Gibt für Netzwerkanalyse-Layer an, ob das Netzwerk-Dataset auch konsolidiert werden soll.
| Boolean |
Codebeispiel
Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion ConsolidateLayer im unmittelbaren Modus verwendet wird.
import arcpy
arcpy.env.workspace = 'C:/arcgis/ArcTutor/BuildingaGeodatabase/Layers'
arcpy.management.ConsolidateLayer('Parcels.lyr', 'Consolidated_folder', 'PRESERVE', 'CONVERT_ARCSDE')
Es werden einzelne konsolidierte Ordner für alle Layer-Dateien eines bestimmten Ordners gesucht und erstellt.
# 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')
Umgebungen
Sonderfälle
- Faktor für parallele Verarbeitung
Wenn die Umgebung nicht angegeben wurde, verwendet das Werkzeug die Hälfte der verfügbaren Kerne.