Importar datos por lotes (Inteligencia)

Resumen

Importa archivos KML, archivos KMZ, shapefiles, hojas de cálculo de Excel, archivos de texto tabular, archivos GeoJSON y archivos GPX a clases de entidad almacenadas en una única geodatabase.

Uso

  • Si el valor de Datos de entrada es una carpeta, se buscará de forma recursiva para obtener archivos KML (.kml) y KMZ (.kmz), shapefiles (.shp), libros de trabajo de Excel (.xlsx y .xls), archivos de texto tabular (.csv, .txt y .tab), archivos GeoJSON (.geojson) y archivos GPX (.gpx). El parámetro Filtro se puede utilizar para limitar los archivos que se importan de las carpetas.

  • Los rásteres o las superposiciones terrestres que se encuentren en un archivo .kml o .kmz se convierten en un dataset de mosaico en el parámetro Geodatabase de destino. Los rásteres de origen a los que hace referencia el dataset de mosaico se almacenan en su formato nativo en una subcarpeta con el nombre del dataset de mosaico. Se ubica en la misma ubicación que la geodatabase de destino. Estos archivos llevan el nombre del valor de Geodatabase de destino y se incorporan con _Rasters. Por ejemplo, si el valor de Geodatabase de destino es C:\Data\OperationalData.gdb, se crea una carpeta llamada OperationalData_Rasters en C:\Data.

  • Si importa archivos a una geodatabase corporativa, asegúrese de que el archivo de conexión de base de datos (.sde) se especifique como ruta UNC en el parámetro Geodatabase de destino y que la geodatabase corporativa pueda acceder a la ruta.

  • Por lo general, se admiten entradas KML y KMZ hasta la versión 2.2 de KMZ del estándar KML del Consorcio Geoespacial abierto. Las ubicaciones de puntos que utilizan la pestaña de dirección (a modo de geocodificación) no se admiten. Se requiere una ubicación de latitud y longitud válida en el KML de origen.

  • El delimitador estándar para los archivos de texto tabular con extensiones .csv y .txt es una coma; para los archivos con extensión .tab, es una tabulación. Para usar una tabla de entrada con un delimitador no estándar, dicho delimitador se debe especificar con un archivo schema.ini. Consulte el archivo Schema.ini (controlador de archivo de texto) en la documentación de Microsoft para obtener más información.

  • En el caso de las hojas de cálculo de Excel de entrada y archivos de texto tabular, tan solo se admite la geometría de punto.

  • La especificación GeoJSON admite varios tipos de geometría. Se creará una clase de entidad distinta por cada tipo de geometría del archivo .geojson de entrada con el formato de nombre ArchivoGeoJSONdeOrigen_TipoDeGeometría. Por ejemplo, si el archivo .geojson se llama World Airports.geojson y contiene tipos de geometría de puntos, multipuntos, polilíneas y polígonos, las clases de entidad se llamarán World Airports_Puntos, World Airports_Multipuntos, World Airports_Polilíneas y World Airports_Polígonos.

  • Los sistemas de coordenadas tienen en cuenta lo siguiente al ejecutar esta herramienta:

    • En el caso de shapefiles y archivos .kml, .kmz, .geojson y .gpx, el sistema de coordenadas del dataset de salida será el mismo que el dataset de entrada. Las especificaciones KML y GPX exigen que el sistema de coordenadas del dataset de entrada sea GCS WGS1984.
    • En el caso de los libros de trabajo de Excel y archivos de texto tabular, el sistema de coordenadas de la salida será GCS WGS1984.

  • Si alguna de las coordenadas de entrada de una entidad no es válida (notación de coordenadas nula o no válida), la entidad correspondiente tendrá una geometría nula. La herramienta Verificar geometría se puede utilizar para identificar geometrías nulas en la salida.

  • Las coordenadas admitidas para los archivos de texto tabular (.csv, .txt y .tab) y las hojas de cálculo de Excel son latitud y longitud en grados decimales, Sistema de Referencia de Cuadrícula Militar (MGRS) y Cuadrícula Cartográfica Nacional de EE. UU. (USNG). En el origen se buscan columnas de coordenadas en el siguiente orden: latitud y longitud en columnas independientes, latitud y longitud en una sola columna, MGRS y, por último, USNG.

    Nota:

    Para los valores de latitud y longitud en una sola columna, el valor de latitud debe estar primero y, a continuación, la longitud separada por un espacio, una coma o una barra diagonal.

    Los siguientes son nombres de columna válidos:

    • Latitud: latitude, lat, y_coordinate, y_coord y y
    • Longitud: longitude, long, lon, x_coordinate, x_coord y x
    • Latitud/longitud: latitude_longitude, lat_long, lat_lon, xy_coordinate, xy_coordinates, xy_coord, xy_coords y xy
    • Coordenada MGRS: mgrs, mgrs_coordinate, mgrs_coordinates, mgrs_coord y mgrs_coords
    • Coordenada USNG: usng, usng_coordinate, usng_coordinates, usng_coord y usng_coords

  • Se importarán todas las hojas de cálculo de un libro de trabajo de Excel.

  • Se aplica simbología a las capas de salida agregadas al mapa en función de la simbología de los archivos de datos de origen de esta manera:

    Nota:
    Debe existir un mapa activo en el proyecto AllSource en el momento de la ejecución de la herramienta para mantener la simbología. Si la herramienta se ejecuta fuera de un proyecto AllSource (es decir, desde un script independiente de Python), la simbología no se conservará.
    • En el caso de capas de salida creadas desde archivos .kml o .kmz, la simbología se extrae desde el archivo .kml o .kmz de origen que se aplica a las capas de salida. Dicha simbología se puede invalidar si se proporciona un archivo de capa (.lyrx o .lyr) en la misma carpeta donde está el archivo .kml o .kmz de origen. El archivo de capa debe tener el mismo nombre base que el archivo de datos de origen, incorporado con un guion bajo (_), así como el tipo de geometría (puntos, polilíneas o polígonos) de la capa a invalidar. Por ejemplo, si el archivo .kml se llama World Airports.kml y contiene entidades poligonales, de punto o de línea, y desea invalidar la simbología de todos los tipos de geometría, los archivos de capa se llamarían World Airports_Points.lyrx, World Airports_Polylines.lyrx y World Airports_Polygons.lyrx. En los valores del tipo de geometría se distingue entre mayúsculas y minúsculas. Si no existe ningún archivo de capa para un tipo de geometría determinado, se aplica la simbología del archivo .kml o .kmz de origen a la capa de salida.
    • En el caso de capas de salida creadas a partir de orígenes que no son archivos .kml ni .kmz, se aplica una simbología a la capa de salida si existe un archivo de capa (.lyrx o .lyr) en la misma carpeta que el archivo de datos de origen. El archivo de capa debe tener el mismo nombre base que el archivo de datos de origen, salvo las hojas de cálculo de Excel y archivos .geojson. En el caso de las hojas de cálculo de Excel, el archivo de capa debe tener el mismo nombre que el nombre base del archivo de datos de origen, incorporado con un guion bajo (_) más el nombre de la hoja de cálculo. Por ejemplo, si el archivo de Excel se llama World.xlsx y contiene una hoja de cálculo llamada Cities (2018), el archivo de capa se debe llamar World_Cities (2018).lyrx o World_Cities (2018).lyr. En el caso de los archivos .geojson, el archivo de capa debe tener el mismo nombre que el nombre base del archivo de datos de origen, incorporado con un guion bajo (_) más el tipo de geometría de salida: puntos, multipunto, polilíneas y polígonos. Si no existe ningún archivo de capa, se aplica un símbolo predeterminado a la capa de salida.

Parámetros

EtiquetaExplicaciónTipo de datos
Datos de entrada

Las carpetas que contienen los archivos de datos o los archivos de datos que desea convertir a clases de entidad de geodatabase.

Folder; File
Geodatabase de destino

La geodatabase de destino donde se almacenarán las clases de entidad de salida.

Workspace
Filtro
(Opcional)

Aplica un filtro para limitar los archivos que se importan de carpetas. Los siguientes caracteres comodín del filtro trabajan en la ruta completa de los datos de entrada:

  • *: coincidencia con cualquier carácter
  • ?: coincidencia con un único carácter
  • [rango]: coincidencia con un único carácter del rango
  • [!rango]: coincidencia con cualquier carácter que no esté en el rango
Es posible agregar varios patrones al filtro separando cada patrón con el delimitador vertical de barra o tubo (|). Las comparaciones entre patrones no distinguen entre mayúsculas y minúsculas, por lo que al utilizar el patrón *airport.shp, *AIRPORT.SHP o *Airport.shp, por ejemplo, se importará el mismo shapefile.

Estos son algunos ejemplos de filtro:

  • Para importar todos los shapefiles, use *.shp.
  • Para importar todos los shapefiles y todos los archivos .kml, use *.shp|*.kml.
  • Para importar todos los archivos con un aeropuerto en la ruta o el nombre del archivo, use *airport*.
  • Para importar todos los archivos .geojson con un aeropuerto en la ruta o el nombre del archivo, use *airport*.geojson.
  • Para importar todos los archivos .kmzcon un aeropuerto incorporado con dos caracteres cualesquiera en el nombre, use *airport??.kmz.
  • Para importar todos los archivos con 1990 hasta 1997 en la ruta o el nombre del archivo, use *199[0-7]*.
  • Para importar todos los shapefiles justo con el nombre de carpeta airfacilities en la ruta del archivo, use *\airfacilities\*.shp.

String
Incluir subcarpetas
(Opcional)

Especifica si las subcarpetas se explorarán de forma recursiva.

  • Activado: se explorarán todas las subcarpetas. Esta es la opción predeterminada.
  • Desactivado: solo se explorará la carpeta de nivel superior.

Boolean
Incluir la superposición de terrenos
(Opcional)

Especifica si las superposiciones terrestres KML o KMZ (ráster, fotos aéreas, etc.) se incluirán en la salida.

Tenga precaución si el KMZ apunta a un servicio de imágenes ráster. La herramienta intentará traducir las imágenes ráster en todas las escalas disponibles. Este proceso podría ser largo y posiblemente desbordar el servicio.

  • Activado: las superposiciones terrestres se incluirán en la salida. Esta es la opción predeterminada.
  • Desactivado: las superposiciones terrestres no se incluirán en la salida.

Boolean

Salida derivada

EtiquetaExplicaciónTipo de datos
Geodatabase actualizada

La geodatabase de destino actualizada.

Workspace

arcpy.intelligence.BatchImportData(in_data, target_gdb, {filter}, {include_sub_folders}, {include_groundoverlay})
NombreExplicaciónTipo de datos
in_data
[in_data,...]

Las carpetas que contienen los archivos de datos o los archivos de datos que desea convertir a clases de entidad de geodatabase.

Folder; File
target_gdb

La geodatabase de destino donde se almacenarán las clases de entidad de salida.

Workspace
filter
(Opcional)

Aplica un filtro para limitar los archivos que se importan de carpetas. Los siguientes caracteres comodín del filtro trabajan en la ruta completa de los datos de entrada:

  • *: coincidencia con cualquier carácter
  • ?: coincidencia con un único carácter
  • [rango]: coincidencia con un único carácter del rango
  • [!rango]: coincidencia con cualquier carácter que no esté en el rango
Es posible agregar varios patrones al filtro separando cada patrón con el delimitador vertical de barra o tubo (|). Las comparaciones entre patrones no distinguen entre mayúsculas y minúsculas, por lo que al utilizar el patrón *airport.shp, *AIRPORT.SHP o *Airport.shp, por ejemplo, se importará el mismo shapefile.

Estos son algunos ejemplos de filtro:

  • Para importar todos los shapefiles, use *.shp.
  • Para importar todos los shapefiles y todos los archivos .kml, use *.shp|*.kml.
  • Para importar todos los archivos con un aeropuerto en la ruta o el nombre del archivo, use *airport*.
  • Para importar todos los archivos .geojson con un aeropuerto en la ruta o el nombre del archivo, use *airport*.geojson.
  • Para importar todos los archivos .kmzcon un aeropuerto incorporado con dos caracteres cualesquiera en el nombre, use *airport??.kmz.
  • Para importar todos los archivos con 1990 hasta 1997 en la ruta o el nombre del archivo, use *199[0-7]*.
  • Para importar todos los shapefiles justo con el nombre de carpeta airfacilities en la ruta del archivo, use *\airfacilities\*.shp.

String
include_sub_folders
(Opcional)

Especifica si las subcarpetas se explorarán de forma recursiva.

  • SUBFOLDERSSe explorarán todas las subcarpetas. Esta es la opción predeterminada.
  • NO_SUBFOLDERSSolo se explorará la carpeta de nivel superior.
Boolean
include_groundoverlay
(Opcional)

Especifica si las superposiciones terrestres KML o KMZ (ráster, fotos aéreas, etc.) se incluyen en la salida.

Tenga precaución si el KMZ apunta a un servicio de imágenes ráster. La herramienta intentará traducir las imágenes ráster en todas las escalas disponibles. Este proceso podría ser largo y posiblemente desbordar el servicio.

  • GROUNDOVERLAYLas superposiciones terrestres se incluirán en la salida. Esta es la opción predeterminada.
  • NO_GROUNDOVERLAYLas superposiciones terrestres no se incluirán en la salida.
Boolean

Salida derivada

NombreExplicaciónTipo de datos
out_geodatabase

La geodatabase de destino actualizada.

Workspace

Muestra de código

Ejemplo 1 de BatchImportData (ventana de Python)

La siguiente secuencia de comandos de la ventana de Python demuestra cómo utilizar la función BatchImportData de modo inmediato:

import arcpy 
arcpy.intelligence.BatchImportData("c:/data/sourcedata", "c:/data/output.gdb", "", "SUBFOLDERS", "NO_GROUNDOVERLAY")
Ejemplo 2 de BatchImportData (script independiente)

El siguiente script de Python muestra cómo utilizar la función BatchImportData en un script independiente:

# Name: BatchImportData_Example2.py
# Description: Imports all shapefiles with 'airport' in the file name or file
#              path within a directory to feature classes in a single geodatabase.
# Requirements: Standard or Advanced license

# Import system modules
import arcpy

# Set local variables
in_data = ["c:/data/sourcedata"]
target_gdb = r"\\data\operationaldata.sde" 
filter = "*airports*.shp" 
include_sub_folders = "NO_SUBFOLDERS" 

# Run BatchImportData
arcpy.intelligence.BatchImportData(in_data, target_gdb, filter, include_sub_folders)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.