converter tipo¶

fábrica

converte o tipo de dado de uma coluna existente (ex: texto → data, texto → número).

quando usar¶

corrigir uma coluna que chegou como texto de uma api ou planilha, mas deveria ser numérica ou data
padronizar o tipo de uma coluna antes de um quality gate que valida tipo
preparar colunas para agregações numéricas que exigem tipo correto

configuração¶

campo	tipo	obrigatório	descrição
`field`	string	sim	nome da coluna a converter
`target_type`	enum	sim	`str`, `int`, `float`, `bool`, `datetime`
`date_format`	string	não	formato de data de entrada, quando `target_type = datetime` e o formato não é o padrão iso

exemplo¶

{
  "field": "valor",
  "target_type": "float"
}

{
  "field": "data_pedido",
  "target_type": "datetime",
  "date_format": "%d/%m/%Y"
}

conversões que falham não quebram o pipeline

quando um valor não pode ser convertido para o tipo alvo, ele vira nulo em vez de interromper a execução. use um quality gate logo depois com uma regra not_null na coluna convertida para capturar essas falhas antes de persistir.

conversão em lote

se você precisa tipificar várias colunas de uma vez (por exemplo, ao preparar dados para a camada bronze), use o nó schema cast, que faz inferência automática e conversão de todas as colunas em um único passo.