Selo de estado:
Preview(limite atual do produto) · Atualizado em 2026-10-03. Fonte de estado: matriz de estados do produto. Sem SLA.
Orquestração é o que acontece no grupo ETL/ELT do menu (Conexões · Pipelines · Execuções). É aqui que um pipeline vira uma versão publicada, ganha (ou não) uma agenda, é executado e, quando falha, é recuperado.
A separação importa e o produto a leva a sério:
| Objeto | O que é | Onde mora |
|---|---|---|
| Conexão | O acesso autorizado a uma origem: endereço, parâmetros e a credencial cifrada. | ETL/ELT → Conexões |
| Pipeline | A definição do que ler, transformar e escrever. Aponta para uma conexão; nunca copia a credencial. | ETL/ELT → Pipelines |
| Versão | A foto imutável da definição no momento da publicação. | Painel de publicação do pipeline |
| Agenda | A regra de quando executar. Você escolhe o horário de Brasília; ela fica desligada até você ativar. | Cartão Agendamento do pipeline |
| Execução | Uma rodada concreta daquela versão, com tarefas, tentativas e logs. | ETL/ELT → Execuções |
Publicar não é executar
A primeira publicação de um pipeline cria a versão 1 e deixa a agenda desligada. Nada é lido, escrito ou cobrado nesse momento. Ativar agenda e Executar agora são duas ações separadas, cada uma com o seu próprio clique.
Guias deste produto#
Publicar e versionar um pipeline
A primeira publicação, o que muda ao atualizar um pipeline já ativo e o que a versão congela.
Agenda, fuso e pausa
Ativar agenda, executar agora, pausar — e o horário de Brasília em que tudo é mostrado.
Acompanhar uma execução
Da execução à tarefa, da tarefa à tentativa, da tentativa ao log certo.
Recuperar uma falha
Os quatro escopos de recuperação e a prévia que corresponde ao efeito real.
Operação no dia a dia (artigos em Dados)#
Estes assuntos são de orquestração, mas os artigos moram em Dados desde a primeira versão da documentação. Os endereços continuam valendo — nada foi movido, nada quebrou:
- Agendamento, retry e DLQ — janelas, política de nova tentativa e fila de mensagens mortas.
- Ingestão incremental e backfill — watermark, checkpoint e reprocessamento de período.
- Pipeline medalhão — Bronze, Silver e Gold.
- Modos de carga — completa, incremental, acrescentar, mesclar, substituir.
- Tutoriais de pipeline — full, incremental com watermark, backfill e tratamento de falha.
Antes de começar#
- Você precisa ser dono do workspace para ver Pipelines e Execuções. Quem só consome BI não vê estas telas.
- Executar um pipeline é uma ação cara: com a assinatura em atraso, suspensa ou cancelada, a execução é bloqueada com uma mensagem explícita e um link para Planos. Ver Suspensão.
- O teste de conexão sai do servidor da aplicação; o executor dos pipelines roda em outra rede, com outro IP de saída. Libere os dois na sua rede.
Se algo der errado#
| Sintoma | Próxima ação |
|---|---|
| Publiquei e nada aconteceu | É o comportamento esperado: use Ativar agenda ou Executar agora. |
| A agenda não disparou | Confira se ela está ativa (selo Agenda ativa) e o horário de Brasília mostrado no pipeline. |
| Execução falhou | Abra a tarefa, depois a tentativa, depois o log — nessa ordem. |
| Reexecutei e duplicou | Confira o escopo escolhido na recuperação e o modo de carga do pipeline. |
| Credencial expirada | Corrija na conexão, uma vez. Todos os pipelines que apontam para ela passam a usar o novo valor. |
Última revisão: 2026-09-16. Exemplos usam o workspace fictício Comércio
Aurora Ltda (aurora). Nenhum dado de cliente aparece nesta documentação.