Arquivos

Tipo

Referência

Para

Engenharia de dados, Desenvolvedor

Na tela

HorusETL › Dataflows › editor do Dataflow

Quatro nós leem arquivo, no grupo Arquivos da biblioteca de nós. Dois usam um arquivo enviado pelo editor e guardado no Lumo; os outros dois leem um caminho no computador do Agente ETL.

Na biblioteca	kind no YAML	De onde vem o arquivo	Formatos
CSV (Estático)	ExtractStaticCSV	enviado pelo editor	.csv, .txt, .tsv
Excel (Estático)	ExtractStaticExcel	enviado pelo editor	.xlsx, .xls
Excel	ExtractExcel	caminho no computador do Agente ETL	.xlsx, .xlsb, .xls
Arquivo Parquet	ExtractParquet	caminho no computador do Agente ETL ou URL	.parquet

Para carregar uma planilha direto numa tabela, sem Dataflow, veja como o dado entra.

Arquivo enviado pelo editor

Os nós CSV (Estático) e Excel (Estático) guardam o arquivo no armazenamento do Lumo. O envio é feito uma vez, e o Agente ETL baixa o arquivo a cada execução.

No nó, Escolher arquivo abre a Biblioteca de arquivos, com os arquivos do Tenant já enviados daquele tipo. Arraste um arquivo novo ou escolha um da lista. Depois de escolhido, o nó mostra Baixar e Trocar. Trocar o arquivo apaga as colunas já lidas: execute o nó de novo para vê-las. Excluir da biblioteca o arquivo que o nó usa deixa o nó sem arquivo.

CSV (Estático)

Na tela	No YAML (options)	Padrão	Regra
Escolher arquivo	FileId, FileName	nenhum	Gravados pelo editor no envio. No YAML, crie o nó e envie o arquivo pelo editor
Separador de colunas	Separator	,	, (vírgula), ; (ponto e vírgula), Tab (\t), | (pipe)
Codificação do arquivo	Encoding	utf-8	UTF-8 (padrão moderno) (utf-8), Latin1 / ISO-8859-1 (latin1), Windows-1252 (Excel BR) (windows-1252)
Primeira linha é o cabeçalho	HasHeader	ligado	Desligado, as colunas se chamam COL1, COL2...

O nó lê o arquivo duas vezes: na primeira descobre as colunas e os tipos, na segunda entrega as linhas. Arquivo grande não precisa caber na memória.

• Nome das colunas: sem acento e em maiúsculas. Ficam letras, números, _, # e $; espaço, hífen e ponto viram _. Nome que começa com número ganha um C na frente, e o limite é de 30 caracteres. Nome vazio vira COL mais a posição, e nome repetido ganha _2, _3.
• Tipos: a coluna é número quando todo valor preenchido é número com ponto decimal (1234.56, -1, 1e10). Vírgula decimal não conta: 32,87 deixa a coluna como texto. A coluna é data quando todo valor preenchido está em yyyy-MM-dd ou yyyy-MM-dd HH:mm:ss. O resto é texto.

Caracteres estranhos na prévia (ç no lugar de ç) indicam codificação errada. Troque para Windows-1252.

Excel (Estático)

Na tela	No YAML (options)	Padrão	Regra
Escolher arquivo	FileId, FileName	nenhum	Gravados pelo editor no envio

O nó lê a primeira aba da planilha, com a primeira linha como cabeçalho. Não há como escolher outra aba: deixe os dados na primeira.

Arquivo no computador do Agente ETL

Os nós Excel e Arquivo Parquet leem um caminho no computador onde o Agente ETL roda. Por isso só servem com um Agente ETL instalado na sua rede, que enxerga a pasta. O caminho aceita variáveis: {PASTA_ENTRADA}/vendas.xlsx.

Excel

Na tela	No YAML (options)	Padrão	Regra
Caminho do arquivo:	CaminhoArquivo	vazio	Caminho completo, como C:\Dados\vendas_2026.xlsx ou /mnt/dados/vendas.xlsx. Se não existir, o nó falha com "O caminho '...' não foi encontrado."

Arquivo Parquet

Na tela	No YAML (options)	Padrão	Regra
Caminho do Arquivo:	CaminhoArquivo	vazio	Caminho completo ou URL. Começando com http, o Agente ETL baixa o arquivo para uma pasta temporária antes de ler. Vazio falha com "Caminho do arquivo não informado"

O Parquet já traz os nomes e os tipos das colunas, e o nó usa os dele.

Como o Excel nomeia e tipa as colunas

Vale para Excel e Excel (Estático).

• Nome das colunas: vem da primeira linha. Perde acento, fica só com letras, números, espaço e hífen, é cortado em 45 caracteres, troca espaço por _ e vai para maiúsculas. Célula vazia no cabeçalho vira VAZIO, e nome repetido ganha _1, _2.
• Tipos: vêm da segunda linha, a primeira de dados. Número vira número, data vira data, o resto vira texto. Célula vazia nessa linha deixa a coluna como texto, mesmo que as de baixo sejam números.

A planilha inteira é carregada na memória do Agente ETL. Para arquivo de milhões de linhas, prefira CSV ou Parquet.

Exemplo

- internalId: csv_metas
  kind: ExtractStaticCSV
  description: Metas por vendedor
  inputs: []
  options:
    Separator: ";"
    Encoding: windows-1252
    HasHeader: true

Depois do lumo push, abra o nó no editor e escolha o arquivo: é o envio que grava FileId e FileName.

Relacionado

• Índice dos nós
• Google Sheets
• Outras saídas

Pelo Lumo CLI

O nó também pode ser escrito e versionado em YAML. Veja a referência de flow.