Conectar-se ao PostgreSQL

É possível conectar seus bancos de dados PostgreSQL ao Data Studio para visualizar e analisar seus dados. Use o conector do PostgreSQL para transformar seus dados em painéis e relatórios interativos. Depois, você pode compartilhar seus insights com sua equipe ou partes interessadas que não têm acesso direto ao banco de dados.

Versões compatíveis

Testamos o Data 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 do Data Studio. Também é possível adicionar e votar em solicitações de recursos no Issue Tracker.

Como se conectar ao PostgreSQL

O conector do PostgreSQL usa o driver JDBC do PostgreSQL para conectar uma fonte de dados do Data Studio a uma única tabela de banco de dados do PostgreSQL ou a uma consulta personalizada que você fornecer.

Para se conectar ao banco de dados do PostgreSQL, siga estas etapas:

1. Faça login no Data Studio.
2. Na página inicial do Data Studio, clique em Criar e selecione Fonte de dados.
3. Selecione o conector PostgreSQL.
4. Se solicitado, autorize o Data Studio a acessar seus dados.
5. Para configurar o acesso ao seu banco de dados, use uma das opções de conexão.
6. Clique em AUTENTICAR. Você verá uma lista de tabelas nesse banco de dados.
7. Selecione uma tabela na lista ou insira uma consulta personalizada.
8. Clique em CONECTAR.

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

Opções de conexão

Conectar-se usando um nome do host ou endereço IP

No painel de conexão, selecione BÁSICO. Digite os detalhes da conexão:

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

Conectar-se usando um URL JDBC

No painel de conexão, selecione URL JDBC. Digite os detalhes da conexão:

• URL JDBC

  • Exemplo jdbc:postgresql://HOSTNAME[:PORT]/DATABASE_NAME

  • Para Cloud SQL (IP particular) jdbc:google:postgresql://< var>INSTANCE_CONNECTION_NAME/DATABASE_NAME

• Nome de usuário
• Senha

Observação : para conexões por IP particular do Cloud SQL, não use o nome ou o ID da organização como prefixo da string de conexão e remova todos os espaços do URL. Para ver todos os requisitos, incluindo as permissões necessárias, consulte Conexões públicas e privadas.

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

Conectar usando SSL

O Data Studio aceita conexões seguras (criptografadas) com o servidor usando o protocolo TLS (Transport Layer Security, TLS 1.2). O TLS também é chamado de SSL (Secure Socket Layer).

Para ativar uma conexão segura, selecione Ativar SSL e envie seus arquivos de configuração de SSL.

Conectar usando a autenticação de cliente

Se a caixa Ativar autenticação do cliente estiver marcada, você poderá fazer upload de uma chave privada e de um certificado do cliente, se necessário, para acessar seu banco de dados.

Observação: o Data 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. Esse SQL personalizado é usado como uma instrução SELECT interna no Data Studio a cada consulta gerada para o banco de dados.

As consultas SQL personalizadas só podem ter uma instrução. 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 Data Studio podem atingir o tempo limite depois de 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.

Tipos de dados compatíveis

O conector do PostgreSQL é compatível com os seguintes tipos de dados:

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

Quando identifica uma coluna de um tipo não compatível, o Data Studio não cria um campo para ela.

Saiba mais sobre os tipos de dados do PostgreSQL.

Conexões públicas e privadas

O Data Studio é compatível com conexões por IP público e particular ao PostgreSQL no Cloud SQL.

Para se conectar a uma instância do Cloud SQL para PostgreSQL usando um IP privado, verifique os seguintes requisitos:

• Permissões do Identity and Access Management (IAM): conceda o papel do IAM de cliente do Cloud SQL (roles/cloudsql.client) no projeto do Google Cloud que contém a instância do Cloud SQL. Você precisa conceder esse papel à conta de usuário que autentica a conexão no Data Studio ou ao proprietário da credencial da fonte de dados. Se a fonte de dados usar as credenciais do leitor, conceda esse papel a cada leitor de relatórios.
• Configurações da instância: selecione a opção Caminho particular para serviços do Google Cloud nas configurações da instância do Cloud SQL.

• URL JDBC: no painel de conexão, selecione a opção de conexão URL JDBC e insira a string de conexão no seguinte formato:

  jdbc:google:postgresql://INSTANCE_CONNECTION_NAME/DATABASE_NAME

  Substitua:

  • INSTANCE_CONNECTION_NAME: o nome da conexão da instância no formato PROJECT_ID:REGION:INSTANCE_ID
  • DATABASE_NAME: o nome do banco de dados do PostgreSQL

  Exemplo:

  jdbc:google:postgresql://my-project:us-central1:my-instance/my-db

  Não adicione o nome ou o ID da organização como um prefixo à string de conexão e remova todos os espaços do URL.

Observação : o Data Studio não valida o campo URL do JDBC antes de tentar se conectar. Um URL JDBC inválido ou a falta de permissões do IAM pode fazer com que o Data Studio pare de responder ao carregar tabelas em vez de exibir uma mensagem de erro.

Firewall e acesso ao banco de dados

Para permitir que o Data Studio se conecte e consulte bancos de dados protegidos por firewall, abra o acesso a um dos endereços IP a seguir. 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

Os seguintes endereços são reservados para a infraestrutura global do Data Studio:

• 142.251.74.0/23

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

Se você ativou a residência de dados na sua assinatura do Data Studio Pro, use os seguintes endereços:

• 142.251.56.0/24

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

Limites do conector do PostgreSQL

• O conector do PostgreSQL não usa o proxy do Cloud SQL ao se conectar a instâncias do Cloud SQL para PostgreSQL. Se estiver se conectando a uma instância do Cloud SQL para PostgreSQL usando um IP público, adicione os IPs listados à lista de redes autorizadas. Confira a documentação do Cloud SQL.

• Não é possível se conectar a fontes de dados do AlloyDB por SSL, porque o AlloyDB não é compatível com a exportação de certificados de autoridade certificadora (CA).

• 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 Data Studio para conferir uma lista de mensagens de erro comuns e as etapas para resolvê-los.

Recursos relacionados

Criar uma fonte de dados