Capa de entidades

La Salida de capas de entidades escribe datasets de canalización de datos en una capa de entidades alojada o una tabla alojada. Puede crear una tabla o capa de entidades, sustituir los datos de una tabla o capa de entidades existente o agregar y actualizar registros a una tabla o capa de entidades existente.

Parámetros

En la tabla siguiente se indican los parámetros utilizados en la Salida de capa de entidades:

Parámetro	Descripción
Dataset de entrada	El dataset que se escribirá como una capa de entidades.
Geometría	El campo de geometría de punto, línea o polígono que contiene los lugares que se utilizarán en la capa de entidades de salida. Si no se especifica ninguna campo de geometría, la salida será una tabla alojada.
Tipo de hora	Especifica el tipo de tiempo de la capa de entidades de salida. Las opciones son Instante, Intervalo o Ninguno. Ninguno es el valor predeterminado.
Tiempo	El campo de tiempo que contiene las marcas de tiempo que se utilizarán en la capa de salida. Este parámetro es necesario si el Tipo de tiempo es Instante.
Hora de inicio	El campo de tiempo que contiene las marcas de tiempo de inicio que se utilizarán en la capa de salida. Este parámetro es necesario si el Tipo de tiempo es Intervalo.
Tiempo final	El campo de tiempo que contiene las marcas de tiempo de fin que se utilizarán en la capa de salida. Este parámetro es necesario si el Tipo de tiempo es Intervalo.
Método de salida	Especifica el método que se utilizará para escribir los resultados de salida. Las opciones son Crear (por defecto), Sustituir o Agregar y actualizar.
Capa de entidades	La tabla o capa de entidades alojada que se reemplazará con datos nuevos. Este parámetro es necesario si el método de salida es Reemplazar o Agregar y actualizar.
Identificador único	Especifica el campo que contiene valores únicos para cada registro. Este parámetro es necesario para actualizar los registros existentes en una capa de entidades utilizando el método de salida Agregar y actualizar.
Nombre de salida	Nombre de la tabla o capa de entidades de salida.
Carpeta	Carpeta de salida donde se guardará la tabla o capa de entidades.
Longitud de campo de cadena de caracteres	Un parámetro opcional para especificar la longitud de todos los campos de cadena de caracteres de salida. El valor predeterminado es 4000 caracteres de un solo byte.

Notas de uso

Para ejecutar una canalización de datos, debe configurarse al menos una salida.

Utilice el parámetro Dataset de entrada para identificar el dataset que se escribirá como tabla o capa de entidades alojada.

Utilice el parámetro Geometría para, de manera optativa, definir la geometría en la salida. Si el dataset de entrada tiene un único campo de geometría, este se especificará por defecto. Si el dataset de entrada tiene varios campos de geometría, especifique el que se utilizará en la capa de entidades. Los campos de geometría no especificados en este parámetro se suprimirán y no estarán disponibles en la salida. Si no se especifica ningún campo de geometría, el resultado de salida será una tabla.

Si lo desea, puede establecer el tiempo en la salida especificando un valor para Tipo de tiempo. Las opciones son las siguientes:

• Instante: un único momento en el tiempo. Utilice el parámetro Tiempo para especificar el campo que representa la hora del registro. Los campos de tiempo deben ser de tipo fecha.
• Intervalo: un intervalo de tiempo representado por un tiempo de inicio y un tiempo de fin. Utilice el parámetro Tiempo de inicio para especificar el campo que representa el tiempo de inicio del registro, y el parámetro Tiempo de fin para especificar el campo que representa el tiempo de fin del registro. Los campos de tiempo deben ser de tipo fecha.
• Ninguno: la capa de entidades de salida no tendrá tiempo.

Los campos de tiempo se almacenan en las tablas y capas de entidades utilizando el formato milisegundos desde la época y la hora universal coordinada (UTC). Los valores se mostrarán de forma diferente en función de dónde esté viendo los datos. Por ejemplo, si se consulta el punto final REST del servicio de entidades, se obtendrán valores en milisegundos a partir de la época, como 1667411518878. El mismo valor en el editor Data Pipelines se mostrará como 11/02/2022 5:51 PM.

Para modificar las propiedades del elemento, como el resumen o las etiquetas, vaya a la página de contenido de su portal y edite directamente el elemento de la capa de entidades.

Más información sobre los detalles de los elementos en ArcGIS Online

Utilice el parámetro Método de salida para especificar cómo se escribirán los resultados de la canalización de datos en una tabla o capa de entidades. Las opciones son las siguientes:

• Crear: se creará una tabla o capa de entidades alojada. La salida se almacenará en el contenido de su portal. La salida contendrá las entidades (o filas) y los campos (o columnas) del dataset de entrada.
• Reemplazar: los datos de una tabla o capa de entidades existente se sustituirán por completo.
• Agregar y actualizar: agregue nuevos registros o actualice los existentes en una tabla o capa de entidades. Para actualizar los registros existentes, debe especificar un campo que contenga valores únicos para identificar los registros existentes mediante el parámetro Identificador único. El campo que especifique debe establecerse como campo único en la página de elementos de la tabla o capa de entidades. Consulte Agregar un límite único a un campo para obtener más información.

Utilice el parámetro Longitud del campo de cadena de caracteres para especificar la longitud de los campos de cadena de caracteres que se crearán en la capa de entidades de salida. La longitud especificada se aplica a todos los campos de cadena de caracteres de salida. El valor predeterminado es 4000 caracteres de un solo byte. Si las cadenas de caracteres de su dataset de entrada exceden la longitud de cadena de caracteres especificada, los valores se truncarán y se escribirán en la capa de entidades de salida.

Limitaciones

A continuación se indican las limitaciones conocidas de la salida de la capa Entidad:

• Solo se puede escribir en una única tabla o capa para cada salida. Para crear múltiples salidas, debe configurar múltiples elementos de capa de entidades de salida en el diagrama. Cada salida se almacenará en el contenido de su portal como un elemento propio.
• Si tiene varias capas de entidades de salida configuradas y una falla al escribir, la canalización de datos continuará escribiendo las capas de entidades de salida restantes. Cualquier capa de entidades de salida que haya fallado durante la escritura se revertirá.
• No todos los tipos de campo admitidos por las fuentes de entrada se mantendrán al escribir los resultados en una capa de entidades. Consulte la tabla siguiente para obtener información detallada sobre cómo se convertirán los tipos de campo.
• No puede usar Reemplazar o Agregar y actualizar para tablas o capas de entidades que no le pertenezcan, a menos que sea administrador o que la capa o tabla esté compartida con un grupo de actualización compartida del que sea miembro.
• Cuando se utiliza Reemplazar o Agregar y actualizar, los campos se actualizan según los nombres de campo coincidentes. La coincidencia de campos distingue entre mayúsculas y minúsculas. Para hacer coincidir los nombres de los campos con la capa de salida deseada, utilice la herramienta Asignar campos. Para modificar una selección de nombres de campos, utilice la herramienta Actualizar campos.
• Al utilizar la opción Reemplazar, se aplican las siguientes limitaciones:
  • No se permite reemplazar los datos de una tabla o capa de entidades que es el origen de una relación.
  • Si la sincronización está habilitada en la tabla o capa de entidades, el reemplazo es incompatible.
  • El tipo de geometría de la capa que se va a sustituir debe ser el mismo que el del dataset de entrada. Por ejemplo, no puede sustituir una tabla por polígonos, ni sustituir puntos por polilíneas.
  • El tipo de tiempo de la capa que es va a sustituir debe ser el mismo que el del dataset de entrada. Por ejemplo, no puede sustituir las propiedades de tiempo instantáneo por propiedades de tiempo de intervalo.
  • Si la referencia espacial de la capa que se va a sustituir es diferente de la geometría de entrada, la geometría de entrada se proyectará a la referencia espacial de la capa que se va a sustituir.
  • Si existe un campo en el resultado de la canalización de datos, pero no en la capa que se va a sustituir, la capa no se agregará.
  • Si existe un campo en la capa que se va a sustituir, pero no en el resultado de la canalización de datos, se mantendrá en la capa y se agregará con valores nulos o los valores predeterminados definidos por la capa de entidades.
• El parámetro Longitud del campo de cadena de caracteres se aplica a todos los campos de cadena de caracteres de salida. Para crear una capa de entidades con campos de cadena de caracteres de diferentes longitudes, defina su propia capa y use el método de reemplazo de salida usando la capa que acaba de crear. Esto mantendrá las longitudes de los campos que definió y actualizará la capa de entidades con los registros de su canalización de datos. Para obtener más información sobre cómo crear una capa de entidades, consulte Definir su propia capa.

Los tipos y valores de campo del dataset de entrada pueden convertirse en nuevos tipos y valores compatibles con la capa de entidades de salida. Las conversiones de tipos de datos se describen en la tabla siguiente:

Tipo de campo del dataset de entrada	Tipo de campo de la capa de entidades de salida	Notas
Cadena de caracteres	esriFieldTypeString	Los campos de cadena de caracteres de las capas de entidades de salida se crean con una longitud de 4000 de forma predeterminada. Utilice el parámetro Longitud del campo de cadena de caracteres para especificar una longitud diferente. Los valores que superen la longitud especificada se truncarán.
Entero pequeño	esriFieldTypeInteger
Entero	esriFieldTypeInteger
Entero grande	esriFieldTypeBigInteger
Flotante	esriFieldTypeSingle
Doble	esriFieldTypeDouble
Fecha	esriFieldTypeDate	Los campos de fecha se escribirán sin zona horaria y se almacenarán en el formato de milisegundos desde epoch. Al usar la vista previa para ver valores de fecha, se utilizará la zona horaria de la configuración regional del navegador o del cliente. Más información sobre los campos de fecha en ArcGIS Online
Solo fecha	esriFieldTypeDateOnly
Blob	esriFieldTypeString	Los valores BLOB se convertirán en cadenas codificadas en base64 en la capa de entidades de salida. Al previsualizar este campo en la aplicación, los valores se convertirán en una cadena ("BLOB").
Booleano	esriFieldTypeString	Los valores booleanos se convertirán en cadenas y se almacenarán en la capa de entidades en un campo de cadena. Los valores verdaderos se escribirán como "True" y los falsos como "False".
Matriz	esriFieldTypeString	Los valores de las matrices se convertirán y almacenarán como campos de cadena.
Mapa	esriFieldTypeString	Los valores del mapa se convertirán y almacenarán como campos de cadena.
Struct	esriFieldTypeString	Los valores Struct se convertirán y almacenarán como campos de cadena.
Geometría	esriFieldTypeGeometry	El campo de geometría puede representar geometrías de puntos, líneas o polígonos en función del valor del parámetro Geometría.

Requisitos de licencia

Se requieren las siguientes licencias y configuraciones:

• Tipo de usuario Creator o GIS Professional
• Rol de publicador, moderador o administrador, o rol personalizado equivalente

Para obtener más información sobre los requisitos de Data Pipelines, consulte Requisitos.

Temas relacionados

• Para aprender a actualizar capas de entidades existentes con arreglo a un programa automatizado, consulte Programar una canalización de datos.
• Para obtener información sobre las propiedades definidas en capas de entidades, consulte Administrar capas de entidades alojadas.
• Para obtener más información sobre las capas de entidades, consulte Capas de entidades en la ayuda de ArcGIS Online.