Sistema, Endereço e senha, Testar, Pronto

Selo de estado: Preview (teto atual do produto) · Curso ACD-210 — Conectores e conexões · Aula 3 de 8 · Atualizado em 2026-10-05.

Objetivo#

Ao final desta aula você vai executar os 4 passos; interpretar os 4 estados — percorrendo a régua do assistente e lendo o resultado do teste capacidade por capacidade.

Vídeo#

Identificador no manifesto: acd-210-03-assistente-de-conexao · duração-alvo 8 min · tela do produto: /conexoes.

Roteiro de gravação (5 capítulos):

Conteúdo#

A régua do assistente fica visível o tempo todo e tem quatro passos. A trava é de propósito, e é mais estreita do que parece: Testar e Pronto só abrem depois que Endereço e senha está válido — nome preenchido e todos os campos obrigatórios, inclusive a senha. A fonte desta aula é Conectar a primeira fonte.

Passo 1 — Sistema: só banco de dados entra por aqui

A pergunta na tela é "Onde estão os seus dados?", e o subtítulo já declara o contrato: "A conexão só LÊ os dados do seu sistema — nada é alterado lá. Ela pode ser usada em vários pipelines."

O catálogo deste passo é só de bancos de dados com leitura real — na medição de 2026-10-05, 13 cartões, incluindo o BigQuery do cliente (aula 5). Há uma busca por nome, e cada cartão traz três coisas: o logo, o selo de disponibilidade quando o estado não é "Disponível" (com a legenda no título, exatamente como a aula 2 ensina a ler) e uma linha dizendo o que vai ser pedido no passo seguinte — "Vamos pedir: endereço do servidor, nome do banco, usuário e senha." Duplo clique no cartão já avança.

Dois avisos que a própria tela dá:

• Arquivo não passa por aqui. O rodapé diz: "Seus dados estão numa planilha ou arquivo (CSV, Excel, JSON)? Não precisa de conexão —" e leva para crie um pipeline e envie o arquivo. É a aula 6.
• Editando uma conexão existente, o sistema fica travado: "O sistema de uma conexão existente não pode ser trocado: crie outra conexão."

Passo 2 — Endereço e senha: o nome importa, e a senha é deste passo

O título é "Endereço e senha do {sistema}" e o subtítulo, "Preencha o que o seu TI informou. Os campos com * são obrigatórios."

Use um nome que identifique finalidade e ambiente, como Vendas — demonstração; o produto já sugere um (o nome do sistema) e a dica embaixo diz "Um nome para você reconhecer depois (ex.: 'Banco do ERP')." Nunca coloque senha, token ou dado pessoal no nome. Erro de validação aparece no campo, em vermelho, e num resumo no topo da tela — uma lista clicável que leva direto ao campo.

A senha vive neste passo, num bloco próprio com ícone de cadeado, intitulado Senha (ou Chave de acesso, no BigQuery), logo abaixo dos campos de endereço. É a mudança que encurtou a régua. O painel lateral diz o que acontece com ela: "Ela é guardada cifrada e nunca mais aparece na tela — nem para você."

Quando você edita uma conexão que já tem senha guardada, o bloco não mostra campo nenhum: mostra "Já existe uma senha guardada (ela não aparece por segurança)" e o botão Trocar a senha — que exige permissão de administração de conexões no workspace. Ao trocar, o texto muda para "Digite a nova senha abaixo." e aparece Manter a senha guardada, que descarta o que você digitou e apaga o resultado do teste anterior: um teste bem-sucedido com a senha velha não valida a nova.

Opções avançadas é um bloco fechado, com o padrão seguro já preenchido — schema, sslmode/encrypt, modo de rede (direto ou túnel SSH), protocolo do Oracle e, no BigQuery, modo de cobrança, projeto de cobrança e região. Ele abre sozinho quando algum campo de dentro está com erro. Se você mudar qualquer dado depois de um teste, a tela avisa: "Se você mudar algum dado aqui, teste de novo no próximo passo."

Passo 3 — Testar: opcional, e honesto sobre o que prova

O título é "Vamos testar se dá para entrar", e antes do clique a tela declara o destino: "Tentamos acessar <o servidor> com os dados que você informou e listar as tabelas. Nada é alterado no seu sistema." Testar agora depende de permissão de operação no workspace.

O resultado chega como uma frase: Conexão funcionando (com quantas tabelas encontramos), Não conseguimos entrar (com o motivo) ou Teste desatualizado ("Você mudou algum dado depois deste teste. Teste de novo."). O detalhe fica em Ver detalhes do teste (para o TI), e é lá que o resultado se abre por capacidade, nunca como um "ok" único:

Cada uma sai como OK, Falhou, Não testado ou Não suportado — e "Não suportado" nunca conta como sucesso. Junto vêm o horário do teste com fuso e a ressalva de onde o teste roda: "As execuções agendadas saem de outra máquina da nossa nuvem (o executor dos pipelines): este teste NÃO garante que ela também entra." Um verde aqui não prova que a carga agendada alcança o mesmo servidor — é a razão de a aula 4 insistir em liberar as duas redes. A escrita não é testada: o teste não escreve nada, e leitura bem-sucedida não vale como escrita validada.

Pular o teste é legítimo: o botão do rodapé vira Continuar sem testar (ou Continuar mesmo assim, depois de uma falha) e a conexão fica Nunca testada. Mas ausência de teste não é aprovação — e "Listagem-leitura: Não testado" deve ser tratado como não verificado, nunca como verde.

Passo 4 — Pronto: o que é salvo, e o que não é

"Tudo certo para salvar?" · "Confira os dados. A senha não aparece por segurança." No topo, um selo diz em que pé está a verificação: Teste passou, Teste falhou ou Ainda não testada.

O resumo mostra a configuração de acesso e uma linha sobre a credencial — Senha informada (será guardada cifrada), Senha guardada mantida ou Sem senha. Nenhum valor de credencial aparece aqui, nem mascarado. Dois atalhos levam de volta: Corrigir algum dado (para Endereço e senha) e Testar agora / Testar de novo, oferecido sempre que o teste vigente não passou.

O botão é Salvar conexão — ou Salvar e usar no pipeline, quando você veio de um rascunho de pipeline: salvar devolve você para a mesma montagem, com a conexão já selecionada. Salvar exige permissão de administração de conexões. E salvar não é executar: o painel lateral declara "Salvar não traz dados" — depois de salvar, use a conexão num pipeline para trazer os dados. Cancelar não salva nada: volta para /conexoes (ou para o pipeline, sem perder o que você já montou) e não deixa conexão nenhuma para trás.

No workspace Aurora Varejo

João cadastra Vendas — demonstração com um PostgreSQL sintético (db.aurora.example). O teste volta Não conseguimos entrar; abrindo Ver detalhes do teste (para o TI), ele lê Conectividade: Falhou — o host sintético não existe — enquanto Autenticação e Listagem-leitura ficam Não testado, porque sem rede não há o que autenticar. Ele usa Continuar mesmo assim e salva: a conexão entra como Ativa · Falhou no teste · Credencial configurada · Sem pipeline. Lendo as três capacidades separadas, João sabe exatamente onde agir: firewall e endereço, não senha.

Erros comuns

Faça você mesmo#

No workspace de treino Aurora Varejo, como dono, com dados sintéticos.

1. Em /conexoes, use Nova conexão e confirme na régua que são quatro passos: Sistema · Endereço e senha · Testar · Pronto. Escolha PostgreSQL no passo Sistema e, antes de avançar, leia a linha do cartão que diz o que vai ser pedido.
2. No passo Endereço e senha, preencha: nome Vendas — treino passo a passo, host db.aurora.example, porta 5432, database vendas, usuário leitura_bi e uma senha de treino. Abra Opções avançadas e confirme que schema, SSL e modo de rede já vêm com padrão seguro.
3. Apague o nome de propósito e tente avançar: confirme que o passo não destrava, que o erro aparece no campo e no resumo do topo, e que o item do resumo leva até o campo quando clicado. Depois corrija.
4. Ainda no passo 2, localize o bloco da senha e transcreva a frase do painel lateral que diz o que acontece com ela depois de salva.
5. No passo Testar, antes de clicar, anote o destino do teste que a tela declara. Então use Testar agora, abra Ver detalhes do teste (para o TI) e registre o resultado das três capacidades — esperado: Conectividade: Falhou, as outras Não testado. Transcreva a ressalva sobre o executor dos pipelines.
6. No passo Pronto, confirme que nenhum valor de credencial aparece, nem mascarado — só a linha que diz que a senha foi informada e será guardada cifrada —, e localize os atalhos Corrigir algum dado e Testar de novo.
7. Use Salvar conexão e leia a linha na lista: os quatro estados devem ser Ativa, Falhou no teste, Credencial configurada, Sem pipeline.
8. Abra a conexão salva, volte ao passo Endereço e senha e localize Trocar a senha; leia o aviso de que o teste anterior deixa de valer.

Você terminou quando você percorreu os quatro passos, viu a régua travar com o passo 2 inválido, tem os três resultados por capacidade anotados separadamente e sabe dizer por que Falhou no teste não impediu o salvamento.

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#

• primeiros-passos/primeira-fonte
• suporte/troubleshooting-conexao-credenciais — sintoma → causa quando o teste falha

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".