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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gaiodataos.com/gaio-dataos-spanish/herramientas/tareas/etl/csv-local.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.