Refrescar conexión de entidades multiarchivo (GeoAnalytics Desktop)

Resumen

Refresca una conexión de entidades multiarchivo (MFC) existente y registra cualquier dataset nuevo que se haya agregado a la ubicación de origen.

Uso

• Esta herramienta requiere una MFC. Para crear una MFC, utilice la herramienta Crear conexión de entidades multiarchivo.

• Utilice esta herramienta para agregar uno o varios datasets nuevos a una conexión de entidades multiarchivo existente. Además, la herramienta volverá a registrar cualquier dataset que se haya eliminado con la herramienta Eliminar dataset de una conexión de entidades multiarchivo. A continuación, se muestran ejemplos de cuándo utilizar esta herramienta:

  • Ha copiado una carpeta de datos en la carpeta de origen de su MFC existente y quiere que se represente como un dataset en su MFC.
  • Ha utilizado la herramienta Eliminar dataset de una conexión de entidades multiarchivo y quiere agregar de nuevo al MFC los datasets que ha eliminado.

• Esta herramienta no refresca las propiedades del dataset existente que se hayan editado con la herramienta Actualizar propiedades de dataset de conexión de entidades multiarchivo. Todas las propiedades modificadas se mantendrán. En los escenarios siguientes se incluyen los flujos de trabajo recomendados:

  • Ha modificado el esquema de un dataset de origen existente: utilice la herramienta Actualizar propiedades de dataset de conexión de entidades multiarchivo para modificar los campos. También puede utilizar la herramienta Eliminar dataset de una conexión de entidades multiarchivo para eliminar el dataset y la herramienta Refrescar conexión de entidades multiarchivo si no existen modificaciones en el dataset de MFC que desee mantener.
  • Ha agregado archivos nuevos a un dataset existente: no se requieren pasos adicionales. Al ejecutar una herramienta de geoprocesamiento para analizar los datos del MFC, todos los archivos del dataset de MFC se incluirán para análisis.
  • Ha eliminado un dataset existente: utilice la herramienta Eliminar dataset de una conexión de entidades multiarchivo para eliminar el dataset de la MFC

• Los mensajes de la herramienta incluirán la siguiente información sobre los datasets detectados y su estado:

  • Omitido: todos los datasets existentes se omiten durante la actualización y permanecen como están.
  • Correcto: se han descubierto y agregado nuevos datasets a la MFC.
  • Con fallos: datasets que no se agregaron correctamente a la MFC.

  Al descubrir datasets en su MFC, podrían surgir uno de los dos problemas siguientes:

  • Faltan los datasets que esperaba. En este caso, verifique que la ruta que especificó como una carpeta de origen que contiene subcarpetas es correcta y corresponde a un tipo de datos admitido.
  • Uno o varios datasets no se registran. Si los datasets no se registran, observará una o varias de las siguientes consecuencias:

    Problema	Solución	Ejemplo
    El dataset no presenta el formato esperado.	Abra el archivo para comprobar si tiene el aspecto esperado. Si los datos no están estructurados correctamente, actualícelos e inténtelo de nuevo.	Un archivo .csv contiene unas pocas líneas y un resumen de los datos, pero solo líneas vacías a partir de ese punto.
    Los esquemas de los datasets de una carpeta no coinciden.	Todos los archivos de una carpeta de dataset deben tener el mismo esquema. Abra los archivos para comparar los esquemas. Resuelva cualquier discrepancia en los esquemas e intente registrar de nuevo el dataset.	Tiene un archivo .csv con 10 campos y otro con 8.
    Los tipos de archivo de un dataset de una carpeta no coinciden.	Todos los archivos de una carpeta de dataset deben tener la misma extensión (tipo de archivo). Compruebe los tipos de archivo de la ubicación de la fuente de datos y elimine o reubique cualquier archivo mal ubicado.	Un dataset de shapefile está en la misma carpeta que un archivo PARQUET.
    Tiene un formato de campo no reconocido.	Aunque es una situación improbable, puede ocurrir si el ORC y PARQUET utilizan un formato inesperado. Asegúrese de utilizar formatos de campo válidos.	Tiene un archivo PARQUET con un formato de campo desconocido.

  Más información sobre por qué los datasets no se han agregado a un archivo de MFC

• Una vez que refresque una MFC, utilice la herramienta Describir dataset para verificar que el dataset actualizado tenga el aspecto esperado.

• La herramienta Refrescar conexión de entidades multiarchivo identifica datasets nuevos. También se pueden utilizar las siguientes herramientas para modificar un MFC:

  • Copiar dataset de una conexión de entidades multiarchivo: copia un dataset de una MFC a una clase de entidad.
  • Duplicar dataset de una conexión de entidades multiarchivo: crea una vista de un dataset de MFC existente.
  • Eliminar dataset de una conexión de entidades multiarchivo: elimina un dataset de la MFC.
  • Actualizar propiedades de dataset de conexión de entidades multiarchivo: modifica las propiedades de un dataset de MFC individual.
  • Previsualizar dataset de una conexión de entidades multiarchivo: muestra una vista previa de las diez primeras entidades del dataset para verificar que se han registrado correctamente.
  • Describir dataset: para verificar que el dataset tenga el aspecto esperado.

• Esta herramienta de geoprocesamiento se basa en Spark. Consulte Conexiones de entidades multiarchivo para obtener más información sobre las conexiones de entidades multiarchivo y cómo usarlas.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Archivo de conexión de entidades multiarchivo	El archivo MFC que se va a refrescar.	File
Campos Geometría visible (Opcional)	Especifica si los campos utilizados para identificar la geometría se incluirán (estarán visibles) como campos de análisis cuando se utilice el archivo de MFC en otras herramientas de geoprocesamiento. Cuando los campos de geometría no están visibles, la geometría sigue aplicándose al dataset. La configuración de visibilidad de la geometría se puede modificar en la MFC. Activado: los campos de geometría se incluirán como campos de análisis. Esta es la opción predeterminada. Desactivado: los campos de geometría no se incluirán como campos de análisis.	Boolean
Campos Tiempo visible (Opcional)	Especifica si los campos utilizados para identificar el tiempo se incluirán (estará visible) como campos de análisis cuando se utilice el archivo de MFC en otras herramientas de geoprocesamiento. Cuando los campos de tiempo no están visibles, el tiempo sigue aplicándose al dataset. La configuración de visibilidad de tiempo se puede modificar en la MFC. Activado: los campos de tiempo se incluirán como campos de análisis. Esta es la opción predeterminada. Desactivado: los campos de tiempo no se incluirán como campos de análisis.	Boolean

Salida derivada

Etiqueta	Explicación	Tipo de datos
MFC actualizado	El archivo .mfc de entrada con datasets actualizados.	File

Python

arcpy.gapro.RefreshBDC(bdc_file, {visible_geometry}, {visible_time})

Nombre	Explicación	Tipo de datos
bdc_file	El archivo MFC que se va a refrescar.	File
visible_geometry (Opcional)	Especifica si los campos utilizados para identificar la geometría se incluirán (estarán visibles) como campos de análisis cuando se utilice el archivo de MFC en otras herramientas de geoprocesamiento. Cuando los campos de geometría no están visibles, la geometría sigue aplicándose al dataset. La configuración de visibilidad de la geometría se puede modificar en la MFC. GEOMETRY_VISIBLE—Los campos de geometría se incluirán como campos de análisis. Esta es la opción predeterminada. GEOMETRY_NOT_VISIBLE—Los campos de geometría no se incluirán como campos de análisis.	Boolean
visible_time (Opcional)	Especifica si los campos utilizados para identificar el tiempo se incluirán (estará visible) como campos de análisis cuando se utilice el archivo de MFC en otras herramientas de geoprocesamiento. Cuando los campos de tiempo no están visibles, el tiempo sigue aplicándose al dataset. La configuración de visibilidad de tiempo se puede modificar en la MFC. TIME_VISIBLE—Los campos de tiempo se incluirán como campos de análisis. Esta es la opción predeterminada. TIME_NOT_VISIBLE—Los campos de tiempo no se incluirán como campos de análisis.	Boolean

Salida derivada

Nombre	Explicación	Tipo de datos
updated_bdc	El archivo .mfc de entrada con datasets actualizados.	File

Muestra de código

RefreshBDC (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función RefreshBDC.

# Name: RefreshBDC.py
# Description: Refreshes a multifile feature connection to automatically discover datasets that 
#              have been added.
#
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
mfcFile = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc"

# Run Refresh Multifile Feature Connection
arcpy.gapro.RefreshBDC(mfcFile)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

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