branch¶
controle
divide a execução do pipeline em dois caminhos — verdadeiro e falso — conforme uma condição avaliada sobre os dados que chegam ao nó.
quando usar¶
- rotear registros de alto valor para um tratamento diferenciado (ex: pedidos acima de um valor vão para um fluxo de aprovação extra)
- separar dados válidos de inválidos para destinos diferentes (ex: notificar um time apenas quando há falha)
- montar lógica condicional simples sem duplicar o pipeline inteiro em dois fluxos paralelos
configuração¶
| campo | tipo | obrigatório | descrição |
|---|---|---|---|
condition_field |
string | sim | coluna avaliada pela condição |
operator |
enum | sim | ==, !=, >, <, >=, <=, contains, not_contains |
value |
string | sim | valor de comparação |
saídas¶
o nó tem duas saídas no canvas:
| saída | quando é seguida |
|---|---|
true |
quando a condição é satisfeita |
false |
quando a condição não é satisfeita |
conecte nós diferentes a cada saída para tratar os dois casos de forma independente.
exemplo¶
[fonte] → [branch: status == "cancelado"]
├── true → [notificação por e-mail: alerta de cancelamento]
└── false → [fábrica] → [lakehouse writer]
para mais de dois caminhos, use split
o branch sempre produz exatamente dois caminhos (verdadeiro/falso). quando você precisa de múltiplos segmentos nomeados a partir do valor de um campo (ex: uma saída por região), use o nó split.