renomear campo¶

fábrica

renomeia uma ou mais colunas, preservando a ordem original das colunas na tabela.

quando usar¶

padronizar nomes de coluna vindos de fontes com nomenclatura diferente (ex: cust_id → cliente_id)
alinhar o nome de uma coluna ao padrão de nomenclatura do seu lakehouse antes de persistir
corrigir nomes de coluna gerados automaticamente por uma extração (ex: campos json achatados)

configuração¶

campo	tipo	obrigatório	descrição
`renames`	lista de `{field, target_field}`	sim	pares de coluna origem → coluna destino

exemplo¶

{
  "renames": [
    { "field": "cust_id", "target_field": "cliente_id" },
    { "field": "cust_name", "target_field": "nome_cliente" },
    { "field": "amt", "target_field": "valor" }
  ]
}

todas as demais colunas da tabela permanecem inalteradas — apenas as colunas listadas em renames são afetadas.

combine com mapeamento para casos mais complexos

se além de renomear você também precisa selecionar apenas algumas colunas ou converter tipos ao mesmo tempo, use o nó mapeamento (de-para) — ele faz as três coisas em um único passo.