Definições de administrador – Ligações

Para aceder à página Ligações, abra o menu Administração e, em Base de dados, escolha Ligações.

Ver associações

Na página Ligações, pode ver as ligações à base de dados e os endereços IP necessários para permitir o tráfego de rede. Se a capacidade de criar uma nova base de dados tiver sido ativada para a sua instância, também pode adicionar uma nova ligação.

Separador Bases de dados

O separador Bases de dados mostra informações básicas sobre as associações de bases de dados que definiu. Também mostra as ligações geridas pelo Looker que criou, se a capacidade de criar uma nova base de dados tiver sido ativada para a sua instância. Também pode testar o estado e editar a configuração dessas associações no separador Bases de dados.

Pode clicar em Endereços IP públicos para ver 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 provém de um dos endereços IP indicados, com base na região onde a sua instância do Looker está alojada. Proibir o tráfego para a sua base de dados, exceto a partir destes e de outros endereços IP fidedignos, é uma forma de limitar o acesso aos dados.

A tabela seguinte descreve os elementos no separador Bases de dados:

Coluna Descrição
Nome O nome da associação, escolhido por si, que é usado no parâmetro LookML connection. Quando testa a ligação, o Looker apresenta a lista de verificações de estado abaixo do nome da ligação.
Bases de dados O nome da base de dados que o Looker vai consultar quando usar esta ligação.
Âmbito Se a associação pode ser usada com todos os projetos ou apenas com um projeto específico.
Servidor SSH O nome da configuração do servidor SSH usada para criar um túnel SSH para a sua base de dados. Esta coluna só é apresentada se o separador Servidores SSH estiver ativado na sua instância do Looker.
SSL Se está ou não a usar a encriptação SSL para proteger os dados trocados entre o Looker e a sua base de dados (existem outras opções seguras além do SSL).
Tipo O dialeto de SQL da ligação à base de dados.
Ações Ações que pode realizar para uma associação: testar uma associação, editar uma associação, ver outras informações acerca de uma associação, aceder a uma lista de links para as explorações da associação ou eliminar uma associação. Se a capacidade de criar uma nova base de dados tiver sido ativada para a sua instância, também pode adicionar dados de uma origem de dados adicional a quaisquer ligações geridas pelo Looker.

Separador Servidores SSH

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

A opção Servidor SSH está disponível se uma instância do Looker (original) for implementada na infraestrutura do Kubernetes e apenas se a capacidade de adicionar informações de configuração do servidor SSH à sua instância do Looker tiver sido ativada. Se esta opção não estiver ativada na sua instância do Looker e quiser ativá-la, contacte um Google Cloud especialista de vendas ou abra um pedido de apoio técnico.

O Looker escolhe automaticamente a porta de anfitrião local por si quando cria túneis SSH. Não pode especificar a porta de anfitrião local.

As ligações SSH a bases de dados PrestoDB ou Trino podem exigir uma configuração adicional da base de dados. Quando o SSL está ativado, a base de dados PrestoDB ou Trino começa a escutar na porta 443 por predefinição. Para estabelecer o túnel SSH, o Looker tem de definir a porta de anfitrião local para 443, que já está a ser usada pelo Looker. Isto faz com que a configuração do túnel SSH falhe. Para corrigir o problema, configure a sua base de dados PrestoDB ou Trino para ouvir numa porta diferente da porta 443 quando o SSL estiver ativado.

O separador Servidores SSH apresenta as configurações do servidor SSH que adicionou, indica o estado das ligações aos servidores SSH e apresenta as ligações à base de dados que usam cada servidor SSH. No separador Servidores SSH, também pode testar uma ligação a um servidor SSH e adicionar ou editar configurações do servidor SSH.

A tabela seguinte descreve os elementos no separador Servidores SSH:

Coluna Descrição
Nome do servidor O nome da configuração do servidor SSH, escolhido por si, que é usado para estabelecer ligação à sua base de dados.
Ligações Uma lista das ligações à base de dados que se ligam ao servidor SSH. Se clicar numa ligação à base de dados, abre a página Editar ligação dessa ligação à base de dados.
Menu de opções de três pontos Ações que pode realizar para uma configuração de servidor SSH: testar ligações a um servidor SSH, adicionar uma ligação à base de dados a um servidor SSH, editar uma configuração de servidor SSH ou eliminar uma configuração de servidor SSH.

Adicionar ou editar uma configuração do servidor SSH

Para adicionar uma nova configuração do servidor SSH:

  1. No separador Servidor SSH, clique em Adicionar servidor
  2. No campo Servidor sem nome no canto superior direito, introduza um nome para a configuração do servidor SSH.
  3. Clique em Transferir chave para transferir a chave pública para um ficheiro de texto. Certifique-se de que guarda este ficheiro para utilização posterior.
  4. No campo Nome de utilizador do servidor, introduza o nome de utilizador que o Looker vai usar para estabelecer ligação ao servidor SSH.
  5. No campo Nome de anfitrião ou endereço IP do servidor, introduza o nome de anfitrião ou o endereço IP do servidor SSH.
  6. No campo Porta do servidor, introduza o número da porta usado para estabelecer ligação ao servidor SSH.
  7. Adicione a chave pública transferida ao ficheiro de chaves autorizadas no seu servidor SSH. Consulte a página de documentação Usar um servidor SSH para ver mais informações e um exemplo.
  8. Certifique-se de que os endereços IP do Looker adequados são adicionados à lista de autorizações no seu servidor SSH para que o Looker possa estabelecer ligação ao servidor SSH.
  9. Clique em Testar e pedir impressão digital para validar a sua ligação ao servidor SSH.
  10. Veja a nova configuração SSH. Neste ecrã, também pode transferir ou ver a chave pública e ver a impressão digital única da configuração do servidor SSH.

Para editar uma configuração de servidor SSH existente, clique no menu de Opções de três pontos na linha do servidor SSH selecionado e escolha Detalhes do servidor.

Testar as ligações a um servidor SSH

Para testar todas as ligações à base de dados a um servidor SSH:

  1. Clique no menu de Opções de três pontos na linha do servidor SSH escolhido.
  2. Escolha Testar ligações.

O Looker testa todas as ligações da base de dados através desse servidor SSH e apresenta uma marca de verificação verde junto ao nome do servidor e a todas as ligações em que o teste de ligação é aprovado. Um ícone de ponto de exclamação vermelho indica que a ligação falhou no teste.

Adicionar uma ligação de base de dados a um servidor SSH

Para adicionar uma nova ligação à base de dados através de um servidor SSH:

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

O Looker apresenta a página Definições de ligação, com o servidor SSH indicado no campo Servidor SSH.

Eliminar uma configuração do servidor SSH

Para eliminar uma configuração do servidor SSH:

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

A testar ligações

O Looker permite-lhe testar as suas associações existentes para se certificar de que estão a funcionar corretamente. Também pode testar as ligações à medida que as adiciona, conforme descrito na página de documentação Associar o Looker à sua base de dados.

Cada teste de ligação inclui uma lista de verificações de estado para lhe indicar se o Looker consegue usar a ligação à base de dados com êxito.

Os potenciais problemas são apresentados a amarelo e os erros são apresentados a vermelho. Se uma associação "passar", aparece a verde.

As ligações à base de dados que usam o OAuth, como o Snowflake e o Google BigQuery, requerem o início de sessão de um utilizador. Se não tiver sessão iniciada na sua conta de utilizador do OAuth quando testar uma destas associações, o Looker apresenta um aviso com um link Iniciar sessão. Clique no link para introduzir as suas credenciais do OAuth ou para permitir que o Looker aceda às informações da sua conta do OAuth.

Pode verificar o estado do seguinte:

  • Uma única associação clicando em Testar na extremidade direita dessa associação
  • Todas as associações clicando no botão Testar todas as associações na parte superior da página

As duas verificações são uma causa comum de confusão:

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

Estas verificações não têm de ser aprovadas para o Looker funcionar. No entanto, precisa delas para usar tabelas derivadas persistentes, que são uma funcionalidade de modelagem muito valiosa.

Adicionar associações

Para adicionar uma nova associação de base de dados, siga os passos descritos na página de documentação Associar o Looker à sua base de dados.

Editar associações

Para editar uma associação existente, abra a página Associações selecionando o menu Administração e, de seguida, em Base de dados, escolha Associações. Clique no botão Editar da associação. É apresentada a mesma página que usa para criar uma associação (descrita na página de documentação Associar o Looker à sua base de dados), mas com as informações relevantes já preenchidas. Faça as alterações necessárias e, de seguida, clique em Atualizar associação.

Ações disponíveis para todas as associações

Todas as associações oferecem estas opções no menu pendente de engrenagem no lado direito de cada associação:

Opção Descrição
Execução de SQL Esta opção direciona para a execução de SQL do Looker, com a ligação e o esquema adequados já selecionados.
Explore Esta opção apresenta uma lista de opções básicas do Explorar geradas automaticamente para a sua associação. Estes não se baseiam nos seus modelos de dados personalizados, mas permitem a criação de alguns relatórios rápidos sobre os dados não processados nas tabelas da sua associação. Normalmente, isto só é útil para ter uma ideia dos conteúdos da tabela antes da modelagem, em vez de para fins de análise de dados real.
Eliminar Para eliminar uma associação existente, clique no menu pendente de engrenagem no lado direito de uma associação e selecione Eliminar. Tem a oportunidade de confirmar a eliminação, mas, depois de o fazer, não é possível anular a ação. A eliminação acidental de uma associação desativa todas as consultas que a usam. No entanto, se recriar uma nova ligação com o mesmo nome, a funcionalidade é restaurada.

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

Consoante o dialeto de ligação, o menu pendente de engrenagem à direita da ligação pode oferecer as seguintes opções adicionais:

Opção Descrição
Mostrar tabelas Esta opção acede a uma página de exploração do Looker que lhe permite criar consultas de exploração do Looker com base nos metadados da sua ligação. Embora esta opção comece com o nome do esquema, o nome da tabela e a contagem de colunas selecionados, pode manipulá-la como qualquer outra análise detalhada do Looker.
Mostrar bases de dados Esta opção acede a uma página de exploração do Looker que lhe permite criar consultas de exploração do Looker com base nos metadados da sua ligação. Embora esta opção comece com o nome do esquema, o nome do catálogo, a contagem de tabelas e a contagem de colunas selecionados, pode manipulá-la como qualquer outra análise detalhada do Looker.
Mostrar processos Esta opção direciona para uma página de exploração do Looker que lhe permite criar consultas de exploração do Looker com base nos processos em execução nesta ligação, no estado em que se encontram, no tempo de execução e noutras informações. Isto pode ser útil para ajudar a determinar a causa se o Looker estiver lento ou se uma consulta não estiver a ser executada.
Mostrar registo de eventos PDT Esta opção acede a uma página de exploração do Looker que lhe permite criar consultas de exploração do Looker com base na atividade da tabela derivada para esta associação. Os campos disponíveis são descritos mais detalhadamente na nossa página de documentação Tabelas derivadas persistentes.