Propagação de colunas

Descrição

Quando você altera uma coluna na origem — renomeia, muda o tipo ou remove — todas as etapas seguintes que mapeiam essa coluna precisam ser atualizadas para acompanhar. A Propagação de colunas faz esse trabalho por você com uma única confirmação.

A propagação está disponível em qualquer etapa que tenha um ColumnMapper (Project Table, Calculate, Append, Merge etc.). Dois botões na barra de ferramentas do mapeador a acionam:

• Propagate All — propaga todas as colunas do mapeador
• Propagate Selected — propaga apenas as colunas que você selecionou na grade do mapeador

Propagar uma alteração de coluna

1. Abra a etapa do fluxo de trabalho que contém a coluna que você quer alterar
2. No ColumnMapper, faça a alteração (renomear, mudar o tipo etc.)
3. Clique em Propagate All (ou selecione linhas e clique em Propagate Selected) na barra de ferramentas do mapeador
4. A caixa de diálogo Propagar para as etapas seguintes é aberta com uma árvore de todas as etapas que dependem da etapa de origem
5. Marque as etapas às quais você quer aplicar a alteração — as etapas filhas são incluídas automaticamente
6. Para etapas de agregação, escolha a função de agregação das novas colunas no painel Agregação inferior
7. Clique em Confirm

O painel Agregação lista as funções de agregação padrão. Avançado, sem agrupamento, usado com funções de janela, é definido no próprio mapeador da etapa e não é oferecido aqui. Se a agregação escolhida não servir para uma coluna, a caixa de diálogo informa qual coluna e o motivo para que você escolha outra.

A caixa de diálogo usa padrões seguros: quando uma linha de etapa seguinte não tem mapeamento explícito para a coluna, o nome de origem é reutilizado como destino para que nenhuma informação se perca no caminho.

O que é propagado

• Renomeação de coluna — mudança de nome de origem → destino
• Mudança de tipo — o dtype é atualizado em todos os lugares em que a coluna aparece
• Novas colunas adicionadas nesta etapa — seguem adiante para os mapeadores das etapas seguintes
• Operações de remoção (strip) aplicadas à origem

As etapas que não referenciam a coluna continuam aparecendo na árvore, mas ficam desmarcadas por padrão.

Erros e novas tentativas

Se uma etapa seguinte foi editada por outra pessoa depois que a caixa de diálogo foi aberta, a propagação falha com um erro de versão desatualizada. A caixa de diálogo busca o grafo de dependências novamente de forma automática e permite tentar de novo sem perder suas seleções. Se a própria nova busca falhar, suas seleções continuam preservadas para que você resolva o problema de fundo e tente novamente.

Nota

A propagação de colunas só modifica etapas dentro do mesmo fluxo de trabalho. Se um fluxo de trabalho posterior consome a tabela, atualize os mapeadores dele separadamente ou execute uma auditoria de dependências para encontrar as etapas afetadas.