Daten aus Geodatabase extrahieren (Data Management)

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

  • Die Funktionalität dieses Werkzeugs ähnelt dem Kopieren von Daten aus einer in eine andere Geodatabase, 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.

  • Dieses Werkzeug kann auch verwendet werden, um nur das Schema für einen angegebenen Raumbezug mit der Umgebungseinstellung Ausgabe-Koordinatensystem zu extrahieren. 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. Wenn der Datenextraktionstyp verwendet wird, wird die Umgebungseinstellung "Ausgabe-Koordinatensystem" ignoriert.

Parameter

BeschriftungErläuterungDatentyp
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.

  • DatenDas Schema und die Zeilen werden extrahiert. Dies ist die Standardeinstellung.
  • Nur SchemaNur das Schema wird extrahiert.
String
Ausgabetyp
(optional)

Gibt den Typ der Ausgabe an, in die die Daten extrahiert werden sollen.

  • GeodatabaseDie Daten werden in eine vorhandene Geodatabase extrahiert. Dies ist die Standardeinstellung.
  • XML-DateiDie Daten werden in ein XML-Workspace-Dokument extrahiert.
  • Neue File-GeodatabaseDie 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.
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-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter Ausgabetyp auf Neue File-Geodatabase festgelegt wurde.

Folder
Name der Geodatabase
(optional)

Der Name der File-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter Ausgabetyp auf Neue File-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 verwendenDie 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ügenEs wird nur das Schema für die erweiterten Feature-Classes und Tabellen hinzugefügt.
  • Alle ZeilenEs werden alle Zeilen für erweiterte Feature-Classes und Tabellen hinzugefügt.
  • Nicht hinzufügenEs 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 wiederverwendenDas Schema wird nicht wiederverwendet. Dies ist die Standardeinstellung.
  • WiederverwendenDas 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 abrufenZugehörige Daten werden nicht extrahiert.
  • Zugehörige abrufenZugehö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.

  • ÜberschneidetDie Features im Wert des Parameters Eingabe-Datasets, die sich mit Features im Wert des Parameters Mit Geometrie-Features extrahieren überschneiden, werden extrahiert.
  • EnthältDie 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

BeschriftungErläuterungDatentyp
Ausgabe-Geodatabase

Der Ausgabe-Workspace.

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})
NameErläuterungDatentyp
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.

  • DATADas Schema und die Zeilen werden extrahiert. Dies ist die Standardeinstellung.
  • SCHEMA_ONLYNur das Schema wird extrahiert.
String
out_type
(optional)

Gibt den Typ der Ausgabe an, in die die Daten extrahiert werden sollen.

  • GEODATABASEDie Daten werden in eine vorhandene Geodatabase extrahiert. Dies ist die Standardeinstellung.
  • XML_FILEDie Daten werden in ein XML-Workspace-Dokument extrahiert.
  • NEW_FILE_GEODATABASEDie 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.
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-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter out_type auf NEW_FILE_GEODATABASE festgelegt ist.

Folder
out_name
(optional)

Der Name der File-Geodatabase, die für die extrahierten Daten erstellt werden soll. Dieser Parameter ist erforderlich, wenn der Parameter out_type auf NEW_FILE_GEODATABASE festgelegt ist.

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_DEFAULTSDie 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_ONLYEs wird nur das Schema für die erweiterten Feature-Classes und Tabellen hinzugefügt.
  • ALL_ROWSEs werden alle Zeilen für erweiterte Feature-Classes und Tabellen hinzugefügt.
  • DO_NOT_ADDEs 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_REUSEDas Schema wird nicht wiederverwendet. Dies ist die Standardeinstellung.
  • REUSEDas 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_RELATEDZugehörige Daten werden nicht extrahiert.
  • GET_RELATEDZugehö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.

  • INTERSECTSDie Features im Wert des Parameters in_data, die sich mit Features im Wert des Parameters extract_using_geometry_features überschneiden, werden extrahiert.
  • CONTAINSDie 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_TABLESAlle 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_TABLESNur das Schema wird in Geodatabase extrahiert. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_workspace

Der Ausgabe-Workspace.

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)

Lizenzinformationen

  • Basic: Nein
  • Standard: Ja
  • Advanced: Ja

Verwandte Themen