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 copiar un subconjunto de datos configurando el entorno Extensión, especificando un 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 se puede utilizar para 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. El entorno Sistema de coordenadas de salida se ignora cuando se utiliza el tipo de extracción de datos.

Parámetros

EtiquetaExplicaciónTipo 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.

  • DatosSe extraerán el esquema y las filas. Esta es la opción predeterminada.
  • Solo esquemaSolo se extraerá el esquema.
String
Tipo de Salida
(Opcional)

Especifica el tipo de salida en el que se extraerán los datos.

  • GeodatabaseLos datos se extraerán en una geodatabase existente. Esta es la opción predeterminada.
  • Archivo XMLLos datos se extraerán en un documento de espacio de trabajo XML.
  • Nueva geodatabase de archivosLos 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.
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 que se creará para los datos extraídos. Este parámetro es necesario cuando el parámetro Tipo de salida está establecido en Nueva geodatabase de archivos.

Folder
Nombre de la geodatabase
(Opcional)

El nombre de la geodatabase de archivos que se creará para los datos extraídos. Este parámetro es necesario cuando el parámetro Tipo de salida está establecido en Nueva geodatabase de archivos.

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 predeterminadosSe 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 esquemaSe agregará solamente el esquema de las tablas y clases de entidad expandidas.
  • Todas las filasSe agregarán todas las filas de las tablas y clases de entidad expandidas.
  • No agregarNo 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 reutilizarEl esquema no se reutilizará. Esta es la opción predeterminada.
  • ReutilizaciónEl 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 relacionadosNo se extraerán datos relacionados.
  • Obtener relacionadosSe 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.

  • IntersecaSe 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.
  • ContieneSe 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

EtiquetaExplicaciónTipo de datos
Geodatabase de salida

Espacio de trabajo de salida.

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})
NombreExplicaciónTipo 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.

  • DATASe extraerán el esquema y las filas. Esta es la opción predeterminada.
  • SCHEMA_ONLYSolo se extraerá el esquema.
String
out_type
(Opcional)

Especifica el tipo de salida en el que se extraerán los datos.

  • GEODATABASELos datos se extraerán en una geodatabase existente. Esta es la opción predeterminada.
  • XML_FILELos datos se extraerán en un documento de espacio de trabajo XML.
  • NEW_FILE_GEODATABASELos 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.
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 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.

Folder
out_name
(Opcional)

El nombre de la geodatabase de archivos 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.

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_DEFAULTSSe 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_ONLYSe agregará solamente el esquema de las tablas y clases de entidad expandidas.
  • ALL_ROWSSe agregarán todas las filas de las tablas y clases de entidad expandidas.
  • DO_NOT_ADDNo 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_REUSEEl esquema no se reutilizará. Esta es la opción predeterminada.
  • REUSEEl 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_RELATEDNo se extraerán datos relacionados.
  • GET_RELATEDSe 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.

  • INTERSECTSSe extraerán las entidades del valor del parámetro in_data que intersecan entidades en el valor del parámetro extract_using_geometry_features.
  • CONTAINSSe 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_TABLESTodos 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_TABLESSolo se extraerá el esquema en la geodatabase. Esta es la opción predeterminada.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_workspace

Espacio de trabajo de salida.

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)

Información de licenciamiento

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

Temas relacionados