Selo de estado:
Preview(limite atual do produto) · Atualizado em 2026-10-03. Esta página é inventário de interface: o texto aqui é o texto da tela, literalmente. Para aprender a tarefa com capturas, vá em Primeira ingestão.
Onde fica: menu ETL/ELT → Pipelines.
Um pipeline traz os dados de um sistema ou arquivo para o datalake, onde eles viram painéis.
Criar um pipeline — o modo guiado (/sources/new)#
Novo pipeline abre o modo guiado: quatro perguntas.
| Pergunta | O que você escolhe |
|---|---|
| 1 · De onde vêm os dados? | Uma das Suas conexões, Enviar arquivo ou planilha (CSV, JSON, Parquet) ou Conectar um banco de dados (cadastra a conexão e volta) |
| 2 · O que trazer? | Banco: marque as tabelas (há busca). Arquivo: envie os arquivos e escolha Substituir pelo novo ou Juntar com os anteriores |
| 3 · Quando atualizar? | Só quando eu mandar, Todo dia, num horário (horário de Brasília) ou, para arquivo, Sempre que eu enviar um arquivo novo |
| 4 · Revisar e criar | Confere a frase-resumo e o Nome do pipeline |
No passo 4: Criar e rodar agora (cria, liga a atualização escolhida e já faz a primeira carga) ou Só criar. Ao final, a tela Pipeline criado! oferece Acompanhar a execução, Abrir o pipeline e Voltar para a lista.
O modo guiado traz a tabela inteira a cada execução. Carga só do que mudou,
transformações (Silver), partição, colunas sensíveis, alertas e ferramentas
(Google Sheets, Meta Ads, CRM) ficam no modo completo: link Usar o modo
completo no topo (/sources/new?modo=avancado). Novo relatório, na barra
da lista, também abre o modo completo.
Cadastrar a conexão antes de montar o pipeline#
O pipeline aponta para uma conexão salva; ele não guarda senha. No modo guiado, Conectar um banco de dados abre o assistente de quatro passos (Sistema, Endereço e senha, Testar, Pronto) e, ao salvar, você volta com a conexão já escolhida. Detalhes de cada campo em Telas de Conexões.
Criar um pipeline no modo completo#
- Em ETL/ELT → Pipelines, clique em Novo pipeline e depois em Usar o modo completo (ou em Novo relatório).
- Em O que você quer criar?, escolha Começar extração ou Criar relatório Gold.
- Percorra as seis etapas — Conexões, Dados, Carga, Transformações, Operação, Revisão — avançando por Continuar para Dados, Continuar para Carga e assim por diante.
- Na etapa Revisão, clique em Publicar pipeline. Ele fica desabilitado enquanto a revisão listar algum problema — o link Corrigir em "{etapa}" leva até ele.
- Depois, Executar agora faz a primeira carga; Ativar agenda liga o automático.
Publicar não carrega nada: cria a versão e deixa a agenda desativada.
Percorrer as seis etapas da montagem#
Conexões → Dados → Carga → Transformações → Operação → Revisão
| Etapa | O que você decide | Botão para avançar |
|---|---|---|
| 1 · Conexões | a conexão salva, em Suas conexões | Continuar para Dados |
| 2 · Dados | as tabelas, arquivos ou endpoints | Continuar para Carga |
| 3 · Carga | Full ou Append, e a Coluna-chave de controle | Continuar para Transformações |
| 4 · Transformações | as tabelas Silver e as dependências | Continuar para Operação |
| 5 · Operação | agenda, tentativas, limites e alertas | Continuar para Revisão |
| 6 · Revisão | confere tudo | Publicar pipeline |
Em qualquer etapa, Salvar rascunho guarda o que você montou — e o próprio botão explica o limite: "Guarda a montagem. Não publica, não executa, não liga agenda."
Escolher entre Full e Append (etapa 3)#
- Full — "Recarrega a tabela inteira a cada execução (substitui tudo)."
- Append — "Inclui só os dados novos a cada execução (incremental)." Pede uma Coluna-chave de controle: uma data ou sequência confiável.
O card Escrita no destino — efeito real mostra, antes de publicar, as linhas Escrita, Deduplicação, Histórico fora da janela, Deletes na origem e Mudança de schema. Comece com Full e valide o incremental depois.
Configurar a agenda na montagem (etapa 5)#
Em Agendamento do pipeline, o campo Modo tem duas opções: Agendado ("Roda em um horário fixo (diário ou D-1), com janela de reprocessamento.") e Por chegada de arquivo ("Executa assim que o arquivo chega na landing.").
Frequência é Diário ou D-1 (dia anterior), com Horário (Brasília) e Dias para retroagir (este último com o selo ainda não aplicado: fica registrado na execução, mas hoje não muda o que é carregado). O card Próximas cinco ocorrências mostra os próximos disparos, no horário de Brasília, antes de ligar nada.
Limites de execução — eles valem de verdade
Desde 03/10/2026, os quatro campos de Limites de execução mudam o que acontece na execução:
| Campo | O que acontece |
|---|---|
| Tentar de novo se falhar | Quantas vezes uma execução automática (da agenda) que falhou é repetida. 0 = não repete. |
| Espera entre retentativas (min) | Quanto esperar antes de tentar de novo. |
| Tempo limite (min) | Passou disso, a execução é encerrada como falha (conferido a cada 10 min). |
| Execuções simultâneas | Quantas execuções deste pipeline podem rodar ao mesmo tempo. 1 é o recomendado para carga que reescreve a tabela. |
Execução manual não se repete sozinha
As repetições valem para a agenda. Se uma execução que você mandou rodar falhar, use "Tentar de novo" na lista de Execuções. E com o limite de execuções simultâneas atingido, Executar agora é recusado com o motivo.
O card Notificações e responsáveis fecha a etapa: quem é avisado e quem é o responsável. Publicar não envia mensagem a ninguém — só a execução de verdade dispara e-mail.
Publicar o pipeline (etapa 6)#
O botão é Publicar pipeline (durante: "Publicando..."). 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."
Publicar, agendar e executar são três cliques diferentes
Publicado, aparece Pipeline publicado — versão {N} e, com ele, três ações separadas:
- Executar agora — "Dispara UMA execução. Não liga a agenda."
- Ativar agenda — "Liga o agendamento. Não executa nada agora."
- Abrir operação
Executar a primeira carga#
Use Executar agora, no painel que aparece logo depois de publicar ou na barra de operação do pipeline. Ativar agenda é outra decisão, para depois — e ativar a agenda não recupera o histórico.
Para acompanhar o que rodou, vá em ETL/ELT → Execuções (Telas de Execuções).
Publicar uma nova versão de um pipeline que já existe#
Na tela do pipeline, a barra de operação traz o selo Versão {N} publicada (ou Versão não registrada), o estado da agenda e o selo Mudanças não publicadas quando há o que publicar. As ações:
- Revisar e publicar — "Mostra origem, destino, escrita, agenda, limites e o que muda". Dentro da revisão, o botão final é Publicar versão {N+1} — ou Nada a publicar, quando nada mudou.
- Ativar agenda — vira Pausar agenda depois que você ligar
- Executar agora
Operar as cinco etapas da tela do pipeline#
| # | Etapa | O que ela mostra | Ação |
|---|---|---|---|
| 1 | Conexão | de onde os dados vêm | Abrir conexão |
| 2 | Agendamento | quando o pipeline roda | Editar |
| 3 | Camada Bronze | o dado cru, igual à origem | Ingerir ao vivo |
| 4 | Camada Silver / Camada Gold | o dado limpo / pronto para análise | Nova Silver · Nova Gold |
| 5 | Alertas e detalhes | quem é avisado quando roda | Editar |
Todo botão de ação vira Fechar enquanto a etapa está aberta.
Ingerir ao vivo não é Executar agora
Executar agora dispara a execução pela orquestração, com histórico e tentativas. Ingerir ao vivo roda a ingestão mostrando cada passo na tela: é para você ver acontecer, não para ser a operação do dia a dia.
Configurar tabela, watermark e alertas#
Na etapa 3, por tabela: Tipo de ingestão (Full (recarrega a tabela inteira) / Append (só inclui dados novos)), Coluna-chave (watermark), Coluna de partição (opcional), Clusterização (até 4 colunas — opcional) e Colunas técnicas (linhagem).
Na etapa 5: Nome da fonte *, Responsável, Descrição e o bloco Alertas por e-mail, com E-mails de sucesso e E-mails de FALHA separados — grava em Salvar detalhes.
Encontrar um pipeline na lista (/sources)#
Título Pipelines, subtítulo "Cada pipeline conecta uma fonte (banco, planilha ou plataforma) e a transforma em Bronze → Silver → Gold no seu datalake."
- Busca: "Buscar pipeline por nome…" · Filtro: Todos os tipos
- Contador: "{N} pipelines · {N} de extração · {N} relatórios Gold"
- Colunas: Pipeline · Status · Agenda · Última sync · Volume do mês · meta · Ações
Cada linha traz o selo de natureza — Extração ou Relatório Gold — e o status: Conectada, Pausada, Erro, Sincronizando ou Última execução com falhas. Sem nenhuma carga, a data diz Nunca sincronizada.
Lista vazia: Nenhuma fonte conectada + botão Conectar fonte. Filtro sem resultado: "Nenhum pipeline encontrado para esse filtro."
Mudar o horário de um pipeline que já existe#
Na tela do pipeline, o cartão Agendamento do pipeline tem o botão Editar agendamento. O Modo tem três opções:
- Só quando eu mandar rodar — sem agenda; use Executar agora
- Todo dia, num horário — com Frequência (Diário ou D-1 (dia anterior)), Horário (Brasília) e Dias para retroagir
- Quando chegar um arquivo novo — só para fontes de arquivo
Grave em Salvar agendamento. O cartão avisa o estado da chave: "Agenda LIGADA — salvar aqui muda o horário, não desliga nada." ou "Agenda DESLIGADA — nada roda automaticamente até você ativá-la…". Ligar e desligar é sempre no topo: Ativar agenda / Pausar agenda.
O que a agenda diz de si mesma#
| Selo | Quando aparece |
|---|---|
| Agenda ativa | há horário e a chave está ligada |
| Agenda pausada | há horário e a chave está desligada |
| Por evento | a frequência é Por chegada de arquivo |
| Manual | não há frequência nem horário — a chave ligada, sozinha, não cria agenda |
Voltar ao aplicativo#
- Pipelines: ETL/ELT → Pipelines
- Montar um: Novo pipeline
Próxima tarefa#
- Primeira ingestão — o tutorial
- Telas de Execuções — acompanhar o que rodou
- Publicar e versionar