Documentação do Lumo
Buscar K

Aparência

Abrir no Claude Abrir no ChatGPT

Cadastrar uma conexão de banco ​

Tipo
Como fazer
Para
Engenharia de dados
Na tela
HorusETL › Conexões

Uma conexão guarda o endereço e as credenciais de um banco de origem, para que os Dataflows leiam dele sem ninguém digitar senha dentro de um nó. Cadastre uma por banco, no Agente ETL que enxerga esse banco.

Antes de começar ​

  • O Agente ETL que vai usar a conexão precisa estar online e alcançar o banco. A conexão é criada no Agente escolhido no topo da tela.
  • Tenha em mãos host, porta, usuário, senha e nome do banco. Para a sonda CDC e a sincronização de exclusões, prefira um usuário só de leitura.

Passos ​

  1. No topo do HorusETL, confira o Agente ETL.
  2. Abra Conexões. Abre a tela Gerenciar Conexões.
  3. Clique em Criar nova Conexão e escolha o Tipo de banco: MySQL, SQL Server, OracleDB, PostgreSQL, Firebird, ODBC, InterSystems IRIS, Google BigQuery ou IBM Informix.
  4. Em Nome da conexão, escreva o nome que vai aparecer nos Dataflows, por exemplo ERP Produção.
  5. Preencha os campos do banco. Os campos e a porta padrão de cada tipo estão em Bancos de dados.
  6. No painel Teste de conexão, clique em Testar conexão e espere o resultado Conectou.
  7. Clique em Salvar.

A conexão passa a aparecer no grupo Bancos de Dados da paleta do editor, para os Dataflows desse Agente. A senha fica guardada cifrada no Lumo.

Quem vê a conexão ​

A conexão nasce Liberado para todos: qualquer usuário do Tenant que monta Dataflows a vê e usa. Para restringir, um administrador troca a liberação no HEC pelos Grupos e Usuários que podem usar. Os administradores veem todas. Ver Conexões de dados no HEC.

Ver o uso ​

Abra a conexão pela lista, em Editar. O painel Uso mostra quantos Dataflows usam a conexão, separados entre publicados e Minha Mesa.

Trocar o tipo de banco ​

Use quando o banco de origem mudou de tecnologia, por exemplo de SQL Server para Firebird, e você quer que todos os Dataflows acompanhem.

  1. Na tela Editar Conexão, clique em Trocar tipo de banco.
  2. Confirme o aviso: "Os dados de conexão desta tela serão apagados para preencher no tipo novo."
  3. Escolha o tipo novo, preencha os campos, teste e salve.

Os nós de todos os Dataflows que usam a conexão, publicados e em Minha Mesa, passam para o tipo novo. O SQL não é traduzido. Confira as consultas no banco novo, ou escreva uma versão por tipo de banco no nó, em Editar Consulta SQL › SQL para outro banco (Agente ETL 1.29.11 ou mais novo).

Mover Dataflows para outra conexão ​

Use para que os Dataflows passem a ler de outra conexão do mesmo Agente, por exemplo para trocar o banco de homologação pelo de produção. A conexão de origem continua salva, sem uso.

  1. Abra a conexão de origem e clique em Mover flows para outra conexão.
  2. Em Mover para, escolha a conexão de destino. Aparecem só conexões do mesmo Agente ETL e de tipo compatível.
  3. Marque os Dataflows, ou use Selecionar todos.
  4. Clique no botão Mover, que mostra quantos flows vão mudar (por exemplo, Mover 3 flows).

Os nós que usam a conexão de origem passam a usar a de destino, nos Dataflows publicados e em Minha Mesa. Se o destino é de outro tipo de banco, a tela avisa "O tipo dos nós muda" e os nós assumem o tipo novo. A consulta de chaves da sincronização de exclusões acompanha a troca. Os nós com Conexão por variável não mudam: para esses, troque o valor da variável.

Dataflows abertos no editor durante a troca precisam ser recarregados.

Trazer Dataflows de uma conexão excluída ​

Quando uma conexão é excluída, os Dataflows que a usavam ficam sem conexão. Ao abrir outra conexão do mesmo Agente, a tela avisa "Há flows deste Agente ETL usando uma conexão que não existe mais." Clique em Trazer para esta conexão para religá-los.

Levar a conexão para outro Agente ​

No painel Agente ETL da conexão, clique em Transferir e escolha o Agente de destino. Faça isso junto com a transferência dos Dataflows, para que conexão e Dataflows fiquem no mesmo Agente; ver Manter o Agente ETL.

Escolher a conexão na hora da execução ​

No nó de banco, ligue Conexão por variável e escreva em Variável a usar o nome de uma variável que contém a string de conexão. Uma lista separada por vírgula faz o nó rodar a mesma consulta em cada banco e juntar os resultados; vírgula dentro de um valor se escreve \,. A variável costuma vir de um Configurador; ver Calcular variáveis na hora da execução.

Se der errado ​

O teste mostra Não conectou. O Agente ETL não alcança o banco, ou a credencial está errada. A mensagem do teste diz qual; ver Problemas.

"Não há outra conexão compatível neste Agente ETL. Crie a conexão de destino primeiro." A tela de mover só oferece conexões do mesmo Agente e de tipo compatível. Crie a de destino e volte.

A conexão não aparece no editor. O editor está em outro Agente ETL, ou a conexão não está liberada para você. Confira o Agente no topo da tela.

Relacionado ​

Pelo Lumo CLI

Este recurso também pode ser criado e versionado em YAML. Veja a referência de credential.