Selo de estado:
Preview(limite atual do produto) · Atualizado em 2026-10-03. Esta página é inventário de interface: o que está escrito aqui é o texto que aparece na tela, literalmente. Para aprender a tarefa, vá em Conectar a primeira fonte.
Onde fica: menu ETL/ELT → Conexões.
Uma conexão é o acesso a um sistema (por exemplo, o banco do seu ERP), cadastrado uma vez e reutilizado em quantos pipelines você quiser. Ela só lê os dados — e cadastrar não traz nada: quem traz é o pipeline.
Encontrar uma conexão na lista (/conexoes)#
A lista se chama Suas conexões. Colunas: Nome · Sistema · Situação · Usada em · Ações.
| Você quer | Clique em |
|---|---|
| Cadastrar um acesso novo | Nova conexão (abre, no topo, a pergunta De qual sistema vêm os seus dados?) |
| Ver se o acesso ainda funciona | Testar (vira Testando… enquanto roda) |
| Abrir a ficha completa | Abrir conexão |
| Usar esta conexão num pipeline que você está montando | Usar conexão |
No menu Mais ações da conexão {nome}: Editar configuração, Substituir credencial, Usar num pipeline novo, Ver pipelines vinculados, Arquivar conexão e Apagar conexão.
Arquivar aparece desabilitado, e isso é de propósito
Arquivar conexão está no menu com o motivo declarado na própria tela: arquivar ainda não está disponível. O produto prefere dizer isso a esconder a ação e deixar você procurando.
Situação — uma resposta só
| Situação | O que quer dizer |
|---|---|
| Funcionando | O último teste entrou no sistema com os dados atuais |
| Com problema | O último teste falhou, ou a senha foi recusada/expirou |
| Nunca testada | Ainda não testamos se dá para entrar |
| Testar de novo | Os dados de acesso mudaram depois do último teste |
Conexões criadas dentro de um pipeline aparecem com o selo Só deste pipeline: elas não têm teste separado, e a situação vem da última execução do pipeline.
Filtros
Uma barra só: Buscar pelo nome · Todos os sistemas · a situação (Todas, Funcionando, Com problema, Nunca testada, Testar de novo — só aparecem as que existem na sua lista, com a contagem) · Limpar filtros.
Quando a lista está vazia
- Nenhuma conexão ainda: Conecte seu primeiro sistema + botão Nova conexão
- Filtro sem resultado: Nenhuma conexão com esses filtros + Limpar filtros
- Falha ao carregar: Não foi possível carregar suas conexões + Tentar novamente
No celular, a lista aparece em cartões.
Cadastrar uma conexão — o assistente de quatro passos (/conexoes/nova)#
Título Nova conexão (em edição: Editar conexão — {nome}). Quatro passos:
Sistema → Endereço e senha → Testar → Pronto
| Passo | Cabeçalho na tela | O que você faz |
|---|---|---|
| 1 | Onde estão os seus dados? | Escolhe o sistema (Postgres, MySQL, SQL Server, Oracle, BigQuery). Se você veio de um cartão do catálogo, este passo já vem feito |
| 2 | Endereço e senha do {Sistema} | Nome da conexão (já vem sugerido), Endereço do servidor, Porta (já vem a padrão), Nome do banco, Usuário e Senha. Cada campo tem uma linha de ajuda com exemplo |
| 3 | Vamos testar se dá para entrar | Clica em Testar agora |
| 4 | Tudo certo para salvar? | Confere e salva |
Opções avançadas (no passo 2, fechado) guarda o que só o TI costuma mexer: Schema, Segurança da conexão (SSL), Como chegamos ao banco (Direto pela internet, Túnel SSH (bastion), Cloud SQL (IP/Proxy), VPN (IP privado)) e os campos do túnel SSH. Já vem com o padrão seguro.
O resultado do teste é uma frase: Conexão funcionando ou Não conseguimos entrar, com o motivo e o que fazer (ex.: "O servidor não respondeu a tempo… peça ao seu TI para liberar o acesso"). O detalhe por etapa fica em Ver detalhes do teste (para o TI).
Rodapé: Voltar · Continuar (no passo do teste: Continuar sem testar ou Continuar mesmo assim) · Cancelar. O botão final é Salvar conexão — ou Salvar e usar no pipeline quando você chegou aqui de dentro da montagem de um pipeline.
Na edição de uma conexão salva, a senha não aparece: o passo 2 mostra Trocar a senha (e Manter a senha guardada para desistir).
Mudar o acesso pede um teste novo
Se você mudar algum dado, teste de novo: o resultado anterior não vale para o acesso novo.
Você pode salvar sem testar — a conexão fica como Nunca testada.
Configurar, testar e revogar uma conexão salva (/conexoes/salva/[id])#
Ações do topo: Usar num pipeline novo (ou Usar no pipeline, quando você veio da montagem) · Testar conexão · o menu Mais ações da conexão {nome}, que traz Editar configuração, Substituir credencial, Ver pipelines vinculados, Arquivar conexão, Apagar conexão e Revogar credencial.
Substituir e revogar não são a mesma coisa
Substituir credencial troca o segredo e mantém a conexão de pé. Revogar credencial apaga o segredo: a conexão continua cadastrada e para de funcionar até você informar outro. Todo pipeline que aponta para ela falha na próxima execução.
Três abas: Resumo · Pipelines vinculados ({N}) · Histórico.
O Resumo traz os painéis Configuração de acesso, Capacidades, Credencial, Credencial e cofre, Último teste, Teste pelo executor dos pipelines e Ingestão. Em Último teste, a linha que mais importa é Vale para a revisão atual? — é ela que diz se o teste que passou vale para o acesso que está gravado agora.
Logo depois de criar, a tela responde: "Conexão cadastrada. Nenhuma carga foi iniciada."
Consultar a ficha de uma fonte já ingerida (/conexoes/[id])#
Uma visão de leitura de uma fonte já ingerida: Detalhes da conexão ("Configuração desta fonte (somente leitura). Credenciais nunca são exibidas."), Tabelas ingeridas, Status (linhas Situação, Última execução, Categoria), a linha Modo de ingestão e o selo Credenciais criptografadas. As ações são Voltar e o ícone Editar {nome}.
Os quatro estados por trás da situação (para o TI)#
Na lista você vê UMA situação. Na ficha da conexão aparecem os quatro estados de onde ela vem:
| Dimensão | Valores possíveis |
|---|---|
| Cadastral | Ativa · Rascunho · Arquivada |
| Validação | Validada ✓ · Falhou no teste · Testando… · Validação obsoleta · Não testada |
| Credencial | Credencial configurada · Credencial expirada · Credencial revogada · Credencial inacessível · Sem credencial |
| Ingestão | Última ingestão OK · Última ingestão falhou · Ingestão em execução · Nunca ingeriu · Sem pipeline |
Como a própria tela diz: uma conexão Validada ✓ não significa que dados foram carregados, e um cadastro Ativa não significa que o teste passou.
Voltar ao aplicativo#
- Conexões: ETL/ELT → Conexões
- Cadastrar uma: Nova conexão
Próxima tarefa#
- Conectar a primeira fonte — o tutorial
- Telas de Pipelines — usar a conexão numa carga
- Credenciais e rotação