Conectar-se ao PostgreSQL

O PostgreSQL é um sistema de gerenciamento de banco de dados relacional (RDBMS, na sigla em inglês) de código aberto desenvolvido por uma equipe de voluntários de todo o mundo.

Com o conector PostgreSQL, você pode acessar dados dos bancos desse sistema no Looker Studio.

Como se conectar ao PostgreSQL

Esse conector usa o driver JDBC do PostgreSQL para conectar uma fonte de dados do Looker Studio a uma única tabela de banco de dados do PostgreSQL.

Versões compatíveis

Testamos o Looker Studio nas seguintes versões do PostgreSQL:

  • 9,6
  • 10
  • 11
  • 12
  • 13
  • 14

Se você tiver problemas ao usar uma versão compatível, deixe um comentário na Comunidade de Ajuda do Looker Studio. É possível adicionar e votar nas solicitações de recursos aqui.

Para conectar

  1. Faça login no Looker Studio.
  2. Na parte de cima à esquerda da página inicial do Looker Studio, clique em Criar e selecione Fonte de dados.
  3. Selecione o conector PostgreSQL.
  4. Configure o acesso ao seu banco de dados usando uma das opções de conexão (confira abaixo).
  5. Clique em AUTENTICAR. Você vai encontrar uma lista de tabelas nesse banco de dados.
  6. Selecione uma tabela.
  7. Clique em CONECTAR.

Agora você pode acessar todas as colunas da tabela como campos nos seus relatórios.

Opções de conexão

BÁSICO

Para se conectar com um nome de host ou endereço IP, você precisa fornecer as seguintes informações:

  • Nome do host ou endereço IP
  • Porta (opcional)
  • Banco de dados
  • Nome de usuário
  • Senha

URL JDBC

Para se conectar usando um URL JDBC, forneça estas informações de conexão:

  • URL JDBC
    • Exemplo jdbc:postgresql://HOSTNAME[:PORT]/DATABASE
  • Senha

Se você usa a opção de nome do host JDBC, pode verificar se ele é acessível com ferramentas de busca DNS público, como o Whois.

Para se conectar usando um endereço literal IPv6, inclua o endereço entre colchetes. Por exemplo: jdbc:postgresql://[2001:db8:1:1:1:1:1:1]/your_db

Ativar SSL

O Looker Studio aceita conexões seguras (criptografadas) com o servidor usando o protocolo TLS (Transport Layer Security). O TLS também é chamado de SSL (Secure Sockets Layer). Para ativar uma conexão segura, marque a opção Ativar SSL e envie seus arquivos de configuração de SSL.

Essa configuração não é obrigatória para o Looker Studio, mas pode ser necessária para a configuração do banco de dados. Consulte o fornecedor do banco de dados para mais detalhes.

Ativar a autenticação do cliente

Se essa caixa for marcada, você poderá fazer upload de uma chave privada e de um certificado do cliente, se necessário, para acessar seu banco de dados.

Essa configuração não é obrigatória para o Looker Studio, mas pode ser necessária para a configuração do banco de dados. Consulte o fornecedor do banco de dados para mais detalhes.

Observação : o Looker Studio espera um formato de chave de cliente PKCS-8.

Saiba mais sobre as conexões seguras do PostgreSQL.

Consulta personalizada

Selecione a opção CONSULTA PERSONALIZADA para estabelecer uma consulta SQL, em vez de se conectar a uma única tabela. O Looker Studio usa esse SQL personalizado como uma instrução SELECT interna a cada consulta gerada para o banco de dados.

O exemplo a seguir não funciona porque tem várias instruçõ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 tempo limite após três a cinco minutos. Se as consultas personalizadas expirarem, tente as seguintes abordagens para resolver o problema:

  • Simplifique a consulta para que seja executada com mais rapidez.
  • Execute a consulta no seu banco de dados e armazene os resultados em uma tabela separada. Conecte a nova tabela na sua fonte de dados.

Observações

Tipos de dados compatíveis

O conector PostgreSQL oferece suporte aos seguintes tipos de dados:

  • Numérico
  • Baseado em caracteres
  • Booleano
  • Data/hora (exceto intervalos)

Quando o Looker Studio encontra uma coluna de um tipo não compatível, ele não cria um campo para ela.

Saiba mais sobre os tipos de dados do PostgreSQL.

Firewall e acesso ao banco de dados

Para permitir que o Looker Studio se conecte e consulte bancos de dados protegidos por firewall, abra o acesso a um dos seguintes endereços IP. Talvez também seja necessário configurar seu banco de dados para aceitar tráfego desses endereços. Consulte a documentação do seu banco de dados específico para saber como fazer isso.

Endereços IP

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (opcional para plataformas com suporte a IPv6)

Observe as seguintes limitações de rede ao usar o conector do PostgreSQL:

  • O Looker Studio não oferece suporte a conexões de IP particulares com o PostgreSQL no Cloud SQL.

  • O conector do PostgreSQL não usa o proxy do Cloud SQL ao se conectar a instâncias do Cloud SQL para PostgreSQL. Se você estiver se conectando a uma dessas instâncias, adicione os IPs listados à lista de redes autorizadas. Consulte a documentação do Cloud SQL.

Limites do conector do PostgreSQL

  • Não é possível selecionar uma tabela fora do esquema public. No entanto, você pode selecionar a opção CONSULTA PERSONALIZADA para fazer uma consulta que inclua tabelas em qualquer esquema.

  • Esse conector permite adicionar até 150 mil linhas por consulta. Se você exceder esse limite, os dados serão truncados.

  • Os cabeçalhos das colunas (nomes dos campos) só aceitam caracteres ASCII. Caracteres não ASCII não são aceitos.

Solução de problemas

Consulte o guia de solução de problemas do Looker Studio para conferir uma lista de mensagens de erro comuns e as etapas para resolvê-los.

Criar uma origem de dados