Selo de estado:
GA-candidatono motor de transformação (determinístico) · execução real no datalake =Preview· Atualizado em 2026-10-03. Fonte de estado: matriz de estados do produto. Limite atual do produto = Preview.
O que você vai fazer#
Definir uma carga, revisar suas etapas, publicar uma versão e executar a primeira carga de forma explícita.
Publicar a definição e executar os dados são ações diferentes
A primeira publicação cria a versão 1 e deixa a agenda desligada. Nada é lido nem escrito nesse momento. Ativar agenda e Executar agora são duas outras decisões, cada uma com o seu botão.
A transformação segue a arquitetura medalhão:
- Bronze — dado cru, como chegou da origem.
- Silver — dado limpo e padronizado (tipos, datas, colunas, condicionais).
- Gold — datamart pronto para BI (agregações, joins, modelo de negócio).
Antes de começar#
- Uma conexão autorizada (ver Conectar a primeira fonte) ou um arquivo no fluxo de importação suportado.
- Ser dono do workspace: Pipelines e Execuções são áreas do dono.
- Saber o que pode ser lido na origem e onde pode ser gravado.
- Para o tutorial, use um conjunto pequeno e sintético, com chaves e valores que você conhece de antemão.
- Assinatura em dia. Executar é uma ação cara: em atraso, suspensão ou cancelamento a execução é bloqueada com uma mensagem explícita e um link para Planos.
- A primeira carga consome recursos de nuvem, cobrados em créditos.
Onde os pipelines moram#
Em ETL/ELT → Pipelines. A lista mostra, por pipeline, o conector de origem, a agenda e a última execução — e o botão Novo pipeline abre a montagem.
Criar o pipeline — o modo guiado (o caminho mais simples)#
Novo pipeline abre quatro perguntas:
| # | Pergunta | O que você escolhe |
|---|---|---|
| 1 | De onde vêm os dados? | Uma conexão salva, Enviar arquivo ou planilha, ou Conectar um banco de dados |
| 2 | O que trazer? | As tabelas (banco) ou os arquivos — e, para arquivo, se o novo substitui ou junta com os anteriores |
| 3 | Quando atualizar? | Só quando eu mandar, Todo dia, num horário (Brasília) ou Sempre que eu enviar um arquivo novo |
| 4 | Revisar e criar | Criar e rodar agora ou Só criar |
O modo guiado traz a tabela inteira a cada execução. Para carga só do que mudou, transformações, partição, alertas ou ferramentas (Google Sheets, Ads, CRM), use Usar o modo completo, descrito abaixo.
Montar o pipeline no modo completo — as seis etapas#
O modo completo (Usar o modo completo, ou Novo relatório na lista) tem uma régua única de seis etapas, a mesma para extração e para relatório Gold:
| # | Etapa | O que você decide nela |
|---|---|---|
| 1 | Conexões | Qual conexão salva o pipeline vai referenciar. A credencial não é copiada. |
| 2 | Dados | Quais tabelas, arquivos ou endpoints entram, com campos, tipos e amostra quando autorizada. |
| 3 | Carga | O modo de carga e o efeito no destino: substituir, mesclar e acrescentar não são a mesma coisa. |
| 4 | Transformações | As etapas Silver/Gold compatíveis com a tarefa, e as dependências no grafo. |
| 5 | Operação | Agenda, limites, tentativas e alertas. |
| 6 | Revisão | Destino, escrita, etapas da execução, agenda, limites e alertas antes de publicar. |
Partindo de uma conexão já salva, o atalho equivalente é Usar num pipeline novo, no menu da conexão em ETL/ELT → Conexões — e, se você abrir o assistente de conexão de dentro da montagem, ao salvar você volta para o mesmo rascunho com a conexão nova já selecionada.
Sobre a etapa 1
A opção "— informar credenciais avulsas —" existe para casos pontuais, mas perde a vantagem de trocar a senha em um lugar só. Prefira referenciar uma conexão.
Publicar a versão 1#
A publicação acontece na etapa Revisão, no botão Publicar pipeline. Ao lado dele, antes do clique, a tela diz o que vai acontecer: "Publicar cria a versão do pipeline. A agenda ficará desativada e nenhuma carga será iniciada."
Publicado, o assistente responde "Pipeline publicado — versão 1", com o selo Agenda desativada e a frase "A versão 1 da definição está congelada. Nenhuma execução foi criada, nenhuma carga rodou e nenhum intervalo anterior foi recuperado." As três ações seguintes — Executar agora, Ativar agenda e Abrir operação — aparecem separadas, cada uma com o seu botão.
Na tela do pipeline, o painel Publicação e agenda mostra o mesmo estado: o selo Versão 1 publicada, o estado da agenda e três ações — Revisar e publicar, Ativar agenda e Executar agora. O botão do meio é Ativar agenda justamente porque a agenda está desligada; ele só vira Pausar agenda depois que você a ligar.
Vocabulário da agenda nesta tela
O selo de estado usa "Agenda pausada" quando há horário configurado e a chave está desligada; o cartão de agendamento, logo abaixo, usa "Agenda DESLIGADA". São a mesma coisa: nada é despachado até você ativar.
Executar a primeira carga#
Use Executar agora. Revise contexto, versão e destino antes de confirmar. Ativar agenda é uma ação separada, para depois — e ativar a agenda não dispara recuperação histórica.
Acompanhar a execução#
Em ETL/ELT → Execuções. A lista separa falha na última execução (o que pede ação agora) de falhas no período (histórico), mostra a agenda por pipeline e mostra os horários no horário de Brasília.
Abra a execução criada e desça de Execução para Tarefa, de Tarefa para Tentativa e só então para a aba Logs. O log mostrado é o daquela tentativa — o seletor de tentativa fica no topo, ao lado do seletor de execução.
A aba Grafo mostra as dependências entre as tarefas da versão executada.
Conferir o resultado nos dados#
Um estado "sucesso" não substitui a conferência. Abra Dados → Console de dados e valide: as tabelas existem, a contagem bate com o conjunto de teste, as chaves e os valores conhecidos estão lá.
Pipelines legados (criados antes da publicação versionada)#
Nem todo pipeline do seu workspace passou por este fluxo. Os que foram criados antes da publicação versionada não têm versão registrada, e a tela diz isso em vez de fingir uma versão 1 retroativa:
- o selo é "Versão não registrada", não "Versão 1 publicada";
- a agenda aparece como Manual quando não há frequência/horário definidos — mesmo que a chave da agenda esteja ligada, porque a chave sozinha não cria agenda;
- se o cadastro antigo guardou uma expressão de cron, a tela declara que ela não é despachada: só o agendamento do pipeline (frequência e horário) dispara execução automática.
A captura abaixo é de um pipeline legado do ambiente de demonstração. Ela está aqui para você reconhecer esse estado — não é a tela de uma primeira publicação (essa é a da seção Publicar a versão 1).
Para trazer um pipeline legado para o versionamento, use Revisar e publicar: a publicação cria a versão a partir da definição atual. Nesse caminho a agenda é preservada como está — atualizar um pipeline nunca desliga a agenda por efeito colateral.
Resultado esperado#
- Uma definição publicada, identificável por versão.
- Uma execução rastreável, com tarefas, tentativas e logs.
- Dados conferidos no destino, não apenas um selo verde.
- A agenda permanece como você a deixou: desligada, se você não a ativou.
O fim da execução não atualiza todo painel automaticamente
A atualização do dashboard é uma etapa própria. Ver Consultar um dashboard.
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; não invente dependência ou credencial para avançar |
| Publiquei e nada rodou | O estado da agenda | Comportamento esperado — use Executar agora ou Ativar agenda |
| Não iniciou | Situação da assinatura, limite de concorrência, permissão | Confira a mensagem na tela; regularize em Planos se for cobrança |
| Falha de autenticação | A conexão referenciada | Corrija na conexão; não recadastre a senha no pipeline |
| Falha de schema ou de escrita | Contrato de entrada, mapeamento, efeito no destino | Ver pipeline e schema |
| Nova tentativa pendente | Limite e horário da tentativa | Não dispare cargas paralelas sem necessidade |
| Sucesso, mas painel vazio | Destino, materialização, vínculo do BI, filtros e atualização do painel | Ver Consultar um dashboard |
| Reexecutei e duplicou | Modo de carga e escopo da recuperação | Ver Recuperar uma falha |
| A execução histórica não mostra versão | Execuções anteriores ao versionamento | A tela avisa; não trate data posterior como prova de conteúdo |
Limites e custos#
- Criar e publicar: R$ 0. Executar consome recursos de nuvem (créditos).
- Não publicamos tempo de execução: depende do volume dos seus dados, da origem e da fila. Não há medição publicada.
Voltar ao aplicativo#
- Montar um pipeline: ETL/ELT → Pipelines
- Acompanhar execuções: Execuções
Próxima tarefa#
Última revisão: 2026-09-17. As capturas desta página saíram da versão
entregue, num ambiente de demonstração com dados fictícios (workspace sintético
do seed do projeto), viewport 1366×768; a execução com falha mostrada é uma
falha provocada na fixture, não um incidente de cliente. A procedência de
cada imagem fica no manifesto de capturas e2e/baseline/galeria-v3.json. Uma
captura de ambiente local documenta a interface; ela não comprova execução em
nuvem.