> 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-portuguese/tools/tarefas/etl/csv-local.md).

# CSV Local

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

A tarefa **CSV Local** no **Gaio DataOS** permite importar automaticamente arquivos CSV que foram enviados para um diretório local dentro do ambiente da plataforma. Ela é ideal para tratar arquivos de entrada entregues manualmente ou por integrações com sistemas externos que depositam arquivos em pastas internas para processamento.

***

## Como usar

### 1. Abrir a task

Navegue até:\
**Tasks > ETL > CSV Local**

***

### 2. Preencher os campos da task

* **Rótulo (opcional):** Nome para identificar a task no fluxo.
* **Tabela resultado:** Nome da tabela que será criada ou atualizada com o conteúdo do CSV.
* **Separador:** Delimitador utilizado no CSV (vírgula, ponto e vírgula, tabulação, etc.).
* **Pasta:** Caminho da pasta onde o arquivo CSV foi enviado\
  (ex.: `~/content/apps/31/imports/`).

{% hint style="warning" %}
Informe apenas o caminho da pasta, não o nome do arquivo.
{% endhint %}

***

#### 3. Opções avançadas

* **Auto detect schema (column names):**\
  Detecta automaticamente os nomes e tipos das colunas a partir da primeira linha do arquivo.
* **Modo inserção: anexar registros à tabela:**
  * **Habilitado:** Os novos registros do CSV serão adicionados à tabela existente.
  * **Desabilitado:** A tabela será sobrescrita com os novos dados.
* **Excluir após importar:**\
  Remove o arquivo da pasta após a importação bem-sucedida.\
  Recomendado para evitar reprocessamento ou acúmulo de arquivos.

***

#### 4. Salvar e executar

* Clique em **Save** para adicionar a task ao fluxo.
* Quando o fluxo for executado, o sistema irá recuperar automaticamente o **CSV mais recente** da pasta especificada e importar seu conteúdo conforme as configurações definidas.

***

### Casos de uso

* Processar arquivos enviados manualmente ou via **FTP/SFTP**
* Integrar sistemas que exportam CSVs para diretórios internos
* Automatizar ingestão em lote de dados (ex.: vendas, estoque, clientes)
* Gerenciar o ciclo de vida dos arquivos com exclusão automática após a importação