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.
|
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 die erneute Verwendung des Schemas reduziert sich die für das Extrahieren der Daten benötigte Zeit.
|
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.
|
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. Dies ist die Standardeinstellung.
CONTAINS—Die Features im Wert des Parameters in_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_xml = ""
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")