Selo de estado:
Preview(limite atual do produto) · Atualizado em 2026-10-03. Fonte de estado: matriz de estados do produto (SDK de conectores; conectores ERP/Ads/SaaS =Preview). A extração real de uma fonte externa depende de credencial do cliente e permanece Preview. Sem SLA.
O que você vai fazer#
Cadastrar o acesso a um sistema (por exemplo, o banco do seu ERP) e deixá-lo pronto para um pipeline. A conexão guarda o endereço e a senha (cifrada); o pipeline é quem traz os dados usando esse acesso.
O cadastro tem quatro passos, sempre nesta ordem:
| # | Passo | O que você faz nele |
|---|---|---|
| 1 | Sistema | Escolhe onde estão os seus dados (Postgres, MySQL, SQL Server, Oracle e outros bancos). |
| 2 | Endereço e senha | Preenche endereço do servidor, nome do banco, usuário e senha. O nome da conexão já vem sugerido. |
| 3 | Testar | Clica em Testar agora e lê o resultado numa frase. |
| 4 | Pronto | Confere e salva. A senha não aparece. |
O pipeline aponta para a conexão, não copia a senha
Trocar a senha em um lugar vale para todos os pipelines que usam a conexão.
Antes de começar#
- Entre na conta certa e confira a empresa/workspace mostrados no aplicativo.
- Você precisa ser dono do workspace: ETL/ELT → Conexões é área do dono.
- Escolha uma origem oferecida pelo
catálogo de conectores e leia a ficha dela. Um
conector em
Acesso limitadopode exigir habilitação; um item emPlanejadoainda não é uma conexão utilizável. - Peça ao responsável pela origem um acesso adequado à tarefa. Para ler dados, não peça permissões de administração do sistema.
- Número de conexões por plano: Starter 3 · Growth 10 · Business 30 · Scale 100 · Enterprise sob medida. Ver Planos.
- Cadastrar uma conexão não inicia ingestão nenhuma e não gera custo de nuvem.
Se você vai apenas enviar um arquivo, use o fluxo de importação — ver importar um arquivo. Um arquivo local não exige inventar uma senha nem criar um cofre.
Onde começa#
Em ETL/ELT → Conexões. Antes de criar, olhe a lista: se já existe uma conexão para o mesmo sistema, use ela. Cada conexão mostra uma Situação — Funcionando, Com problema, Nunca testada ou Testar de novo.
Use Nova conexão para abrir a escolha do sistema.
Passo 1 — Sistema#
Escolha onde estão os seus dados. Cada cartão diz, em uma linha, o que vamos pedir no passo seguinte. Se você chegou por um cartão do catálogo, este passo já vem feito.
Seus dados estão numa planilha? Não precisa de conexão: crie um pipeline e envie o arquivo direto.
Passo 2 — Endereço e senha#
Preencha o que o seu TI informou. Cada campo tem uma linha de ajuda com exemplo:
- Endereço do servidor — nome ou IP do servidor do banco.
- Porta — já vem a padrão; só mude se o TI disser que é outra.
- Nome do banco, Usuário (prefira um só de leitura, criado para o BI) e Senha.
O nome da conexão já vem sugerido (sistema + nome do banco); troque se quiser. Nunca coloque senha ou dado pessoal no nome.
Opções avançadas (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, Cloud SQL, VPN). Já vem com o padrão seguro.
A senha é guardada cifrada e nunca mais aparece na tela — nem para você. Para trocar depois, use Trocar a senha.
Se algo der errado aqui: o campo com problema fica em vermelho, com a explicação embaixo e um resumo no topo.
Passo 3 — Testar#
Clique em Testar agora. Tentamos entrar no sistema com os dados informados e listar as tabelas — nada é alterado no seu sistema.
O resultado é uma frase: Conexão funcionando (com quantas tabelas encontramos) ou Não conseguimos entrar, com o motivo e o que fazer — por exemplo, "O servidor não respondeu a tempo… peça ao seu TI para liberar o acesso". O detalhe por etapa (rede, usuário e senha, leitura) fica em Ver detalhes do teste (para o TI).
O teste é opcional: Continuar sem testar (ou Continuar mesmo assim, depois de uma falha) salva a conexão como Nunca testada.
Passo 4 — Pronto#
Confira os dados e salve. A senha não aparece, só se ela foi informada.
Use Salvar conexão. Se você veio da montagem de um pipeline, o botão é Salvar e usar no pipeline e você volta para lá com a conexão já escolhida. Cancelar não salva nada.
Salvar não traz dados: quem traz é o pipeline que usar a conexão.
Os quatro estados por trás da situação (para o TI)#
A lista mostra UMA situação. Na ficha da conexão aparecem os quatro fatos de onde ela vem — e uma conexão pode estar "Ativa" e nunca ter trazido nada:
| Estado | Valores possíveis |
|---|---|
| Cadastro | Rascunho · Ativa · 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 |
| Última ingestão | Última ingestão OK · Última ingestão falhou · Ingestão em execução · Nunca ingeriu · Sem pipeline |
Resultado esperado#
Você tem uma conexão identificável e autorizada; a credencial está cifrada e referenciada; a situação do teste corresponde ao que foi efetivamente verificado; o estado de ingestão diz Nunca ingeriu ou Sem pipeline — porque salvar não carrega dado nenhum.
Se algo der errado#
| Sintoma | O que conferir | Próxima ação |
|---|---|---|
| Rede falhou | Endereço, porta, modo de rede, allowlist | Libere o servidor da aplicação e o executor; valide com quem cuida da origem |
| Autenticação falhou | Método, validade e usuário escolhidos | Substitua ou reautorize a credencial conforme o conector |
| Autentica, mas leitura falhou | Permissões no schema/tabela específicos | Peça só o acesso necessário (somente leitura) |
| Leitura "Não testado" | Se o conector suporta essa verificação | Trate como não verificado, não como aprovado |
| O passo seguinte não abre | O resumo de erros no topo do passo atual | Corrija o campo em vermelho |
| Conector indisponível | Estado público na ficha do conector | Ver catálogo de conectores |
| Não vejo Conexões no menu | Seu papel no workspace | Conexões é área do dono; peça acesso ao dono |
| Atingi o limite de conexões | Limite do plano | Arquive uma conexão sem uso ou ver Planos |
Limites e custos#
- Cadastrar, testar e salvar: R$ 0 na plataforma. Alguns conectores externos cobram por chamada de API — confira a ficha do conector.
- O número de conexões é limitado pelo plano.
- Não publicamos tempo de cadastro nem de teste: depende da origem e da rede.
Voltar ao aplicativo#
- Cadastrar agora: Conexões → Nova conexão
- Ver as conexões já cadastradas: Conexões de dados
Próxima tarefa#
Crie o pipeline que vai usar esta conexão: Primeira ingestão. Na ficha da conexão, o atalho é Usar num pipeline novo.
Última revisão: 2026-10-03. 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 procedência de cada imagem
— arquivo, SHA-256, rota, commit, papel e revisão de privacidade — 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. Nenhum dado,
nome ou credencial de cliente aparece nesta documentação.