> For the complete documentation index, see [llms.txt](https://docs.gaiodataos.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gaiodataos.com/gaio-dataos-spanish/herramientas/tareas/etl/csv-local.md).

# CSV Local

<figure><img src="/files/ozxg9jiWK2r8sTVRd9By" alt=""><figcaption></figcaption></figure>

La tarea **CSV Local** en Gaio DataOS permite importar automáticamente archivos CSV que han sido cargados en un directorio local dentro del entorno de la plataforma. Es ideal para procesar archivos de entrada entregados manualmente o mediante integraciones con sistemas externos que depositan archivos en carpetas internas para su procesamiento.

***

### Cómo usar

#### 1. Abrir la tarea

Navega a: **Tasks > ETL > CSV Local**

***

#### 2. Completar los campos de la tarea

* **Task label:** (Opcional) Nombre para identificar la tarea en el flujo.
* **Result table:** Nombre de la tabla que se creará o actualizará con el contenido del CSV.
* **Separator:** Delimitador utilizado en el CSV (coma, punto y coma, tabulación, etc.).
* **Folder:** Ruta de la carpeta donde se cargó el archivo CSV (ej.: `~/content/apps/31/imports/`).

{% hint style="danger" %}
&#x20;Debes ingresar únicamente la ruta de la carpeta, no el nombre del archivo.
{% endhint %}

***

#### 3. Opciones avanzadas

**Auto detect schema (column names)**

Detecta automáticamente los nombres de columnas y tipos de datos a partir de la primera fila del archivo.

**Insert mode: append records to table**

* **Habilitado:** Los nuevos registros del CSV se agregarán a la tabla existente.
* **Deshabilitado:** La tabla será sobrescrita.

**Delete after import**

Elimina el archivo de la carpeta después de una importación exitosa.\
Recomendado para evitar reprocesamientos o acumulación innecesaria de archivos.

***

#### 4. Guardar y ejecutar

Haz clic en **Save** para agregar la tarea al flujo.

Cuando el flujo se ejecute, el sistema recuperará automáticamente el archivo CSV más reciente de la carpeta especificada e importará su contenido según la configuración definida.

***

### Casos de uso

* Procesar archivos cargados manualmente o vía FTP/SFTP.
* Integrar sistemas que exportan archivos CSV a directorios internos.
* Automatizar ingestiones por lote (ventas, inventario, clientes).
* Gestionar el ciclo de vida de archivos mediante eliminación automática tras la importación.
