La herramienta Crear espacio de trabajo de carga de datos crea un espacio de trabajo de carga de datos, un libro de trabajo de referencia de datos y libros de trabajo de asignación.
Espacio de trabajo de carga de datos
El espacio de trabajo de carga de datos contiene carpetas, libros de trabajo de Microsoft Excel y otros elementos para ayudar a asignar datos desde un esquema de origen a un esquema de destino. A continuación, se describe la estructura de las carpetas de un espacio de trabajo de carga de datos:
- La carpeta Asignación de datos contiene las siguientes carpetas, según los datos de origen:
- Puntos: contiene libros de trabajo para cada uno de los datasets de puntos de origen asignados.
- Polígonos: contiene libros de trabajo para cada uno de los datasets de polígono de origen asignados.
- Polilíneas: contiene libros de trabajo para cada uno de los datasets de polilínea de origen asignados.
- Tabla: contiene libros de trabajo para cada uno de los datasets de tabla de origen asignados.
- GlobalLookup: contiene el libro de trabajo GlobalLookup.xlsx, que se puede utilizar para crear tablas de búsqueda que se utilizarán en todos los libros de trabajo de asignación.
- La carpeta Scripts contiene los archivos de script descritos a continuación, que puede utilizar para procesar datos mediante funciones personalizadas. Estas funciones se pueden utilizar en la columna Expression de los libros de trabajo de asignación.
- base.py: utilice las funciones básicas de este archivo en los libros de trabajo de asignación.
- shape_operations.py: utilice las funciones de manipulación de formas de este archivo en los libros de trabajo de asignación.
- user.py: utilice este archivo para funciones personalizadas.
- La carpeta Dominios contiene libros de trabajo con información de esquema para todos los dominios en el espacio de trabajo de origen y de destino.
- El archivo DataReference.xlsx contiene rutas a los libros de trabajo de origen, destino y asignación, así como la configuración de carga de datos.
Libro de trabajo de referencia de datos
El libro de trabajo de referencia de datos contiene rutas a los libros de origen, destino y asignación. Si la ubicación de cualquiera de estos elementos cambia, puede actualizar las rutas manualmente. Las columnas adicionales controlan cómo se pueden cargar los datos desde el origen al destino, incluidas ciertas configuraciones del entorno de geoprocesamiento.
Estas son las definiciones de las columnas:
- Source— La ubicación del dataset de origen.
- SourceDefinitionQuery— Escriba una consulta SQL para seleccionar un subconjunto de un dataset de origen para asignarlo al dataset de destino. Por ejemplo, utilice Type = 0 para seleccionar solo los registros en los que el tipo de atributo sea igual a 0 para cargarlos en el dataset de destino.
- Target— La ubicación del dataset de destino.
- TargetDeleteQuery— Escriba una consulta SQL para eliminar datos del dataset de destino de forma selectiva antes de cargarlos. Por ejemplo, 1=1 elimina todos los datos existentes del dataset de destino.
- MappingWorkbook— El vínculo a la ubicación del libro de trabajo de asignación de datos en el espacio de trabajo de carga de datos.
- Enabled— Un valor booleano que especifica si el libro de trabajo de asignación se procesará u omitirá durante el proceso de carga de datos. El valor predeterminado es Verdadero.
- MaintainAttachments— Un valor booleano que especifica si los adjuntos se mantendrán durante el proceso de carga de datos. El valor predeterminado es Verdadero.
- PreserveGlobalIds— Un valor booleano que especifica si los Id. globales se conservarán durante el proceso de carga de datos. El valor predeterminado es Falso. Los Id. globales no se pueden conservar al cargar en un servicio.
- GeographicTransformations— Defina las transformaciones geográficas válidas que se utilizarán cuando se carguen los datos.
Libros de trabajo de asignación de datos
Los libros de trabajo de asignación de datos están en la carpeta Asignación de datos y están organizados por tipo de geometría. Cada libro de trabajo de asignación de datos corresponde a uno de los pares de origen y destino definidos en el libro de trabajo de referencia de datos. Utilice estos libros de trabajo para definir cómo se asignarán los datos desde el origen al destino mediante las opciones que se describen a continuación.
Hoja de cálculo de asignación
Utilice esta hoja de cálculo para definir la asignación de campos. La hoja de cálculo está resaltada en verde en el libro de trabajo.
Estas son las definiciones de las columnas:
- TargetField— Los campos del dataset de destino.
- FieldType— El tipo de campo de cada campo en el dataset de destino.
- Expression— Asigne campos directamente seleccionando un campo en el menú desplegable, o escriba una expresión Python. Por ejemplo, esto puede hacer referencia a una función Python externa o a un valor constante como un número o una cadena de caracteres.
- LookupSheet— Especifique una hoja de cálculo de búsqueda. Esta debe usarse con las columnas LookupKeys y LookupValue.
- LookupKeys— Especifique una o más columnas de la hoja de cálculo de búsqueda para usarlas como claves. Para utilizar varias columnas, sepárelas con una coma.
- LookupValue— Especifique una columna de la hoja de cálculo de búsqueda para usarla como valor objetivo.
- LookupDefault— Cuando se utiliza una hoja de cálculo de búsqueda, este campo se puede utilizar para definir un valor predeterminado. Se asigna este valor a los valores nulos y a los valores que no concuerdan en la hoja de trabajo de búsqueda. Esta columna es opcional y se puede dejar en blanco si no se utiliza ningún valor predeterminado.
Validación de la hoja de cálculo de asignación
El formato condicional en un libro de trabajo utiliza otros colores para representar tipos específicos de errores y advertencias. Los significados de los otros colores son los siguientes:
- Rojo sólido: las celdas resaltadas en rojo sólido significan que hay un tipo de dato no válido entre los campos de origen y destino. Es muy poco probable que los tipos de datos de origen y destino sean compatibles cuando se procesen y lo más probable es que haya que cambiarlos.
- Naranja sólido: las celdas resaltadas en naranja sólido significan que existe un posible tipo de datos de campo de origen no válido para el campo de destino. Los tipos de datos de origen y destino son posiblemente incompatibles y deben ser evaluados.
- Azul claro sólido: las celdas resaltadas en azul claro sólido indican que tanto la columna de Expression como cualquiera de las columnas de consulta se han rellenado con valores. Tanto la columna de expresión como las columnas de búsqueda pueden tener valores, pero no ambas a la vez.
- Contorno rojo: las celdas contorneadas en rojo indican que faltan valores en las columnas de búsqueda. Las columnas LookupSheet, LookupKeys y LookupValue deben completarse con valores cuando se utiliza una hoja de consulta.
- Azul oscuro sólido: las celdas resaltadas en azul oscuro sólido indican que un nombre de campo de la columna de TargetField es un duplicado. Todos los valores de esta columna deben ser únicos y corresponderse con el esquema del destino.
Hoja de cálculo Búsqueda
Utilice hojas de cálculo de búsqueda para definir la asignación de valores de origen a destino. Se utilizan en la hoja de cálculo de asignaciones como claves de búsqueda y valores de búsqueda. Se crea automáticamente una hoja para todos los dominios de valor codificado en los datos de origen, con columnas que contienen códigos de dominio y descripciones. Se pueden agregar manualmente columnas adicionales que representen campos en los datos de origen para admitir una búsqueda de múltiples valores. Estas hojas de cálculo están resaltadas en azul en el libro de trabajo.
Si el parámetro Opciones de coincidencia de campos predictiva de la herramienta Crear espacio de trabajo de carga de datos está configurado como Similitud de descripción de valor codificado de dominio, se generará automáticamente una hoja de cálculo de búsqueda entre los dominios de origen y de destino. Primero se agregarán las columnas de datos de origen, seguidas de las columnas de datos de destino coincidentes.
Libro de trabajo de búsqueda global
El libro de trabajo de búsqueda global funciona del mismo modo que una hoja de trabajo de búsqueda local, pero permite utilizar una única hoja de trabajo de búsqueda en muchos libros de trabajo de asignación. El libro de trabajo de búsqueda global se encuentra en el directorio de DataMapping\GlobalLookup del espacio de trabajo de carga de datos. Cuando haga referencia a una hoja de cálculo de búsqueda global, encierre entre paréntesis el nombre de la hoja de búsqueda en la columna de LookupSheet del libro de trabajo de asignación. Por ejemplo, si la hoja de cálculo de búsqueda global se llama Materiales, haría referencia a él como [Materiales] en la columna LookupSheet de la hoja de cálculo de asignación. De esta forma, comunica a las herramientas de carga de datos que deben recuperar los valores de la hoja de cálculo de búsqueda global en lugar de la hoja de cálculo de búsqueda local.
Hoja de cálculo Esquema
Utilice estas hojas de cálculo para ver información de esquema sobre los datasets de origen y de destino. Se utilizan para crear un espacio de trabajo de asignación y no se utilizan en el procesamiento. Estas hojas de cálculo están resaltadas en amarillo en el libro de trabajo.
Hoja de cálculo Información
Utilice esta hoja de cálculo para definir el valor del subtipo de origen, si lo desea. Esta hoja de cálculo está resaltada en naranja en el libro de trabajo.
Opciones de asignación de datos
Existen varias opciones para asignar datos en los libros de trabajo de asignación de datos. Se pueden utilizar las columnas Lookup o Expression, pero solo se puede utilizar un método por campo de destino. Revise todas las opciones para determinar cuál funcionará mejor para el proceso de carga de datos. Las opciones que se describen a continuación se configuran en la hoja de trabajo de asignación.
Expresión
La columna Expression se puede utilizar para asignar campos directamente con tipos de datos compatibles. Algunos campos de origen y de destino coinciden automáticamente si tienen los mismos nombres de campo. Revise los campos que coincidan automáticamente para verificar que los tipos de datos de origen y de destino coincidan y, si hay dominios codificados, que los valores sean equivalentes.
La columna Expression también se puede personalizar para usar una expresión Python escrita directamente en Excel o para llamar a una función en la carpeta Secuencias de comandos. Los siguientes son escenarios en los que esta es la mejor opción:
- Convertir un valor de campo a un tipo de datos diferente
- Asignar todos los valores de origen a un valor de destino
- Crear un identificador único global (GUID)
- Realizar manipulación de formas para convertir entre tipos de geometría
Tabla de asignación
La tabla de asignación le permite agregar o invalidar las correlaciones realizadas con la herramienta Crear espacio de trabajo de carga de datos. La tabla de asignación también permite bloquear las correlaciones. Cuando cree la tabla de asignación, especifique cómo se asignarán los datos de origen al dataset de destino. Al hacerlo, disfruta de un mayor control sobre el proceso de carga de datos y se asegura de que los campos, los atributos y las descripciones de dominio se representen con precisión. El uso de una tabla de asignación es opcional, pero si se utiliza, la herramienta Crear espacio de trabajo de carga de datos utiliza la tabla de asignación como entrada. Tiene en cuenta las correlaciones especificadas en la tabla y las utiliza para ayudar en las correspondencias y los bloqueos que se crean.
Para más información sobre la tabla de asignación, consulte la documentación de la herramienta Generar tabla de asignación.