CSV Web

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

Atualizado