Configurações de administrador: conexões

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 conferir 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 banco de dados estiver ativada para sua instância, você também poderá 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 definidas. Ele também mostra as conexões gerenciadas pelo Looker que você criou, se a capacidade de criar um novo banco de dados estiver ativada para sua 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 virá 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 maneira de limitar o acesso aos dados.

A tabela a seguir descreve os elementos na guia Bancos de dados:

Coluna Descrição
Nome O nome da conexão, escolhido por você, que é usado no parâmetro connection do LookML. Ao testar 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 específico.
Servidor SSH O nome da configuração do servidor SSH usada para criar um túnel SSH para seu banco de dados. Essa coluna só aparece se a guia Servidores SSH estiver ativada na sua instância do Looker.
SSL Se você está usando ou não a criptografia SSL para proteger os dados que viajam entre o Looker e seu banco de dados. Além do SSL, há outras opções seguras.
Tipo O dialeto SQL da conexão de banco de dados.
Ações Ações que você pode realizar em uma conexão: testar, editar, ver outras informações, acessar uma lista de links para as análises detalhadas da conexão ou excluir uma conexão. Se a capacidade de criar um novo banco de dados estiver ativada para sua instância, você também poderá adicionar dados de outra fonte a qualquer conexão gerenciada pelo Looker.

Guia "Servidores SSH"

A guia Servidores SSH não está disponível para instâncias do Looker (Google Cloud Core).

A opção Servidor SSH estará disponível se uma instância do Looker (original) for implantada na infraestrutura do Kubernetes e somente se a opção 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 Google Cloud especialista em vendas ou abra uma solicitação de suporte.

O Looker escolhe automaticamente a porta localhost para você ao criar túneis SSH. Não é possível especificar a porta localhost.

As conexões SSH com bancos de dados PrestoDB ou Trino podem exigir configuração adicional do banco de dados. Quando o SSL está ativado, o banco de dados PrestoDB ou Trino passa a escutar na porta 443 por padrão. Para estabelecer o túnel SSH, o Looker precisa definir a porta localhost como 443, que já está em uso pelo Looker. Isso vai causar uma falha na configuração do túnel SSH. Para corrigir o problema, configure seu banco de dados PrestoDB ou Trino para detectar em uma porta diferente da 443 quando o SSL estiver ativado.

A guia Servidores SSH lista as configurações de 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 configurações de servidor SSH.

A tabela a seguir descreve os elementos na guia Servidores SSH:

Coluna Descrição
Nome do servidor O nome da configuração do servidor SSH, escolhido por você, que é usado para se conectar ao banco de dados.
Conexões Uma lista das conexões de banco de dados que se conectam ao servidor SSH. Ao clicar em uma conexão de banco de dados, a página Editar conexão é aberta.
Menu de três pontos Opções Ações que podem ser realizadas 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:

  1. Na guia Servidor SSH, clique em Adicionar servidor.
  2. No campo Servidor sem nome no canto superior direito, insira um nome para a configuração do servidor SSH.
  3. Clique em Baixar chave para salvar a chave pública em um arquivo de texto. Salve esse arquivo para uso posterior.
  4. No campo Nome de usuário do servidor, digite o nome de usuário que o Looker vai usar para se conectar ao servidor SSH.
  5. No campo Endereço IP ou nome do host do servidor, insira o endereço IP ou o nome do host do servidor SSH.
  6. No campo Porta do servidor, insira o número da porta usado para se conectar ao servidor SSH.
  7. Adicione a chave pública baixada ao arquivo de chaves autorizadas no seu servidor SSH. Consulte a página de documentação Usar um servidor SSH para mais informações e um exemplo.
  8. Verifique se os endereços IP do Looker apropriados foram adicionados à lista de permissões no servidor SSH para que o Looker possa se conectar a ele.
  9. Clique em Testar e solicitar impressão digital para verificar sua conexão com o servidor SSH.
  10. Confira a nova configuração do SSH. Nessa tela, também é possível fazer o download ou conferir a chave pública e 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.

Como testar as conexões com um servidor SSH

Para testar todas as conexões de banco de dados com um servidor SSH:

  1. Clique no menu de três pontos Opções na linha do servidor SSH escolhido.
  2. Escolha 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 for aprovado. Um ícone de ponto de exclamação vermelho indica que a conexão não passou no teste.

Como 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:

  1. Clique no menu de três pontos Opções na linha do servidor SSH escolhido.
  2. Escolha Adicionar conexão.

O Looker mostra a página Configurações de conexão, com o servidor SSH listado no campo Servidor SSH.

Como excluir uma configuração de servidor SSH

Para excluir uma configuração de servidor SSH:

  1. Clique no menu de três pontos Opções na linha do servidor SSH que você quer excluir.
  2. Escolha Excluir servidor.

Como testar conexões

O Looker permite testar suas conexões atuais para garantir que elas estejam funcionando corretamente. Você também pode testar as conexões à medida que as adiciona, conforme descrito na página de documentação Conectar o Looker ao seu banco de dados.

Cada teste de conexão inclui uma lista de verificações de status para informar se o Looker pode usar a conexão de banco de dados.

Os possíveis problemas são mostrados em amarelo, e os erros, em vermelho. Se uma conexão for aprovada, ela vai aparecer em verde.

As conexões de banco de dados que usam OAuth, como Snowflake e Google BigQuery, exigem um login do usuário. Se você não estiver conectado à 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 do OAuth.

É possível verificar o status de:

  • Uma única conexão clicando em Testar à direita dela
  • Todas as conexões clicando no botão Testar todas as conexões na parte de cima da página

Duas verificações são causas comuns de confusão:

  • Pode encontrar o esquema de temperatura
  • Pode usar tabelas derivadas persistentes

Essas verificações não precisam ser aprovadas para que o Looker funcione. No entanto, elas são necessárias para usar tabelas derivadas permanentes, que são um recurso de modelagem muito valioso.

Como adicionar conexões

Para adicionar uma nova conexão de banco de dados, siga as etapas descritas na página de documentação Conectar o Looker ao seu banco de dados.

Como editar conexões

Para editar uma conexão, abra a página Conexões. Para isso, selecione o menu Administrador e, em Banco de dados, escolha Conexões. Clique no botão Editar da conexão. A mesma página usada para criar uma conexão vai aparecer (descrita na página de documentação Conectar o Looker ao seu banco de dados), mas com as informações relevantes já preenchidas. Faça as mudanças 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, no canto direito 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 corretos já selecionados.
Explorar Essa opção mostra uma lista de opções básicas e geradas automaticamente para sua conexão. Eles não se baseiam nos seus modelos de dados personalizados, mas permitem gerar relatórios rápidos sobre os dados brutos nas tabelas da sua conexão. Isso geralmente é útil apenas para ter uma ideia do conteúdo da tabela antes da modelagem, e não para fins de 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ê terá a oportunidade de confirmar a exclusão, mas, depois de fazer isso, não será possível desfazer a ação. Se você excluir uma conexão por engano, todas as consultas que a usam serão desativadas. No entanto, se você recriar uma conexão com o mesmo nome, a funcionalidade será restaurada.

Ações disponíveis para algumas conexões

Dependendo do dialeto de 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 de Análise do Looker, em que é possível criar consultas com base nos metadados da sua conexão. Embora essa opção comece com o nome do esquema, o nome da tabela e a contagem de colunas selecionados, é possível manipular como qualquer outra Análise do Looker.
Mostrar bancos de dados Essa opção leva você a uma página de Análise do Looker, em que é possível criar consultas com base nos metadados da sua conexão. Embora essa opção comece com o nome do esquema, o nome do catálogo, a contagem de tabelas e a contagem de colunas selecionadas, é possível manipular como qualquer outra Análise do Looker.
Mostrar processos Essa opção leva a uma página de Análise do Looker que permite criar consultas com base nos processos em execução nessa conexão, no estado em que estão, no tempo de execução e em outras informações. Isso pode ser útil para determinar a causa se o Looker estiver lento ou se uma consulta não estiver sendo executada.
Mostrar log de eventos da TDP Essa opção leva você a uma página de Análise do Looker que permite criar consultas com base na atividade da tabela derivada para essa conexão. Os campos disponíveis são descritos em mais detalhes na página de documentação Tabelas derivadas permanentes.