Selo de estado:
Preview(teto atual do produto) · Curso ACD-210 — Conectores e conexões · Aula 1 de 8 · Atualizado em 2026-10-04.
Objetivo#
Ao final desta aula você vai diferenciar os 5 objetos — conexão, pipeline, versão, agenda e execução — e provar na tela que salvar uma conexão não inicia ingestão nenhuma.
Vídeo#
Identificador no manifesto: acd-210-01-conexao-vs-pipeline · duração-alvo 5 min · tela do produto: /conexoes.
Roteiro de gravação (5 capítulos):
| # | Minutagem-alvo | Capítulo | Tela do produto |
|---|---|---|---|
| 1 | 0:00–0:40 | Abertura: título + selo. A frase que a aula inteira defende: salvar não é executar. | /conexoes |
| 2 | 0:40–1:50 | Os cinco objetos, um a um, e onde cada um mora no menu. | /conexoes |
| 3 | 1:50–3:00 | A lista de conexões: os quatro estados independentes de uma linha. Uma conexão Ativa com Sem pipeline. | /conexoes |
| 4 | 3:00–4:10 | O pipeline aponta para a conexão; publicar cria a versão 1 com a agenda desligada. Três botões, três decisões. | /sources |
| 5 | 4:10–5:00 | A execução: onde ela aparece e por que ainda não existe nenhuma. O "faça você mesmo". | /dags |
Conteúdo#
Cinco objetos, cinco decisões
Cadastrar um acesso, definir o que ler, congelar essa definição, dizer quando rodar e rodar são cinco atos separados, cada um com o seu objeto e o seu clique. O produto não encadeia um no outro por conta própria.
Os cinco objetos
A separação não é vocabulário interno: ela aparece no menu, e Orquestração a resume assim.
| Objeto | O que é | Onde mora |
|---|---|---|
| Conexão | O acesso autorizado a uma origem: endereço, parâmetros e a credencial cifrada. | Dados → Conexões (/conexoes) |
| Pipeline | A definição do que ler, transformar e escrever. Aponta para uma conexão; nunca copia a credencial. | Orquestração → Pipelines (/sources) |
| Versão | A foto imutável da definição no momento da publicação. | Painel Publicação e agenda do pipeline |
| Agenda | A regra de quando executar. Gravada em UTC e exibida nos dois horários. | Cartão de agendamento do pipeline |
| Execução | Uma rodada concreta daquela versão, com tarefas, tentativas e logs. | Orquestração → Execuções (DAGs) (/dags) |
Leia a tabela de cima para baixo e você tem a ordem de trabalho do curso: as aulas 2 a 8 ficam todas na primeira linha. Conectar, aqui, é cadastrar acesso — e só.
O engano que esta aula desarma
Quem vem de outras ferramentas espera que "conectar" signifique "começar a trazer dados". Aqui não: cadastrar uma conexão não inicia ingestão nenhuma, não gera custo de nuvem e não cria pipeline. O painel lateral do passo Pronto do assistente afirma isso antes de você salvar ("Salvar não traz dados") — ver Conectar a primeira fonte.
Mais adiante a separação se repete: publicar 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 outras decisões, cada uma com o seu próprio botão. Três cliques, três consequências; nunca um atalho que faz os três de uma vez. E ativar a agenda não dispara recuperação histórica.
Os quatro estados de uma conexão
Na lista de /conexoes, cada linha mostra quatro fatos independentes. Confundi-los é a origem de quase todo "conectei e não veio dado":
| Estado | Valores possíveis |
|---|---|
| Cadastro | Rascunho · Ativa · Arquivada |
| Validação | Validada ✓ · Falhou no teste · Testando… · Validação obsoleta · Não testada |
| Credencial | configurada · expirada · revogada · inacessível · sem credencial |
| Última ingestão | OK · falhou · em execução · Nunca ingeriu · Sem pipeline |
Uma conexão pode estar Ativa, Validada ✓, com Credencial configurada e ainda assim dizer Sem pipeline — e isso está correto. É o estado normal de quem acabou de cadastrar o acesso. A ausência de teste também não é reprovação nem aprovação: é Não testada, um terceiro valor.
No workspace Aurora Varejo
João cadastra a conexão Vendas — demonstração apontando para um PostgreSQL sintético da Comércio Aurora e salva. A linha aparece assim: Ativa · Não testada · Credencial configurada · Sem pipeline. Em /dags não há execução nenhuma para procurar — não existe pipeline, logo não existe versão, logo não existe agenda, logo não existe execução. Quando João quiser linhas na Bronze, vai usar Montar extração no cartão da conexão, percorrer a régua do pipeline, publicar a versão 1 e só então escolher entre Executar agora e Ativar agenda.
A conexão é criada uma vez e reutilizada por quantos pipelines quiser. É por isso que trocar a senha em um lugar vale para todos: o pipeline guarda a referência da conexão, nunca uma cópia da credencial.
Erros comuns
| Sintoma | O que conferir | Próxima ação |
|---|---|---|
| "Salvei a conexão e não veio dado" | Coluna Última ingestão | Se diz Sem pipeline, é o comportamento esperado — monte o pipeline |
| "Publiquei e nada rodou" | Estado da agenda no painel de publicação | Comportamento esperado — use Executar agora ou Ativar agenda |
| "A senha mudou, vou recadastrar no pipeline" | Onde a credencial mora | Corrija na conexão, uma vez; todo pipeline que a aponta passa a usar o valor novo |
| "Ativei a agenda e o histórico não veio" | O que ativar agenda faz | Ativar agenda não recupera intervalo anterior |
| Não vejo Conexões no menu | Seu papel no workspace | Conexões, Pipelines e Execuções são áreas do dono |
O que esta aula não promete
O teto do produto é Preview: a extração real de uma fonte externa depende da credencial do cliente, e a execução real depende de o ambiente de nuvem do workspace estar configurado — sem ele a execução falha com mensagem, em vez de fingir sucesso. Executar também é ação cara: com a assinatura em atraso, suspensa ou cancelada, ela é bloqueada com link para Planos. Cadastrar, testar e salvar uma conexão: R$ 0.
Faça você mesmo#
No workspace de treino Aurora Varejo, como dono, com dados sintéticos (hosts *.example).
- Abra Dados → Conexões (
/conexoes) e leia uma linha existente nomeando em voz alta os quatro estados: cadastro, validação, credencial, última ingestão. - Use Nova conexão, escolha PostgreSQL e preencha a etapa Acesso com valores sintéticos: nome Vendas — treino ACD-210, host
db.aurora.example, porta5432, databasevendas, schemapublic, usuárioleitura_bi. - Na etapa Credencial, informe uma senha de treino e leia o texto ao lado do campo — ele diz para onde o valor vai e que ele não volta ao formulário.
- Pule a etapa Teste (ela é opcional). Em Revisão, leia o painel lateral até achar a frase de que salvar não inicia carga nenhuma e não cria pipeline.
- Use Salvar conexão. De volta à lista, confirme os quatro estados da nova linha: Ativa, Não testada, Credencial configurada, Sem pipeline.
- Abra Orquestração → Execuções (DAGs) (
/dags) e confirme que não existe nenhuma execução nova — nem com falha, nem com sucesso. - Volte ao cartão da conexão e localize o atalho Montar extração, sem clicar: é ali que o objeto seguinte (o pipeline) começaria.
Você terminou quando a conexão existe com Sem pipeline na coluna de última ingestão, você consegue explicar por que ela está Não testada sem que isso seja um erro, e /dags não ganhou nenhuma execução.
Checagem rápida#
Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.
Documentação relacionada#
- orquestracao/index
- primeiros-passos/primeira-fonte
- primeiros-passos/primeira-ingestao — o objeto seguinte: pipeline, versão e agenda
Capacidades ensinadas#
(conceitual — sem capacidade específica da matriz) — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".