Extraer datos de geodatabase (Administración de datos)

Resumen

Extrae un subconjunto de datos de una geodatabase a otra geodatabase o un archivo .xml.

Más información sobre la extracción de datos de una geodatabase

Uso

• Esta herramienta proporciona una funcionalidad similar para copiar datos de una geodatabase a otra, pero admite la copia de un subconjunto de datos configurando el entorno Extensión, especificando el valor de parámetro Extraer usando entidades de geometría o mediante una selección. También puede extraer el esquema y los datos o solo el esquema.

• Esta herramienta también puede extraer el esquema solo para una referencia espacial específica utilizando el entorno Sistema de coordenadas de salida. Una vez que se obtiene el esquema en la referencia espacial deseada, puede usar la opción Reutilizar del parámetro Reutilizar esquema para extraer los datos al nuevo esquema.

  Nota:

  El entorno Sistema de coordenadas de salida se ignorará en los siguientes escenarios:

  • El parámetro Extraer se establece en Datos.
  • El parámetro Tipo de salida se establece en Archivo XML.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Datasets para extraer	Los datos que se extraerán.	Table View; Dataset
Extraer (Opcional)	Especifica si se extraerán el esquema y las filas de los datos o solo el esquema. Datos—Se extraerán el esquema y las filas. Esta es la opción predeterminada. Solo esquema—Solo se extraerá el esquema.	String
Tipo de Salida (Opcional)	Especifica el tipo de salida en el que se extraerán los datos. Geodatabase—Los datos se extraerán en una geodatabase existente. Esta es la opción predeterminada. Archivo XML—Los datos se extraerán en un documento de espacio de trabajo XML. Nueva geodatabase de archivos—Los datos se extraerán en una nueva geodatabase de archivos. Especifique la ubicación y el nombre de la nueva geodatabase de archivos utilizando los parámetros Ubicación de la geodatabase y Nombre de la geodatabase. Nueva geodatabase móvil—Los datos se extraen a una nueva geodatabase móvil. Especifique la ubicación y el nombre de la nueva geodatabase móvil utilizando los parámetros Ubicación de la geodatabase y Nombre de la geodatabase.	String
Geodatabase donde se extraerán los datos (Opcional)	La geodatabase que contendrá los datos extraídos cuando el parámetro Tipo de salida se establezca en Geodatabase.	Workspace
Archivo XML donde se extraerán los datos (Opcional)	El nombre y la ubicación del archivo .xml que se creará cuando el parámetro Tipo de salida se establezca en Archivo XML.	File
Ubicación de la geodatabase (Opcional)	La ubicación de la geodatabase de archivos o móvil que se creará para los datos extraídos. Este parámetro es necesario si el parámetro Tipo de salida está configurado como Nueva geodatabase de archivos o Nueva geodatabase móvil.	Folder
Nombre de la geodatabase (Opcional)	El nombre de la geodatabase de archivos o móvil que se creará para los datos extraídos. Este parámetro es necesario si el parámetro Tipo de salida está definido como Nueva geodatabase de archivos o Nueva geodatabase móvil.	String
Expandir clases de entidad y tablas (Opcional)	Especifica si se agregarán las tablas y clases de entidad expandidas (por ejemplo, aquellas de redes, topologías o clases de relación). Usar valores predeterminados—Se agregarán las tablas y clases de entidad expandidas relacionadas con tablas y clases de entidad de los datasets de entrada. La opción predeterminada para clases de entidad es extraer todas las entidades que intersecan el filtro espacial. Si no se ha proporcionado ningún filtro espacial, se incluirán todas las entidades. La opción predeterminada para las tablas es extraer solo el esquema. Esta es la opción predeterminada. Agregar solo con esquema—Se agregará solamente el esquema de las tablas y clases de entidad expandidas. Todas las filas—Se agregarán todas las filas de las tablas y clases de entidad expandidas. No agregar—No se agregarán ni las tablas ni las clases de entidad expandidas.	String
Reutilizar esquema (Opcional)	Especifica si se reutilizará una geodatabase que contenga el esquema de los datos que se van a extraer. La reutilización del esquema reduce la cantidad de tiempo necesaria para extraer los datos. No reutilizar—El esquema no se reutilizará. Esta es la opción predeterminada. Reutilización—El esquema se reutilizará.	String
Extraer datos relacionados (Opcional)	Especifica si se extraerán las filas relacionadas con filas ya presentes en los datos. Por ejemplo, una entidad (f1) está dentro del filtro de geometría y una entidad relacionada (f2) de otra clase está fuera del filtro. La entidad f2 se incluirá en los datos extraídos si elige obtener datos relacionados. No obtener relacionados—No se extraerán datos relacionados. Obtener relacionados—Se extraerán datos relacionados. Esta es la opción predeterminada.	String
Extraer usando entidades de geometría (Opcional)	Las entidades que se utilizarán para definir el área a extraer.	Feature Layer
Tipo de filtro de geometría (Opcional)	Especifica la relación espacial entre los valores de los parámetros Extraer usando entidades de geometría y Datasets de entrada y cómo se filtrará esa relación. La relación espacial se aplica a los datos en una extensión definida por el área de interés (AOI) especificada en el parámetro Extraer usando entidades de geometría. Interseca—Se extraerán las entidades del valor del parámetro Datasets de entrada que intersecan entidades en el valor del parámetro Extraer usando entidades geométricas. Contiene—Se extraerán las entidades del valor del parámetro Datasets de entrada que están contenidas en la entidad seleccionada en el valor del parámetro Extraer usando entidades geométricas.	String
Todos los registros de tablas (Opcional)	Especifica si se extraerán todos los registros o solo el esquema para las tablas que no tienen filtros aplicados (como selecciones o consultas de definición). Se respetarán las tablas con filtros aplicados. Activado: todos los registros se extraerán en la geodatabase. Esta opción anulará el valor del parámetro Expandir tablas y clases de entidad. Desactivado: solo se extraerá el esquema en la geodatabase para las tablas. Esta es la opción predeterminada.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
Geodatabase de salida	El espacio de trabajo de salida cuando el parámetro Tipo de salida se establece en Geodatabase, Nueva geodatabase de archivos o Nueva geodatabase móvil.	Workspace

Python

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})

Nombre	Explicación	Tipo de datos
in_data [in_data,...]	Los datos que se extraerán.	Table View; Dataset
extract_type (Opcional)	Especifica si se extraerán el esquema y las filas de los datos o solo el esquema. DATA—Se extraerán el esquema y las filas. Esta es la opción predeterminada. SCHEMA_ONLY—Solo se extraerá el esquema.	String
out_type (Opcional)	Especifica el tipo de salida en el que se extraerán los datos. GEODATABASE—Los datos se extraerán en una geodatabase existente. Esta es la opción predeterminada. XML_FILE—Los datos se extraerán en un documento de espacio de trabajo XML. NEW_FILE_GEODATABASE—Los datos se extraerán en una nueva geodatabase de archivos. Especifique la ubicación y el nombre de la nueva geodatabase de archivos utilizando los parámetros out_folder_path y out_name. NEW_MOBILE_GEODATABASE—Los datos se extraen a una nueva geodatabase móvil. Especifique la ubicación y el nombre de la nueva geodatabase móvil utilizando los parámetros out_folder_path y out_name.	String
out_geodatabase (Opcional)	La geodatabase que contendrá los datos extraídos cuando el parámetro out_type se establezca en GEODATABASE.	Workspace
out_xml (Opcional)	El nombre y la ubicación del archivo .xml que se creará cuando el parámetro out_type se establezca en XML_FILE.	File
out_folder_path (Opcional)	La ubicación de la geodatabase de archivos o móvil que se creará para los datos extraídos. Este parámetro es obligatorio si el parámetro out_type se define como NEW_FILE_GEODATABASE o NEW_MOBILE_GEODATABASE.	Folder
out_name (Opcional)	El nombre de la geodatabase de archivos o móvil que se creará para los datos extraídos. Este parámetro es obligatorio si el parámetro out_type se define como NEW_FILE_GEODATABASE o NEW_MOBILE_GEODATABASE.	String
expand_feature_classes_and_tables (Opcional)	Especifica si se agregarán las tablas y clases de entidad expandidas (por ejemplo, aquellas de redes, topologías o clases de relación). USE_DEFAULTS—Se agregarán las tablas y clases de entidad expandidas relacionadas con tablas y clases de entidad de los datasets de entrada. La opción predeterminada para clases de entidad es extraer todas las entidades que intersecan el filtro espacial. Si no se ha proporcionado ningún filtro espacial, se incluirán todas las entidades. La opción predeterminada para las tablas es extraer solo el esquema. Esta es la opción predeterminada. ADD_WITH_SCHEMA_ONLY—Se agregará solamente el esquema de las tablas y clases de entidad expandidas. ALL_ROWS—Se agregarán todas las filas de las tablas y clases de entidad expandidas. DO_NOT_ADD—No se agregarán ni las tablas ni las clases de entidad expandidas.	String
reuse_schema (Opcional)	Especifica si se reutilizará una geodatabase que contenga el esquema de los datos que se van a extraer. La reutilización del esquema reduce la cantidad de tiempo necesaria para extraer los datos. DO_NOT_REUSE—El esquema no se reutilizará. Esta es la opción predeterminada. REUSE—El esquema se reutilizará.	String
get_related_data (Opcional)	Especifica si se extraerán las filas relacionadas con filas ya presentes en los datos. Por ejemplo, una entidad (f1) está dentro del filtro de geometría y una entidad relacionada (f2) de otra clase está fuera del filtro. La entidad f2 se incluirá en los datos extraídos si elige obtener datos relacionados. DO_NOT_GET_RELATED—No se extraerán datos relacionados. GET_RELATED—Se extraerán datos relacionados. Esta es la opción predeterminada.	String
extract_using_geometry_features (Opcional)	Las entidades que se utilizarán para definir el área a extraer.	Feature Layer
geometry_filter_type (Opcional)	Especifica la relación espacial entre los valores de los parámetros extract_using_geometry_features y in_data y cómo se filtrará esa relación. La relación espacial se aplica a los datos en una extensión definida por el área de interés (AOI) especificada en el parámetro extract_using_geometry_features. INTERSECTS—Se extraerán las entidades del valor del parámetro in_data que intersecan entidades en el valor del parámetro extract_using_geometry_features. CONTAINS—Se extraerán las entidades del valor del parámetro in_data que están contenidas en la entidad seleccionada en el valor del parámetro extract_using_geometry_features.	String
all_records_for_tables (Opcional)	Especifica si se extraerán todos los registros o solo el esquema para las tablas que no tienen filtros aplicados (como selecciones o consultas de definición). Se respetarán las tablas con filtros aplicados. ALL_RECORDS_FOR_TABLES—Todos los registros se extraerán en la geodatabase. Esta opción anulará el valor del parámetro expand_feature_classes_and_tables. SCHEMA_ONLY_FOR_TABLES—Solo se extraerá el esquema en la geodatabase. Esta es la opción predeterminada.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
out_workspace	El espacio de trabajo de salida cuando el parámetro out_type se establece en GEODATABASE, NEW_FILE_GEODATABASE o NEW_MOBILE_GEODATABASE.	Workspace

Muestra de código

Ejemplo 1 de ExtractDataFromGeodatabase (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función ExtractDataFromGeodatabase con una única clase de entidad de entrada y una nueva geodatabase de archivos de salida.

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

Ejemplo 2 de ExtractDataFromGeodatabase (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función ExtractDataFromGeodatabase con varias capas y extraer solo el esquema en un documento de espacio de trabajo XML.

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

Ejemplo 3 de ExtractDataFromGeodatabase (script independiente)

La siguiente secuencia de comandos independiente de Python muestra cómo utilizar la función ExtractDataFromGeodatabase con varios datasets de entrada en una geodatabase existente utilizando el entorno Extensión.

# 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)

Ejemplo 4 de ExtractDataFromGeodatabase (script independiente)

La siguiente secuencia de comandos independiente de Python muestra cómo utilizar la función ExtractDataFromGeodatabase para extraer datos a una nueva geodatabase de archivos con un nuevo sistema de coordenadas utilizando el entorno Sistema de coordenadas de salida.

# 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)

Ejemplo 5 de ExtractDataFromGeodatabase (script independiente)

El siguiente script independiente de Python muestra cómo utilizar la herramienta ExtractDataFromGeodatabase y extraer esquemas a un archivo XML y cargar los datos mediante la herramienta ImportXMLWorkspaceDocument.

# 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")

Ejemplo 6 de ExtractDataFromGeodatabase (script independiente)

El siguiente script independiente de Python muestra cómo utilizar la herramienta ExtractDataFromGeodatabase para extraer datos a una nueva geodatabase móvil y crear un dominio para la nueva geodatabase de salida.

# 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")

Entornos

Extensión, Sistema de coordenadas de salida, Palabra clave CONFIG de salida, Transformaciones geográficas

Información de licenciamiento

• Basic: No
• Standard: Sí
• Advanced: Sí