Para acessar a página Conexões, abra o menu Administrador e, em Banco de dados, escolha Conexões.
Como visualizar conexões
Na página Conexões, é possível ver as conexões de banco de dados e os endereços IP necessários para permitir o tráfego de rede. Se a capacidade de criar um novo banco de dados foi ativada para sua instância, você também pode adicionar uma nova conexão.
Guia "Bancos de dados"
A guia Bancos de dados mostra informações básicas sobre as conexões de banco de dados que você definiu. Ele também mostra todas as conexões gerenciadas pelo Looker que você criou, caso a capacidade de criar um novo banco de dados tenha sido ativada na instância. Também é possível testar o status e editar a configuração dessas conexões na guia Bancos de dados.
Clique em Endereços IP públicos para conferir a lista de endereços IP necessários para permitir o tráfego de rede da sua instância do Looker. Todo o tráfego de rede do Looker vem de um dos endereços IP listados com base na região em que sua instância do Looker está hospedada. Proibir o tráfego para seu banco de dados, exceto desses e de outros endereços IP confiáveis, é uma forma de limitar o acesso aos dados.
A tabela a seguir descreve os elementos da guia Bancos de dados:
| Coluna | Descrição |
|---|---|
| Nome | O nome da conexão, escolhido por você, que é usado no parâmetro LookML connection. Quando você testa a conexão, o Looker mostra a lista de verificações de status abaixo do nome da conexão. |
| Banco de dados | O nome do banco de dados que o Looker vai consultar ao usar essa conexão. |
| Escopo | Se a conexão pode ser usada com todos os projetos ou apenas um projeto específico. |
| Servidor SSH | O nome da configuração do servidor SSH usado para criar um túnel SSH para seu banco de dados. Essa coluna é exibida somente se a guia Servidores SSH estiver ativada na instância do Looker. |
| SSL | Se você usa ou não a criptografia SSL para proteger os dados transmitidos entre o Looker e seu banco de dados (existem outras opções seguras além do SSL). |
| Tipo | O dialeto SQL da conexão do banco de dados. |
| Ações | Ações que você pode realizar em relação a uma conexão: testar, editar uma conexão, conferir outras informações, acessar uma lista de links para as Análises da conexão ou excluir uma conexão. Se a capacidade de criar um novo banco de dados tiver sido ativada para sua instância, você também poderá adicionar dados de outra fonte de dados a qualquer conexão gerenciada pelo Looker. |
Guia "Servidores SSH"
A opção Servidor SSH estará disponível se a instância estiver implantada na infraestrutura do Kubernetes e somente se a capacidade de adicionar informações de configuração do servidor SSH à sua instância do Looker estiver ativada. Se essa opção não estiver ativada na sua instância do Looker e você quiser ativá-la, entre em contato com um especialista em vendas do Google Cloud ou abra uma solicitação de suporte.
O Looker escolhe automaticamente a porta do host local para você ao criar túneis SSH. Não é possível especificar essa porta.
As conexões SSH com bancos de dados PrestoDB ou Trino podem exigir configuração de banco de dados adicional. Quando o SSL está ativado, o banco de dados do PrestoDB ou do Trino detecta por padrão a porta 443. Para estabelecer o túnel SSH, o Looker precisa definir a porta do host local como 443, que já está em uso pelo Looker. Isso fará com que a configuração do túnel SSH falhe. Para corrigir o problema, configure o banco de dados do PrestoDB ou do Trino para detectar em uma porta diferente da 443 quando o SSL estiver ativado.
A guia Servidores SSH lista as configurações do servidor SSH que você adicionou, indica o status das conexões com os servidores SSH e lista as conexões de banco de dados usando cada servidor SSH. Na guia Servidores SSH, também é possível testar uma conexão com um servidor SSH e adicionar ou editar as configurações dele.
A tabela a seguir descreve os elementos da guia Servidores SSH:
| Coluna | Descrição |
|---|---|
| Nome do servidor | O nome da configuração do servidor SSH, escolhida por você, que é usado para se conectar ao seu banco de dados. |
| Conexões | Uma lista das conexões de banco de dados que se conectam ao servidor SSH. Clicar em uma conexão de banco de dados abre a página Editar conexão referente a ela. |
| Menu Opções de três pontos | Ações que você pode realizar para uma configuração de servidor SSH: testar conexões com um servidor SSH, adicionar uma conexão de banco de dados a um servidor SSH, editar uma configuração de servidor SSH ou excluir uma configuração de servidor SSH. |
Adicionar ou editar uma configuração de servidor SSH
Para adicionar uma nova configuração de servidor SSH:
- Na guia Servidor SSH, clique em Adicionar servidor.
- No campo Servidor sem nome, no canto superior direito, digite um nome para a configuração do servidor SSH.
- Clique em Fazer o download da chave para fazer o download da chave pública em um arquivo de texto. Não se esqueça de salvar esse arquivo para uso posterior.
- No campo Nome de usuário do servidor, digite o nome de usuário que o Looker usará para se conectar ao servidor SSH.
- No campo Endereço IP ou nome do host do servidor, digite o endereço IP ou o nome do host do servidor SSH.
- No campo Porta do servidor, digite o número da porta usado para se conectar ao servidor SSH.
- Adicione a chave pública baixada ao arquivo de chave autorizada no servidor SSH. Consulte a página de documentação Como usar um servidor SSH para mais informações e um exemplo.
- Verifique se os endereços IP do Looker foram adicionados à lista de permissões no seu servidor SSH para que o Looker possa se conectar a ele.
- Clique em Testar e solicitar impressão digital para verificar sua conexão com o servidor SSH.
- Veja a nova configuração de SSH. Nessa tela, também é possível fazer o download ou acessar a chave pública e conferir a impressão digital exclusiva da configuração do servidor SSH.
Para editar uma configuração de servidor SSH, clique no menu de três pontos Opções na linha do servidor SSH selecionado e escolha Detalhes do servidor.
Testar as conexões com um servidor SSH
Para testar todas as conexões de banco de dados com um servidor SSH:
- Clique no menu de três pontos Opções na linha do servidor SSH escolhido.
- Selecione Testar conexões.
O Looker vai testar todas as conexões de banco de dados usando esse servidor SSH e mostrar uma marca de seleção verde ao lado do nome do servidor e de todas as conexões em que o teste de conexão é aprovado. Um ícone de ponto de exclamação vermelho indica que a conexão falhou no teste.
Adicionar uma conexão de banco de dados a um servidor SSH
Para adicionar uma nova conexão de banco de dados usando um servidor SSH:
- Clique no menu de três pontos Opções na linha do servidor SSH escolhido.
- Selecione Adicionar conexão.
O Looker mostra a página Configurações de conexão com o servidor SSH no campo Servidor SSH.
Como excluir uma configuração de servidor SSH
Para excluir uma configuração do servidor SSH:
- Clique no menu de três pontos Opções na linha do servidor SSH que você quer excluir.
- Selecione Excluir servidor.
Como testar conexões
O Looker permite testar as conexões atuais para garantir o funcionamento correto delas. Também é possível testar as conexões à medida que são adicionadas, conforme descrito na página de documentação Como conectar o Looker ao banco de dados.
Cada teste de conexão inclui uma lista de verificações de status para informar se o Looker consegue usar a conexão do banco de dados.
Os possíveis problemas são mostrados em amarelo, e os erros são mostrados em vermelho. Se uma conexão for "aprovada", ela aparecerá em verde.
As conexões de banco de dados que usam OAuth, como o Snowflake e o Google BigQuery, exigem um login de usuário. Se você não tiver feito login na sua conta de usuário do OAuth ao testar uma dessas conexões, o Looker vai mostrar um aviso com um link Fazer login. Clique no link para inserir suas credenciais do OAuth ou permitir que o Looker acesse as informações da sua conta OAuth.
É possível verificar o status de:
- uma única conexão clicando em Testar à direita dessa conexão;
- Todas as conexões clicando no botão Testar todas as conexões na parte superior da página
Duas verificações costumam causar confusão:
- É possível encontrar o esquema temporário
- Podem usar tabelas derivadas persistentes
Essas verificações não precisam ser aprovadas para que o Looker funcione. No entanto, você precisa que elas sejam transmitidas para usar tabelas derivadas persistentes, que são um recurso de modelagem muito valioso.
Adicionar contatos
Para adicionar uma nova conexão de banco de dados, siga as etapas descritas na página de documentação Como conectar o Looker ao banco de dados.
Como editar conexões
Para editar uma conexão, abra a página Conexões selecionando o menu Administrador e, em Banco de dados, escolha Conexões. Clique no botão Editar da conexão. A mesma página que você usou para criar uma conexão vai aparecer (descrita na página de documentação Como conectar o Looker ao banco de dados), mas com as informações relevantes já preenchidas. Faça as alterações necessárias e clique em Atualizar conexão.
Ações disponíveis para todas as conexões
Todas as conexões oferecem estas opções no menu suspenso de engrenagem à direita de cada conexão:
| Opção | Descrição |
|---|---|
| SQL Runner | Essa opção leva você ao SQL Runner do Looker, com a conexão e o esquema adequados já selecionados. |
| Conheça o | Essa opção mostra uma lista de opções básicas do recurso Explorar, geradas automaticamente para sua conexão. Elas não são baseadas nos seus modelos de dados personalizados, mas permitem alguns relatórios rápidos sobre os dados brutos nas tabelas da sua conexão. Isso normalmente é útil apenas para se ter uma ideia do conteúdo da tabela antes da modelagem, e não para os propósitos de uma análise de dados real. |
| Excluir | Para excluir uma conexão, clique no menu suspenso de engrenagem à direita de uma conexão e selecione Excluir. Você poderá confirmar a exclusão, mas ela não poderá ser desfeita. A exclusão acidental de uma conexão desativará todas as consultas que a utilizam. No entanto, se você recriar uma nova conexão com o mesmo nome, a funcionalidade será restaurada. |
Ações disponíveis para algumas conexões
Dependendo do dialeto da conexão, o menu suspenso de engrenagem à direita da conexão pode oferecer as seguintes opções adicionais:
| Opção | Descrição |
|---|---|
| Mostrar tabelas | Essa opção leva você a uma página "Explorar" do Looker, onde é possível criar relatórios do Looker com base nos metadados da sua conexão. Essa opção começa com o nome do esquema, o nome da tabela e a contagem de colunas selecionados, mas é possível manipulá-lo como qualquer outro relatório do Looker. |
| Mostrar bancos de dados | Essa opção leva você a uma página "Explorar" do Looker, onde é possível criar relatórios do Looker com base nos metadados da sua conexão. Essa opção começa com o nome do esquema, o nome do catálogo, o número de tabelas e de colunas selecionados, mas é possível manipulá-lo como qualquer outro relatório do Looker. |
| Mostrar processos | Essa opção abre uma página de Análise do Looker que permite criar relatórios do Looker com base nos processos em execução nessa conexão, no estado em que estão, há quanto tempo estão em execução e outras informações. Isso pode ser útil para determinar a causa da lentidão no Looker ou se uma consulta não está sendo executada. |
| Mostrar log de eventos da TDP | Essa opção abre uma página "Análise" do Looker que permite criar relatórios do Looker com base na atividade da tabela derivada para essa conexão. Os campos disponíveis são descritos com mais detalhes na página de documentação Tabelas derivadas persistentes. |