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}}/csvCampos 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