Skip to content

Arquivo CSV

O nó Arquivo CSV lê dados de um arquivo .csv, .txt ou .tsv enviado pelo usuário diretamente pelo editor do ETL. O arquivo é armazenado no storage do Horus e lido pelo Agente a cada execução do fluxo.


Parâmetros de Configuração

  • Arquivo — Upload feito diretamente no editor. O arquivo é salvo no storage e reutilizado nas próximas execuções. Para trocar, clique em "Trocar arquivo".
  • Separador de colunas — Caractere que delimita as colunas no arquivo.
OpçãoSeparador
, (vírgula)Padrão CSV
; (ponto e vírgula)Comum em exportações do Excel BR
TabTSV (Tab-Separated Values)
| (pipe)Menos comum, evita conflito com vírgulas no texto
  • Codificação — Encoding do arquivo.
OpçãoUso
UTF-8Padrão moderno — use sempre que possível
Latin1 / ISO-8859-1Arquivos mais antigos
Windows-1252Exportações do Excel em português (acentos corretos)
  • Primeira linha é cabeçalho — Se marcado (padrão), a primeira linha define os nomes das colunas. Se desmarcado, o Agente gera nomes genéricos (Column1, Column2, ...).

Comportamento

  • O arquivo é enviado uma vez e fica armazenado no storage. O fluxo não precisa de novo upload a cada execução.
  • A leitura é feita via streaming — arquivos grandes não consomem memória excessiva.
  • Se o arquivo contiver caracteres especiais com encoding errado (ex: ç em vez de ç), troque a codificação para Windows-1252.

Limitações

  • O nó não suporta arquivos com múltiplas seções ou cabeçalhos repetidos (formatos não-padrão).
  • Para planilhas Excel, use o nó Arquivo Excel (ExtractStaticExcel).