# 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


---

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