# 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


---

# Agent Instructions: 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-portuguese/tools/tarefas/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.