Estabeleça ligação ao PostgreSQL

O PostgreSQL é um sistema de gestão de base de dados relacional (RDBMS) de código aberto que foi desenvolvido por uma equipa mundial de voluntários.

O conetor do PostgreSQL permite-lhe aceder a dados das bases de dados baseadas em PostgreSQL no Looker Studio.

Como estabelecer ligação ao PostgreSQL

Este conetor usa o controlador JDBC do PostgreSQL para associar uma origem de dados do Looker Studio a uma única tabela de base de dados do PostgreSQL.

Versões suportadas

Testámos o Looker Studio nas seguintes versões do PostgreSQL:

  • 9.6
  • 10
  • 11
  • 12
  • 13
  • 14

Se tiver problemas ao usar uma versão suportada, informe-nos na Comunidade de ajuda do Looker Studio. Pode adicionar e votar em pedidos de funcionalidades no rastreador de problemas.

Para associar

  1. Inicie sessão no Looker Studio.
  2. Na página inicial do Looker Studio, na parte superior esquerda, clique em Criar e, de seguida, selecione Origem de dados.
  3. Selecione o conetor do PostgreSQL.
  4. Configure o acesso à sua base de dados através de uma das opções de ligação (veja abaixo).
  5. Clique em AUTENTICAR. É apresentada uma lista de tabelas nessa base de dados.
  6. Selecione uma tabela.
  7. Clique em ASSOCIAR.

Agora, pode aceder a todas as colunas da tabela como campos nos seus relatórios.

Opções de ligação

BÁSICO

Para estabelecer ligação a um nome de anfitrião ou a um endereço IP, tem de facultar as seguintes informações:

  • Nome do anfitrião ou endereço IP
  • Porta (opcional)
  • Bases de dados
  • Nome de utilizador
  • Palavra-passe

URL JDBC

Para estabelecer ligação através de um URL JDBC, faculte as seguintes informações de ligação:

  • URL JDBC
    • Exemplo jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
  • Palavra-passe

Se usar a opção de nome de anfitrião JDBC, pode certificar-se de que está acessível com ferramentas de procura de DNS públicas, como o Whois.

Para estabelecer ligação através de um endereço literal IPv6, coloque o endereço entre parênteses retos. Por exemplo: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

Ative o SSL

O Looker Studio suporta ligações seguras (encriptadas) ao servidor através do protocolo TLS (Transport Layer Security). O TLS também é designado SSL (camada de ligação segura). Para ativar uma ligação segura, selecione Ativar SSL e, em seguida, faculte os seus ficheiros de configuração SSL.

Esta definição não é necessária para o Looker Studio, mas pode ser necessária para a configuração da sua base de dados. Contacte o fornecedor da base de dados para saber mais detalhes.

Ative a autenticação de cliente

Quando esta caixa está selecionada, pode carregar uma chave privada do cliente e um certificado do cliente, se necessário, para aceder à sua base de dados.

Esta definição não é necessária para o Looker Studio, mas pode ser necessária para a configuração da sua base de dados. Contacte o fornecedor da base de dados para saber mais detalhes.

Nota : o Looker Studio espera um formato de chave de cliente PKCS-8.

Saiba mais sobre as ligações seguras do PostgreSQL.

Consulta personalizada

Selecione a opção CONSULTA PERSONALIZADA para fornecer uma consulta SQL em vez de estabelecer ligação a uma única tabela. O Looker Studio usa este SQL personalizado como uma declaração de seleção interna para cada consulta gerada à base de dados.

Por exemplo, o seguinte não funciona porque tem várias declarações SQL:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

As consultas no Looker Studio podem atingir o limite de tempo após três a cinco minutos. Se as suas consultas personalizadas excederem o limite de tempo, experimente as seguintes abordagens para resolver o problema:

  • Simplifique a consulta para que seja executada mais rapidamente.
  • Execute a consulta na sua base de dados e armazene os resultados numa tabela separada. Associe a nova tabela na sua origem de dados.

Notas

Tipos de dados suportados

O conetor do PostgreSQL suporta os seguintes tipos de dados:

  • Numérico
  • Personagem
  • Booleano
  • Data/hora (exceto intervalos)

Quando o Looker Studio encontra uma coluna de um tipo não suportado, não cria um campo para essa coluna.

Saiba mais sobre os tipos de dados do PostgreSQL.

Acesso à base de dados e à firewall

Para permitir que o Looker Studio se ligue e consulte bases de dados que estão atrás de uma firewall, tem de abrir o acesso a um dos seguintes endereços IP. Também pode ter de configurar a sua base de dados para aceitar tráfego destes endereços. Consulte a documentação da sua base de dados específica para ver instruções sobre como o fazer.

Endereços IP

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (Opcional, para plataformas que suportam IPv6)

Tenha em atenção as seguintes limitações de rede quando usar o conetor PostgreSQL:

  • O Looker Studio não suporta ligações de IP privadas ao PostgreSQL no Cloud SQL.

  • O conetor do PostgreSQL não usa o proxy do Cloud SQL quando se liga a instâncias do PostgreSQL do Cloud SQL. Se estiver a estabelecer ligação a uma instância do Cloud SQL PostgreSQL, tem de adicionar os IPs indicados à lista de redes autorizadas. Consulte a documentação do Cloud SQL.

Limites do conetor do PostgreSQL

  • A seleção de uma tabela fora do esquema public não é suportada. No entanto, pode selecionar a opção CONSULTA PERSONALIZADA para escrever uma consulta que inclua tabelas em qualquer esquema.

  • Pode consultar um máximo de 150 mil linhas por consulta através deste conector. Se exceder este limite, os dados são truncados.

  • Os cabeçalhos das colunas (nomes dos campos) têm de usar apenas carateres ASCII. Os carateres não ASCII não são suportados.

Resolução de problemas

Consulte o guia de resolução de problemas do Looker Studio para ver uma lista de mensagens de erro comuns e os passos para as resolver.

Crie uma origem de dados