filtrar linhas

fábrica

remove registros que não atendem a uma ou mais condições, combinadas com AND ou OR.

---

quando usar

• descartar registros de teste, cancelados ou inválidos antes de persistir no lakehouse
• recortar um subconjunto de negócio específico (ex: apenas pedidos de uma região) para um pipeline dedicado
• aplicar uma regra de negócio simples sem escrever sql (ex: valor > 0)

---

configuração

campo	tipo	obrigatório	descrição
logical_operator	enum	não	AND (todas as condições) ou OR (qualquer condição) · padrão: AND
conditions	lista de {field, operator, value}	sim	condições combinadas pelo operador lógico

operadores suportados

operador	efeito
==, !=, >, <, >=, <=	comparação direta (numérica ou textual, conforme o valor)
contains / not_contains	busca parcial de texto (case-insensitive)
is_null / not_null	testa se o campo é nulo ou não

---

exemplo

{
  "logical_operator": "AND",
  "conditions": [
    { "field": "status", "operator": "==", "value": "ativo" },
    { "field": "valor", "operator": ">", "value": "0" }
  ]
}

mantém apenas linhas com status = 'ativo' e valor > 0.

{
  "logical_operator": "OR",
  "conditions": [
    { "field": "email", "operator": "contains", "value": "@empresa.com" },
    { "field": "dominio_corporativo", "operator": "==", "value": "true" }
  ]
}

mantém linhas que atendem qualquer uma das duas condições.

linhas removidas aparecem no log

o log de execução do nó mostra quantas linhas passaram e quantas foram removidas pelo filtro — útil para validar rapidamente se a condição está correta.