PostgreSQL

Dialetos que usam estas instruções

Os seguintes dialetos compartilham os requisitos de configuração do banco de dados descritos nesta página:

• PostgreSQL
• Microsoft Azure PostgreSQL
• AlloyDB para PostgreSQL
• Amazon Aurora PostgreSQL
• Amazon RDS para PostgreSQL

Para o AlloyDB para PostgreSQL, o Amazon RDS para PostgreSQL e o Amazon Aurora PostgreSQL, o Looker tem suporte à integração.

Para o PostgreSQL no Heroku, consulte a documentação do Heroku.

Para o Google Cloud SQL para PostgreSQL, consulte a página dedicada Google Cloud SQL para PostgreSQL.

Criptografar o tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo Looker e seu banco de dados. Considere uma das opções descritas na página de documentação Como ativar o acesso seguro ao banco de dados.

Se você tiver interesse em usar a criptografia SSL, consulte a documentação do PostgreSQL.

Usuários e segurança

Para realizar ações no seu banco de dados, o Looker precisa ter uma conta de usuário nele.

Para configurar um usuário do banco de dados para o Looker usar, siga estas etapas no banco de dados:

1. Crie um usuário e uma senha para o banco de dados.

   CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';
   

2. Conceda permissões ao usuário do banco de dados para que o Looker possa realizar ações nele:

   GRANT CONNECT ON DATABASE DATABASE_NAME to USERNAME;
   \c DATABASE_NAME
   GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO USERNAME;
   GRANT SELECT ON ALL TABLES IN SCHEMA public TO USERNAME;
   

3. Se você estiver usando um esquema diferente de public, execute este comando para conceder permissões de uso ao Looker:

   GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;
   

4. Para garantir que as futuras tabelas adicionadas ao esquema público também estejam disponíveis para o usuário do Looker, execute estes comandos:

   ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON tables TO USERNAME;
   ALTER DEFAULT PRIVILEGES IN SCHEMA public GRANT SELECT ON sequences TO USERNAME;
   

Dependendo da sua configuração, talvez seja necessário alterar os comandos anteriores. Se outro usuário ou função estiver criando tabelas para as quais o usuário do Looker precisa de permissões futuras, especifique uma função ou um usuário de destino para aplicar as concessões de permissão do usuário do Looker:

ALTER DEFAULT PRIVILEGES FOR USER ANOTHER_USERNAME IN SCHEMA SCHEMA_NAME GRANT SELECT ON tables TO USERNAME;
ALTER DEFAULT PRIVILEGES FOR ROLE TARGET_ROLE IN SCHEMA SCHEMA_NAME GRANT SELECT ON sequences TO USERNAME;

Por exemplo, se um usuário web_app criar tabelas e você quiser que o usuário looker possa usar essas tabelas, execute uma instrução GRANT para conceder permissões ao usuário looker nas tabelas criadas pelo usuário web_app. A função ou o usuário de destino, nesse caso, é o usuário web_app. Isso significa que você quer alterar os privilégios em tabelas criadas por web_app para que o usuário looker tenha permissões de leitura. Veja um exemplo:

ALTER DEFAULT PRIVILEGES FOR USER web_app IN SCHEMA public GRANT SELECT ON tables TO looker;

Consulte ALTER DEFAULT PRIVILEGES no site do PostgreSQL para mais informações.

Configuração do esquema de temperatura

Postgres auto-hospedado

Crie um esquema de propriedade do usuário do Looker:

CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;

Postgres no Amazon RDS

Crie um esquema temporário:

CREATE SCHEMA SCHEMA_NAME;

Mude a propriedade do esquema temporário para o usuário do Looker:

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

Observação: para que as tabelas derivadas permanentes do PostgreSQL funcionem, não use o Looker em um banco de dados de replicação de streaming de "troca a quente". É necessário conseguir gravar no banco de dados de fora do aplicativo.

Como definir o search_path

Antes de conectar o Looker ao banco de dados, defina um search_path adequado, que o SQL Runner do Looker pode usar para recuperar determinados metadados do banco de dados:

ALTER USER USERNAME SET search_path TO '$user',SCHEMA_NAME,SCHEMA_NAME_2,SCHEMA_NAME_3
                                                            ^^^^^^^^^^^^^^^^^^
                                                            ^^^^^^^^^^^^^^^^^^
                                             include a comma-separated list of
                                            all schemas you'll use with Looker

Observação: se você estiver em uma instância do Looker (Google Cloud Core) e quiser usar o ADC, use o nome de usuário da conta de serviço representada que você adicionou ao banco de dados do Cloud SQL. O nome de usuário da conta de serviço terá o formato service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Se o nome de usuário da conta de serviço terminar com .gserviceaccount.com, remova a parte .gserviceaccount.com do nome de usuário. Depois de truncado, o nome de usuário ficaria assim: service-<project number>@gcp-sa-looker.iam.

Criar a conexão do Looker com seu banco de dados

Siga estas etapas para criar a conexão do Looker com seu banco de dados:

1. Na seção Administrador do Looker, selecione Conexões e clique em Adicionar conexão.

2. No menu suspenso Dialeto, selecione o nome do dialeto do banco de dados:

   • Para o Microsoft Azure PostgreSQL, selecione Microsoft Azure PostgreSQL.
   • Para PostgreSQL, selecione PostgreSQL 9.5 ou mais recente ou PostgreSQL anterior à versão 9.5, dependendo da sua versão do PostgreSQL.
   • Para o AlloyDB para PostgreSQL, o Amazon RDS para PostgreSQL e o Amazon Aurora PostgreSQL, selecione PostgreSQL 9.5 ou mais recente.
   Observação: se você estiver em uma instância do Looker (Google Cloud Core) e não encontrar seu dialeto no menu suspenso Dialeto, consulte a documentação do Looker (Google Cloud Core) para verificar se o dialeto é compatível com instâncias do Looker (Google Cloud Core).

3. Preencher os detalhes de conexão. A maioria das configurações é comum para a maioria dos dialetos de banco de dados. Consulte a página de documentação Conectar o Looker ao seu banco de dados para mais informações.

4. Para verificar se a conexão foi bem-sucedida, clique em Testar. Consulte a página de documentação Testar a conectividade do banco de dados para informações sobre solução de problemas.

5. Para salvar essas configurações, clique em Conectar.

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do banco de dados também precisa ser compatível com eles.

O PostgreSQL 9.5 e versões mais recentes são compatíveis com os seguintes recursos a partir do Looker 26.0:

Recurso	Compatível?
Looker (Google Cloud Core)
Agregações simétricas
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Interrupção de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais do JDBC
Diferenciação entre maiúsculas e minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Descrever tabela do SQL Runner
Mostrar índices do SQL Runner
SQL Runner Select 10
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários contextuais
Pooling de conexão
Esboços HLL
Reconhecimento agregado
TDPs incrementais
Milissegundos
Microssegundos
Visualizações materializadas.
Medidas de comparação de períodos
Contagem aproximada aproximada

O Microsoft Azure PostgreSQL é compatível com os seguintes recursos a partir do Looker 26.0:

Recurso	Compatível?
Looker (Google Cloud Core)
Agregações simétricas
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Interrupção de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais do JDBC
Diferenciação entre maiúsculas e minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Descrever tabela do SQL Runner
Mostrar índices do SQL Runner
SQL Runner Select 10
Contagem do SQL Runner
Explicação do SQL
Credenciais do OAuth 2.0
Comentários contextuais
Pooling de conexão
Esboços HLL
Reconhecimento agregado
TDPs incrementais
Milissegundos
Microssegundos
Visualizações materializadas.
Medidas de comparação de períodos
Contagem aproximada aproximada