Pular para conteúdo

criando um workflow

este guia mostra como montar um workflow do zero no construtor visual — do primeiro nó até a validação final antes de salvar.

1. abra o builder

dentro de um pipeline, clique em novo workflow (ou abra um workflow existente para editar). você entra no canvas visual: um espaço em branco onde os nós são posicionados e conectados.

2. arraste os nós que você precisa

na paleta lateral, os nós estão organizados por categoria — fontes, transformações, controle de fluxo e lakehouse writer. arraste o nó desejado para o canvas.

para o exemplo mais simples possível:

  1. arraste um nó de fonte (ex: api rest ou postgresql).
  2. arraste um nó de transformação (ex: filtrar linhas).
  3. arraste um nó lakehouse writer.

3. conecte os nós

clique e arraste a partir da borda de saída de um nó até a borda de entrada do próximo. a seta desenhada representa o fluxo de dados: tudo que sai do nó de origem é recebido como entrada pelo nó de destino.

[api rest] ──▶ [filtrar linhas] ──▶ [lakehouse writer]

um nó pode alimentar mais de um caminho (ex: gravar em duas camadas diferentes, ou seguir para um nó de controle de fluxo que decide o caminho com base numa condição).

4. configure cada nó

clique em um nó para abrir seu painel de configuração:

  • fontes: endereço do sistema (URL, host), credencial (selecionada do cofre de credenciais, nunca digitada em texto livre) e parâmetros de leitura.
  • transformações: a expressão ou regra da operação (ex: a condição do filtro, as colunas do agrupamento).
  • lakehouse writer: qual lakehouse, qual camada (bronze/silver/gold) e o modo de escrita (append, replace ou merge por chave).

5. teste um nó individualmente

antes de rodar o workflow inteiro, valide cada nó isoladamente: clique no ícone de teste do nó (o raio ⚡). a datablixt executa apenas até aquele ponto, com uma amostra dos dados, e mostra o resultado — colunas, tipos e uma prévia das linhas — diretamente no painel, incluindo qualquer erro de configuração.

isso permite ajustar a query, o filtro ou o mapeamento sem esperar o workflow completo terminar a cada tentativa.

modo amostra

ative o modo amostra na barra superior do builder para rodar o workflow inteiro (não só um nó) sobre um recorte pequeno dos dados — útil para validar o encadeamento completo antes de processar o volume real.

6. salve o workflow

ao salvar, a datablixt registra automaticamente uma nova versão do workflow — um ponto de restauração do estado anterior. isso significa que testar uma mudança arriscada nunca é uma via de mão única: é sempre possível reverter. veja como funciona em versionamento.

próximos passos