> 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-web.md).

# CSV Web

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

A **CSV Web Task** no **Gaio DataOS** permite importar automaticamente um arquivo CSV hospedado em uma **URL pública** diretamente para o ambiente do seu projeto. Esse recurso é ideal para integrar dados externos, como planilhas públicas, exportações de sistemas de terceiros ou APIs que disponibilizam downloads em CSV.

***

## Como usar

### 1. Abrir a task

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

***

### 2. Configurar a task

* **Rótulo (opcional):** Nome para identificar esta etapa no fluxo.
* **Tabela resultado:** Nome da tabela que será criada ou atualizada com os dados importados.
* **Arquivo URL:** URL pública do arquivo CSV\
  (ex.: `https://example.com/data.csv`)
* **Parâmetros aplicáveis:** Caso a URL possua elementos dinâmicos, é possível utilizar parâmetros do ambiente.\
  **Exemplo:**\
  `https://pncp.gov.br/api/pncp/v1/orgaos/{{params}}/csv`
* **Campos terminados por:** Defina o delimitador utilizado no arquivo CSV\
  (vírgula, ponto e vírgula, tabulação, etc.).

***

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

* **Detectar automaticamente o esquema (nomes das colunas):**\
  Quando habilitado, o sistema detecta automaticamente os nomes e tipos das colunas com base na primeira linha do CSV.
* **Modo inserção: anexar registros à tabela**
  * **Habilitado:** Os novos dados serão adicionados aos registros existentes na tabela.
  * **Desabilitado:** A tabela será sobrescrita com os novos dados importados.

***

### 4. Salvar e utilizar

* Clique em **Save** para adicionar a tarefa ao fluxo.
* Quando executada, o Gaio irá buscar o CSV na URL informada e importar os dados conforme a configuração definida.

***

### Casos de uso

* Conectar-se a datasets públicos de fontes governamentais, financeiras ou climáticas
* Integrar relatórios atualizados regularmente via HTTP
* Importar dados mantidos em sistemas externos que expõem CSVs
* Automatizar a ingestão de feeds de dados em tempo real ou agendados