Archivo

La salida de Archivo escribe datasets de canalización de datos en un archivo CSV, GeoJSON o Apache Parquet de su contenido. Puede crear un archivo nuevo o sobrescribir uno existente.

Parámetros

La siguiente tabla describe los parámetros utilizados en la salida de Archivo:

Parámetro	Descripción
Dataset de entrada	El dataset que se escribirá como archivo.
Método de salida	Especifica el método que se utilizará para escribir los resultados de salida. Las opciones son Crear (el valor predeterminado) y Sobrescribir.
Formato de archivo	El formato del archivo que se va a escribir. Las opciones son CSV, GeoJSON y Apache Parquet.
Campo Geometría	El campo de geometría que se representará en el archivo GeoJSON resultante. Este parámetro no está disponible para los formatos de archivo CSV ni Apache Parquet.
Formato geoespacial	El formato geoespacial utilizado para escribir la salida de un archivo de Apache Parquet. Actualmente, la única opción es GeoParquet 1.1. Este parámetro no está disponible para los formatos de archivo CSV ni GeoJSON.
Campo de geometría principal	El campo de geometría principal utilizado para escribir la salida de un archivo de Apache Parquet. Las especificaciones de GeoParquet 1.1 requieren un campo de geometría principal. Este parámetro no está disponible para los formatos de archivo CSV ni GeoJSON.
Título	El título del elemento de archivo de salida.
Sobrescribir si el elemento ya existe	Especifica si se sobrescribirá (activado) un elemento existente con el nombre de salida proporcionado. Sobrescribir está activado de forma predeterminada.
Carpeta	La carpeta de salida en la que se guardará el archivo.
Elemento de archivo	Un archivo existente que se va a sobrescribir en la siguiente ejecución de canalización de datos. Esta opción solo está disponible si el parámetro Método de salida está establecido como Sobrescribir.

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 archivo.

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

• Crear: se creará un nuevo archivo en su contenido. Opcionalmente, puede utilizar el parámetro Sobrescribir si el elemento ya existe para sobrescribir el archivo cada vez que se ejecute la canalización de datos.
• Sobrescribir: se sobrescribirá por completo un archivo existente.

Los siguientes parámetros están disponibles cuando se selecciona el método de salida Crear:

• El parámetro Formato de archivo determina el tipo de archivo que se sobrescribirá. Las opciones son: CSV, GeoJSON y Apache Parquet.
• El parámetro Campo de geometría solo está disponible para los formatos de archivo GeoJSON y se utiliza para determinar la geometría del GeoJSON resultante. Los archivos GeoJSON solo admiten el sistema de coordenadas WGS84 (4326). Si el campo de geometría utiliza un sistema de coordenadas distinto al WGS84 (4326), se proyectará automáticamente antes de escribir los datos.
• El parámetro Campo de geometría principal determina qué campo de geometría se utilizará al escribir un archivo Apache Parquet. Este parámetro solo está disponible para los formatos de archivo Apache Parquet y se requiere en las especificaciones de GeoParquet 1.1. Actualmente, GeoParquet 1.1 es la única opción compatible para el parámetro Formato geoespacial.
• El parámetro Título especifica el nombre del elemento que se creará o sobrescribirá.
• El parámetro Sobrescribir si el elemento ya existe permite ejecutar de nuevo la canalización de datos sin cambiar el nombre de salida. Esta operación sobrescribirá por completo un archivo con el título especificado que esté almacenado en la carpeta especificada. Este parámetro está habilitado de forma predeterminada.
• El parámetro Carpeta determina la carpeta en la que se almacenará el resultado recién creado o la carpeta en la que está almacenado actualmente el elemento que se va a sobrescribir.

Al seleccionar el método de salida Sobrescribir, el parámetro Elemento de archivo está disponible. Utilice este parámetro para buscar y seleccionar el elemento a sobrescribir. Puede sobrescribir elementos de su propiedad o elementos compartidos con usted en un grupo de actualización compartida. Si el elemento seleccionado es de tipo GeoJSON o Apache Parquet, habrá un parámetro de campo de geometría disponible para especificar qué geometría del dataset de entrada se utilizará al sobrescribir el archivo existente.

A la hora de programar actualizaciones automatizadas de archivos, se recomienda utilizar el método de salida Sobrescribir, en lugar de la opción Sobrescribir si el elemento ya existe.

Para modificar las propiedades del elemento, por ejemplo, el resumen o las etiquetas, vaya hasta la página de contenido de su portal y edite directamente el elemento.

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

Limitaciones

A continuación, se indican las limitaciones conocidas de la salida de Archivo:

• Las salidas de los archivos CSV siempre serán tabulares. Para almacenar representaciones de cadenas de caracteres de una geometría en un archivo CSV, utilice la herramienta Actualizar campos para convertir el campo de geometría en una cadena de caracteres. Para suprimir los campos de geometría de un dataset antes de escribirlos en un archivo CSV, utilice la herramienta Seleccionar campos.
• Las salidas de archivos GeoJSON requieren una geometría y siempre almacenarán las geometrías en el sistema de coordenadas WGS84 (4326) para cumplir las especificaciones oficiales de GeoJSON. Si el campo de geometría utiliza un sistema de coordenadas distinto al WGS84 (4326), se proyectará automáticamente antes de escribir el elemento. Si el sistema de coordenadas es una cadena WKT personalizada, puede fallar al transformarlo a WGS1984 (4326). Utilice, en su lugar, la salida de Capa de entidades.
• Las salidas de archivos Apache Parquet siempre almacenarán la geometría en una columna binaria. Algunos sistemas de coordenadas personalizados (WKT) no se admiten para las salidas de archivos Apache Parquet y el archivo puede fallar al escribir. Utilice, en su lugar, la salida de Capa de entidades.
• Las operaciones de sobrescritura no se revierten cuando ocurre un fallo de escritura, lo que puede provocar la pérdida del elemento hasta que se vuelva a ejecutar la canalización de datos.
• No todos los tipos de campo admitidos por las fuentes de entrada se mantendrán al escribir los resultados en los archivos. Los tipos de campo se convertirán automáticamente para conseguir la compatibilidad con el formato de archivo seleccionado.
• No puede utilizar la opción Sobrescribir para archivos que no le pertenecen, a menos que sea administrador o que el archivo esté compartido con un grupo de actualización compartida del que sea miembro.
• Al utilizar una combinación de las opciones de salida Crear y Sobrescribir si el elemento ya existe, se aplican las siguientes limitaciones:
  • Esta opción no se recomienda para ejecuciones programadas o automatizadas. Para actualizaciones de archivos programadas y más fiables, utilice el método de salida Sobrescribir y busque explícitamente el valor de Elemento de archivo a sobrescribir.
  • El elemento a sobrescribir debe ser de su propiedad y debe estar almacenado en la carpeta especificada. Si el archivo tiene el mismo nombre en otra carpeta, no se sobrescribirá.
  • Las operaciones de sobrescritura no se revierten cuando ocurre un fallo de escritura, lo que puede provocar la pérdida del elemento hasta que se vuelva a ejecutar la canalización de datos.

Requisitos de licencia

Se requieren las siguientes licencias y configuraciones:

• Tipo de usuario Creator o 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

Consulte lo siguiente para obtener información adicional:

• Para obtener más información sobre cómo actualizar elementos con una programación automatizada, consulte Programar una tarea de canalización de datos.
• Para obtener más información, consulte Elementos admitidos en ArcGIS Online.