Publicar é congelar a definição do pipeline em uma versão identificável. Publicar não lê a origem, não escreve no destino e não liga a agenda.
Antes de começar#
- Ser dono do workspace (Pipelines é área do dono).
- Ter uma conexão salva e autorizada, ou usar o fluxo de arquivo.
- Assinatura em dia: executar é ação cara e passa pela verificação de acesso.
Passo a passo#
1. Abra o pipeline
Em ETL/ELT → Pipelines, use Novo pipeline para criar um pipeline novo, ou abra um existente. Partindo de uma conexão já salva, o atalho é Montar extração, no cartão da conexão em ETL/ELT → Conexões.
2. Revise a definição
Confira origem, dados selecionados, transformações, modo de carga e destino. Um rascunho pode ser salvo sem estar completo — ele não aparece como publicado e não pode ser executado.
3. Publique
Use Publicar (agenda desligada). O rótulo do botão é literal: é o que acontece.
4. Leia a confirmação
O produto responde: "Pipeline publicado na versão 1 — a AGENDA ficou DESLIGADA e nada foi executado." A partir daí, Ativar agenda e Executar agora ficam disponíveis no painel de publicação do pipeline.
Resultado esperado#
- Existe uma versão identificável da definição (a primeira é a versão 1).
- A agenda está desligada.
- Nenhuma linha foi lida, escrita ou cobrada.
- O evento fica registrado na auditoria.
Atualizar um pipeline que já está ativo#
Republicar um pipeline que já tem agenda ativa não desliga a agenda em silêncio. A tela informa o efeito sobre a agenda existente antes de você confirmar. Se o efeito informado não for o que você quer, cancele e ajuste.
O que a versão congela
A versão congela a definição — o que ler, transformar e escrever. Ela não congela a credencial: o pipeline aponta para a conexão, então trocar a senha na conexão vale para todas as versões e todos os pipelines que a usam.
Baixar a definição publicada#
Com pelo menos uma versão publicada, o painel de publicação do pipeline mostra
Baixar definição publicada (JSON). O botão gera um arquivo
<nome-do-pipeline>-v<N>-definicao.json com a definição congelada na versão
mais recente — exatamente o que foi publicado, sem recálculo. Baixar é
leitura: não executa, não publica e não mexe na agenda (R$ 0).
O que vem no arquivo
formatVersion: versão do formato do arquivo (hoje1).pipeline:id,name,versionepublishedAt(UTC).snapshot: a definição — conector, parâmetros não sensíveis da origem (host, banco, porta), prefixo de destino, agenda, limites (GB/mês estimado), tabelas Bronze (origem, destino, escrita full/append, coluna-chave, partição, clusterização, colunas PII marcadas) e transformações Silver/Gold (modo, origem, filtro, dependências). Trazv(versão do snapshot) echecksum— o mesmo exibido no histórico de versões.
O que não vem
- Nenhuma credencial: senha, token ou chave de serviço nunca entram na definição; se um campo sensível for detectado, o download é recusado.
- Nenhum dado: o arquivo descreve o pipeline, não o conteúdo das tabelas.
- Nada de estado de execução: runs, linhas carregadas e erros ficam em Acompanhar uma execução.
Como usar na revisão
- O JSON tem chaves ordenadas e um campo por linha: a mesma definição produz
sempre os mesmos bytes, então dois arquivos de versões diferentes podem ser
comparados com
diffou commitados no repositório do time. - O
checksumpermite conferir que o arquivo não foi alterado depois de baixado. - O download fica registrado na auditoria
(
pipeline.definition.export), com quem baixou e qual versão. - Quem pode baixar: membros do workspace (
memberou acima). O papelviewersó consome dashboards e relatórios.
O arquivo é também o que os desafios práticos da Ingestia Academy pedem como entrega.
Se algo der errado#
| Sintoma | O que conferir | Próxima ação |
|---|---|---|
| Publicação bloqueada | A validação apontada na revisão | Corrija o item indicado; não invente dependência ou credencial para avançar |
| Botão de baixar definição não aparece | Se existe versão publicada | Publique uma vez com Revisar e publicar; pipeline sem versão registrada não tem o que baixar |
| "Ação não permitida para o papel viewer" | Seu papel no workspace | Peça a um administrador que ajuste o papel para member ou acima |
| Publiquei e não rodou | O estado da agenda | É o comportamento esperado — use Ativar agenda ou Executar agora |
| Publiquei e a agenda sumiu | A mensagem de efeito mostrada na republicação | Reative em Ativar agenda; o produto nunca desliga sem avisar |
| "Assinatura … está bloqueada" | Situação comercial do workspace | Regularize em Administração → Planos |
Limites e custos#
- Publicar: R$ 0. Não há leitura da origem nem escrita no destino.
- Executar consome recursos de nuvem — ver custo, limites e segurança.
- Não publicamos tempo de publicação nem de execução: depende do volume dos seus dados e da origem. Não há medição publicada.
Próxima tarefa#
Última revisão: 2026-10-04.