Daten aus Geodatabase extrahieren (Data Management)—ArcGIS Pro

Zusammenfassung

Extrahiert einen Teil der Daten aus einer Geodatabase in eine andere Geodatabase oder eine .xml-Datei.

Informationen zum Extrahieren von Daten aus einer Geodatabase

Verwendung

Das Werkzeug bietet eine ähnliche Funktionalität wie das Kopieren von Daten aus einer Geodatabase in eine andere, unterstützt aber auch das Kopieren eines Teils der Daten durch Festlegen der Umgebungseinstellung Ausdehnung, durch Angeben eines Wertes für den Parameter Mit Geometrie-Features extrahieren oder durch Verwenden einer Auswahl. Sie können auch das Schema und die Daten oder nur das Schema extrahieren.
Mit diesem Werkzeug kann auch nur das Schema für einen angegebenen Raumbezug mit der Umgebungseinstellung Ausgabe-Koordinatensystem extrahiert werden. Nachdem das Schema im gewünschten Raumbezug abgerufen wurde, können Sie die Option Wiederverwenden des Parameters Schema wiederverwenden verwenden, um die Daten in das neue Schema zu extrahieren.
Hinweis:
Die Umgebungseinstellung "Ausgabe-Koordinatensystem" wird in den folgenden Szenarien ignoriert:
- Der Parameter Extrahieren ist auf Daten festgelegt.
- Für den Parameter Ausgabetyp ist die Option XML-Datei festgelegt.

Parameter

Beschriftung	Erläuterung	Datentyp
Zu extrahierende Datasets	Die Daten, die extrahiert werden sollen.	Table View; Dataset
Extrahieren (optional)	Gibt an, ob das Schema und die Zeilen der Daten extrahiert werden sollen oder nur das Schema extrahiert werden soll. Daten—Das Schema und die Zeilen werden extrahiert. Dies ist die Standardeinstellung. Nur Schema—Nur das Schema wird extrahiert.	String
Ausgabetyp (optional)	Gibt den Typ der Ausgabe an, in die die Daten extrahiert werden sollen. Geodatabase—Die Daten werden in eine vorhandene Geodatabase extrahiert. Dies ist die Standardeinstellung. XML-Datei—Die Daten werden in ein XML-Workspace-Dokument extrahiert. Neue File-Geodatabase—Die Daten werden in eine neue File-Geodatabase extrahiert. Geben Sie den Speicherort und den Namen der neuen File-Geodatabase in den Parametern Speicherort der Geodatabase und Name der Geodatabase an. Neue Mobile-Geodatabase—Die Daten werden in eine neue Mobile-Geodatabase extrahiert. Geben Sie den Speicherort und den Namen der neuen Mobile-Geodatabase in den Parametern Speicherort der Geodatabase und Name der Geodatabase an.	String
Geodatabase, in die Daten extrahiert werden sollen (optional)	Die Geodatabase, in der die extrahierten Daten enthalten sein sollen, wenn der Parameter Ausgabetyp auf Geodatabase festgelegt wurde.	Workspace
XML-Datei, in die Daten extrahiert werden sollen (optional)	Der Name und Speicherort der .xml-Datei, die erstellt werden soll, wenn der Parameter Ausgabetyp auf XML-Datei festgelegt wurde.	File
Speicherort der Geodatabase (optional)	Der Speicherort der File- oder Mobile-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter Ausgabetyp auf Neue File-Geodatabase oder Neue Mobile-Geodatabase festgelegt wurde.	Folder
Name der Geodatabase (optional)	Der Name der File- oder Mobile-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter Ausgabetyp auf Neue File-Geodatabase oder Neue Mobile-Geodatabase festgelegt wurde.	String
Feature-Classes und Tabellen erweitern (optional)	Gibt an, ob erweiterte Feature-Classes und Tabellen, wie z. B. in geometrischen Netzwerken, Topologien oder Beziehungsklassen, hinzugefügt werden. Standardeinstellungen verwenden—Die erweiterten Feature-Classes und Tabellen, die in Beziehung mit den Feature-Classes und Tabellen in den Eingabe-Datasets stehen, werden hinzugefügt. In der Standardeinstellung für Feature-Classes werden alle Features extrahiert, die den räumlichen Filter überschneiden. Ist kein räumlicher Filter angegeben, werden alle Features einbezogen. In der Standardeinstellung für Tabellen wird nur das Schema extrahiert. Dies ist die Standardeinstellung. Nur mit Schema hinzufügen—Es wird nur das Schema für die erweiterten Feature-Classes und Tabellen hinzugefügt. Alle Zeilen—Es werden alle Zeilen für erweiterte Feature-Classes und Tabellen hinzugefügt. Nicht hinzufügen—Es werden keine erweiterten Feature-Classes oder Tabellen hinzugefügt.	String
Schema wiederverwenden (optional)	Gibt an, ob eine Geodatabase, die das Schema der zu extrahierenden Daten enthält, wiederverwendet werden soll. Durch das Wiederverwenden des Schemas reduziert sich die für das Extrahieren der Daten benötigte Zeit. Nicht wiederverwenden—Das Schema wird nicht wiederverwendet. Dies ist die Standardeinstellung. Wiederverwenden—Das Schema wird wiederverwendet.	String
Zugehörige Daten extrahieren (optional)	Gibt an, ob Zeilen mit Bezug auf in den Daten vorhandene Zeilen extrahiert werden sollen. Beispiel: Ein Feature (f1) befindet sich innerhalb und ein verbundenes Feature (f2) aus einer anderen Class außerhalb des Geometriefilters. Feature f2 wird in die extrahierten Daten einbezogen, wenn Sie zugehörige Daten abrufen möchten. Zugehörige nicht abrufen—Zugehörige Daten werden nicht extrahiert. Zugehörige abrufen—Zugehörige Daten werden extrahiert. Dies ist die Standardeinstellung.	String
Mit Geometrie-Features extrahieren (optional)	Die Features, die zum Definieren des zu extrahierenden Bereichs verwendet werden sollen.	Feature Layer
Geometriefiltertyp (optional)	Gibt die räumliche Beziehung zwischen den Werten der Parameter Mit Geometrie-Features extrahieren und Eingabe-Datasets und die Art der Filterung dieser Beziehung an. Die räumliche Beziehung wird auf die Daten in einer Ausdehnung angewendet, die durch den Interessenbereich (Area Of Interest, AOI), der im Parameter Mit Geometrie-Features extrahieren angegeben ist, definiert wird. Überschneidet—Die Features im Wert des Parameters Eingabe-Datasets, die sich mit Features im Wert des Parameters Mit Geometrie-Features extrahieren überschneiden, werden extrahiert. Enthält—Die Features im Wert des Parameters Eingabe-Datasets, die im ausgewählten Feature im Wert des Parameters Mit Geometrie-Features extrahieren enthalten sind, werden extrahiert.	String
Alle Datensätze für Tabellen (optional)	Gibt an, ob für Tabellen ohne angewendete Filter (beispielsweise Auswahlen oder Definitionsabfragen) alle Datensätze extrahiert werden sollen oder nur das Schema extrahiert werden soll. Tabellen mit angewendeten Filtern werden berücksichtigt. Aktiviert: Alle Datensätze werden in die Geodatabase extrahiert. Mit dieser Option wird der Wert des Parameters Feature-Classes und Tabellen erweitern außer Kraft gesetzt. Deaktiviert: Für Tabellen wird nur das Schema in Geodatabase extrahiert. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Ausgabe-Geodatabase	Der Ausgabe-Workspace, wenn der Parameter Ausgabetyp auf Geodatabase, Neue File-Geodatabase oder Neue Mobile-Geodatabase festgelegt wurde.	Workspace

arcpy.management.ExtractDataFromGeodatabase(in_data, {extract_type}, {out_type}, {out_geodatabase}, {out_xml}, {out_folder_path}, {out_name}, {expand_feature_classes_and_tables}, {reuse_schema}, {get_related_data}, {extract_using_geometry_features}, {geometry_filter_type}, {all_records_for_tables})

Name	Erläuterung	Datentyp
in_data [in_data,...]	Die Daten, die extrahiert werden sollen.	Table View; Dataset
extract_type (optional)	Gibt an, ob das Schema und die Zeilen der Daten extrahiert werden sollen oder nur das Schema extrahiert werden soll. DATA—Das Schema und die Zeilen werden extrahiert. Dies ist die Standardeinstellung. SCHEMA_ONLY—Nur das Schema wird extrahiert.	String
out_type (optional)	Gibt den Typ der Ausgabe an, in die die Daten extrahiert werden sollen. GEODATABASE—Die Daten werden in eine vorhandene Geodatabase extrahiert. Dies ist die Standardeinstellung. XML_FILE—Die Daten werden in ein XML-Workspace-Dokument extrahiert. NEW_FILE_GEODATABASE—Die Daten werden in eine neue File-Geodatabase extrahiert. Geben Sie den Speicherort und den Namen der neuen File-Geodatabase in den Parametern out_folder_path und out_name an. NEW_MOBILE_GEODATABASE—Die Daten werden in eine neue Mobile-Geodatabase extrahiert. Geben Sie den Speicherort und den Namen der neuen Mobile-Geodatabase in den Parametern out_folder_path und out_name an.	String
out_geodatabase (optional)	Die Geodatabase, in der die extrahierten Daten enthalten sein sollen, wenn der Parameter out_type auf GEODATABASE festgelegt wurde.	Workspace
out_xml (optional)	Der Name und Speicherort der .xml-Datei, die erstellt werden soll, wenn der Parameter out_type auf XML_FILE festgelegt wurde.	File
out_folder_path (optional)	Der Speicherort der File- oder Mobile-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter out_type auf NEW_FILE_GEODATABASE oder NEW_MOBILE_GEODATABASE festgelegt wurde.	Folder
out_name (optional)	Der Name der File- oder Mobile-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter out_type auf NEW_FILE_GEODATABASE oder NEW_MOBILE_GEODATABASE festgelegt wurde.	String
expand_feature_classes_and_tables (optional)	Gibt an, ob erweiterte Feature-Classes und Tabellen, wie z. B. in geometrischen Netzwerken, Topologien oder Beziehungsklassen, hinzugefügt werden. USE_DEFAULTS—Die erweiterten Feature-Classes und Tabellen, die in Beziehung mit den Feature-Classes und Tabellen in den Eingabe-Datasets stehen, werden hinzugefügt. In der Standardeinstellung für Feature-Classes werden alle Features extrahiert, die den räumlichen Filter überschneiden. Ist kein räumlicher Filter angegeben, werden alle Features einbezogen. In der Standardeinstellung für Tabellen wird nur das Schema extrahiert. Dies ist die Standardeinstellung. ADD_WITH_SCHEMA_ONLY—Es wird nur das Schema für die erweiterten Feature-Classes und Tabellen hinzugefügt. ALL_ROWS—Es werden alle Zeilen für erweiterte Feature-Classes und Tabellen hinzugefügt. DO_NOT_ADD—Es werden keine erweiterten Feature-Classes oder Tabellen hinzugefügt.	String
reuse_schema (optional)	Gibt an, ob eine Geodatabase, die das Schema der zu extrahierenden Daten enthält, wiederverwendet werden soll. Durch das Wiederverwenden des Schemas reduziert sich die für das Extrahieren der Daten benötigte Zeit. DO_NOT_REUSE—Das Schema wird nicht wiederverwendet. Dies ist die Standardeinstellung. REUSE—Das Schema wird wiederverwendet.	String
get_related_data (optional)	Gibt an, ob Zeilen mit Bezug auf in den Daten vorhandene Zeilen extrahiert werden sollen. Beispiel: Ein Feature (f1) befindet sich innerhalb und ein verbundenes Feature (f2) aus einer anderen Class außerhalb des Geometriefilters. Feature f2 wird in die extrahierten Daten einbezogen, wenn Sie zugehörige Daten abrufen möchten. DO_NOT_GET_RELATED—Zugehörige Daten werden nicht extrahiert. GET_RELATED—Zugehörige Daten werden extrahiert. Dies ist die Standardeinstellung.	String
extract_using_geometry_features (optional)	Die Features, die zum Definieren des zu extrahierenden Bereichs verwendet werden sollen.	Feature Layer
geometry_filter_type (optional)	Gibt die räumliche Beziehung zwischen den Werten der Parameter extract_using_geometry_features und in_data und die Art der Filterung dieser Beziehung an. Die räumliche Beziehung wird auf die Daten in einer Ausdehnung angewendet, die durch den Interessenbereich (Area Of Interest, AOI), der im Parameter extract_using_geometry_features angegeben ist, definiert wird. INTERSECTS—Die Features im Wert des Parameters in_data, die sich mit Features im Wert des Parameters extract_using_geometry_features überschneiden, werden extrahiert. CONTAINS—Die Features im Wert des Parameters Eingabe-Datasetsin_data, die im ausgewählten Feature im Wert des Parameters extract_using_geometry_features enthalten sind, werden extrahiert.	String
all_records_for_tables (optional)	Gibt an, ob für Tabellen ohne angewendete Filter (beispielsweise Auswahlen oder Definitionsabfragen) alle Datensätze extrahiert werden sollen oder nur das Schema extrahiert werden soll. Tabellen mit angewendeten Filtern werden berücksichtigt. ALL_RECORDS_FOR_TABLES—Alle Datensätze werden in die Geodatabase extrahiert. Mit dieser Option wird der Wert des Parameters expand_feature_classes_and_tables außer Kraft gesetzt. SCHEMA_ONLY_FOR_TABLES—Nur das Schema wird in Geodatabase extrahiert. Dies ist die Standardeinstellung.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_workspace	Der Ausgabe-Workspace, wenn der Parameter out_type auf GEODATABASE, NEW_FILE_GEODATABASE oder NEW_MOBILE_GEODATABASE festgelegt wurde.	Workspace

Codebeispiel

ExtractDataFromGeodatabase: Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion ExtractDataFromGeodatabase mit einer einzelnen Eingabe-Feature-Class und einer neuen Ausgabe-File-Geodatabase verwendet wird.

import arcpy
arcpy.management.ExtractDataFromGeodatabase(
    r"C:\MyProject\MyGDB.gdb\Bridges", "DATA", "NEW_FILE_GEODATABASE", "", "",
   r"C:\MyProject", "MyNewGDB")

ExtractDataFromGeodatabase: Beispiel 2 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie die Funktion ExtractDataFromGeodatabase mit mehreren Layern zum Extrahieren in ein XML-Workspace-Dokument verwendet wird.

import arcpy
arcpy.management.ExtractDataFromGeodatabase(
    ["Layer1", "Layer2"], "SCHEMA_ONLY", "XML_FILE", "",
    r"C:\MyProject\MyXMLWkspDoc.xml")

ExtractDataFromGeodatabase: Beispiel 3 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion ExtractDataFromGeodatabase mit mehreren Eingabe-Datasets zum Extrahieren in eine vorhandene Geodatabase mit der Umgebungseinstellung "Ausdehnung" verwendet wird.

# Name: ExtractDataFromGeodatabase_Example3.py
# Description: Extract a subset of data by providing an extent using the Extent
#              environment setting.

# Import system modules
import arcpy

# Set the current workspace (to avoid having to specify the full path to each 
# input dataset)
arcpy.env.workspace = "C:\MyProject\MyData.gdb"

# Set the extent environment using the Extent class
arcpy.env.extent = arcpy.Extent(-107.0, 38.0, -104.0, 40.0)

# Set local variables
in_data = ["FC1", "FC2", "FC3"]
extract_type = "DATA"
out_type = "GEODATABASE"
out_geodatabase = "C:\MyProject\MyGDB.gdb"
out_folder_path = ""
out_name = ""
expand_fcs = "USE_DEFAULTS"
reuse_schema = "DO_NOT_REUSE"
get_related_data = "GET_RELATED"
extract_using_geom = ""
geom_filter = ""
all_records = "ALL_RECORDS_FOR_TABLES"

# Run ExtractDataFromGeodatabase
arcpy.management.ExtractDataFromGeodatabase(in_data,
                                            extract_type,
                                            out_type,
                                            out_geodatabase,
                                            out_xml,
                                            out_folder_path,
                                            out_name,
                                            expand_fcs,
                                            reuse_schema,
                                            get_related_data,
                                            extract_using_geom,
                                            geom_filter,
                                            all_records)

ExtractDataFromGeodatabase: Beispiel 4 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie die Funktion ExtractDataFromGeodatabase zum Extrahieren von Daten in eine neue File-Geodatabase mit einem neuen Koordinatensystem mit der Umgebungseinstellung "Ausgabe-Koordinatensystem" verwendet wird.

# Name: ExtractDataFromGeodatabase_Example4.py
# Description: Extract data to use a new coordinate system by using the
#              Output Coordinate System environment setting. Then run the tool a second
#              time to load the data using the reuse_schema option

# Import system modules
import arcpy

# Set the Output Coordinate System environment
arcpy.env.outputCoordinateSystem = arcpy.SpatialReference("GCS_North_American_1983_HARN")
arcpy.env.geographicTransformations = "NAD_1983_HARN_To_WGS_1984_2"

# Set local variables
in_data = "C:/MyProject/MyGDB.gdb/FC1"
extract_type = "SCHEMA_ONLY"
out_type = "NEW_FILE_GEODATABASE"
out_geodatabase = ""
out_xml = ""
out_folder_path = "C:\MyProject"
out_name = "MyOutputGDB.gdb"
expand_fcs = "USE_DEFAULTS"
reuse_schema = "DO_NOT_REUSE"
get_related_data = "GET_RELATED"
extract_using_geom = ""
geom_filter = ""
all_records = "SCHEMA_ONLY_FOR_TABLES"

# Run ExtractDataFromGeodatabase with the schema only option
arcpy.management.ExtractDataFromGeodatabase(in_data,
                                            extract_type,
                                            out_type,
                                            out_geodatabase,
                                            out_xml,
                                            out_folder_path,
                                            out_name,
                                            expand_fcs,
                                            reuse_schema,
                                            get_related_data,
                                            extract_using_geom,
                                            geom_filter,
                                            all_records)

# Rest the Output Coordinate System environment
arcpy.ClearEnvironment("outputCoordinateSystem")
arcpy.ClearEnvironment("geographicTransformations")

# Set variables that we are changing to load the data into the newly created schema in 
# the different coordinate system.
extract_type = "DATA"
out_type = "GEODATABASE"
out_geodatabase = "C:\MyProject\MyOutputGDB.gdb"
out_folder_path = ""
out_name = ""
reuse_schema = "REUSE"
all_records = "ALL_RECORDS_FOR_TABLES"

# Run ExtractDataFromGeodatabase with the data and reuse schema option
arcpy.management.ExtractDataFromGeodatabase(in_data,
                                            extract_type,
                                            out_type,
                                            out_geodatabase,
                                            out_xml,
                                            out_folder_path,
                                            out_name,
                                            expand_fcs,
                                            reuse_schema,
                                            get_related_data,
                                            extract_using_geom,
                                            geom_filter,
                                            all_records)

ExtractDataFromGeodatabase: Beispiel 5 (eigenständiges Skript)

Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie das Werkzeug ExtractDataFromGeodatabase verwendet wird, um ein Schema in eine XML-Datei zu extrahieren, und wie anschließend mit dem Werkzeug ImportXMLWorkspaceDocument Daten geladen werden.

# Name: ExtractDataFromGeodatabase_Example5.py
# Description: Extract schema of multiple feature classes and import the
#              schema into an enterprise geodatabase

# Import system modules
import arcpy

# Set the current workspace (to avoid having to specify the full path to each input dataset)
arcpy.env.workspace = "C:\MyProject\MyData.gdb"

# Export the schema as an XML file from a feature class
result = arcpy.management.ExtractDataFromGeodatabase(
    ["FC1", "FC2"], "SCHEMA_ONLY", "XML_FILE", "",
    "C:/MyProject/MyXMLWkspDoc.xml")

# Get the path to the output XML file
out_xml = result[0]

# Pass the output XML into the Import XML Workspace Document tool
arcpy.management.ImportXMLWorkspaceDocument("C:/MyProject/mySDEConnection.sde", 
                                            out_xml, 
                                            "SCHEMA_ONLY", "DEFAULTS")

ExtractDataFromGeodatabase: Beispiel 6 (eigenständiges Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie das Werkzeug ExtractDataFromGeodatabase zum Extrahieren von Daten in eine neue Mobile-Geodatabase und Erstellen einer Domäne für die neue Ausgabe-Geodatabase verwendet wird.

# Name: ExtractDataFromGeodatabase_Example6.py
# Description: Extract data and create a domain on output workspace

# Import system modules
import arcpy

# Export data to a new mobile geodatabase
result = arcpy.management.ExtractDataFromGeodatabase(
    "C:/MyProject/mySDEConnection.sde/myGDB.USER1.FC1", "DATA", "NEW_MOBILE_GEODATABASE", "", "",
    "C:/MyProject", "newMobileGDB")

# Get the path to the output mobile geodatabase
out_mobile_gdb = result[1]

# Pass the output geodatbase to the CreateDomain tool
arcpy.management.CreateDomain(out_mobile_gdb, "MyDomain", "My domain description", "SHORT", "CODED")

Umgebungen

Ausdehnung, Ausgabe-Koordinatensystem, Ausgabe-CONFIG-Schlüsselwort, Geographische Transformationen

Lizenzinformationen

Basic: Nein
Standard: Ja
Advanced: Ja

Zusammenfassung

Verwendung

Hinweis:

Parameter

Abgeleitete Ausgabe

Abgeleitete Ausgabe

Codebeispiel

Umgebungen

Lizenzinformationen

Verwandte Themen

In diesem Thema