PostgreSQL

Dialetos que usam essas instruções

Os dialetos a seguir compartilham os requisitos de configuração do banco de dados, conforme descrito nesta página:

  • PostgreSQL
  • Google Cloud SQL para PostgreSQL
  • PostgreSQL do Microsoft Azure
  • AlloyDB para PostgreSQL
  • Amazon Aurora PostgreSQL
  • Amazon RDS para PostgreSQL

Como 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

Mude some_password_here para uma senha exclusiva e segura:

CREATE USER looker WITH ENCRYPTED PASSWORD 'some_password_here';
GRANT CONNECT ON DATABASE database_name to looker;
\c database_name
GRANT SELECT ON ALL SEQUENCES IN SCHEMA public TO looker;
GRANT SELECT ON ALL TABLES IN SCHEMA public TO looker;

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 looker;

Para garantir que as próximas tabelas adicionadas ao esquema público também estejam disponíveis para o usuário looker, execute estes comandos:

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

Dependendo da 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 looker precisa de permissões futuras, você precisará especificar uma função ou um usuário de destino para aplicar as concessões de permissão do usuário looker a:

ALTER DEFAULT PRIVILEGES FOR USER <USER_WHO_CREATES_TABLES> IN SCHEMA public GRANT SELECT ON tables TO looker;
ALTER DEFAULT PRIVILEGES FOR ROLE <ROLE_THAT_CREATES_TABLES> IN SCHEMA public GRANT SELECT ON sequences TO looker;

Por exemplo, se um usuário web_app criar tabelas e você quiser que o usuário looker possa usá-las, execute uma instrução GRANT para conceder ao usuário looker permissões nas tabelas criadas pelo usuário web_app. Nesse caso, o papel/usuário-alvo é o usuário web_app, o que significa que estamos segmentando tabelas criadas por web_app para que o usuário looker possa ter permissões para ler as tabelas. 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 temporário

Postgres auto-hospedado

Crie um esquema de propriedade do usuário looker:

CREATE SCHEMA looker_scratch AUTHORIZATION looker;

Postgres no Amazon RDS

Crie um esquema de rascunho:

CREATE SCHEMA looker_scratch;

Mude a propriedade do esquema de rascunho para o usuário looker:

ALTER SCHEMA looker_scratch OWNER TO looker;

Como configurar o search_path

Por fim, defina um search_path apropriado, que o SQL Runner do Looker usa para recuperar determinados metadados do banco de dados. Supondo que você tenha criado um usuário chamado looker e um esquema temporário chamado looker_scratch, execute o seguinte comando:

ALTER USER looker SET search_path TO '$user',looker_scratch,schema_of_interest,public
                                                            ^^^^^^^^^^^^^^^^^^
                                                            ^^^^^^^^^^^^^^^^^^
                                             include a comma-separated list of
                                            all schemas you'll use with Looker

Como 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 seu banco de dados. Para o dialeto AlloyDB para PostgreSQL, selecione PostgreSQL 9.5+.

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

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

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

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, o dialeto do seu banco de dados também precisa oferecer suporte a eles.

O PostgreSQL 9.5+ é compatível com os seguintes recursos a partir do Looker 24.6:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregações simétricas
Sim
Tabelas derivadas
Sim
Tabelas derivadas de SQL permanentes
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Encerramento da consulta
Sim
Tabelas dinâmicas baseadas em SQL
Sim
Fusos horários
Sim
SSL
Sim
Subtotais
Sim
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos da exibição do SQL Runner
Sim
Tabela de descrição do executor do SQL
Sim
Índices de exibição do SQL Runner
Sim
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais OAuth
No
Comentários do contexto
Sim
Pooling de conexão
Sim
Esboços do HLL
No
Reconhecimento agregado
Sim
TDPs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
No
Contagem aproximada distinta
No

O Google Cloud PostgreSQL é compatível com os seguintes recursos a partir do Looker 24.6:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregações simétricas
Sim
Tabelas derivadas
Sim
Tabelas derivadas de SQL permanentes
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Encerramento da consulta
Sim
Tabelas dinâmicas baseadas em SQL
Sim
Fusos horários
Sim
SSL
Sim
Subtotais
Sim
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos da exibição do SQL Runner
Sim
Tabela de descrição do executor do SQL
Sim
Índices de exibição do SQL Runner
Sim
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais OAuth
No
Comentários do contexto
Sim
Pooling de conexão
Sim
Esboços do HLL
No
Reconhecimento agregado
Sim
TDPs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
No
Contagem aproximada distinta
No

O Microsoft Azure PostgreSQL oferece suporte aos seguintes recursos a partir do Looker 24.6:

Engenharia de Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregações simétricas
Sim
Tabelas derivadas
Sim
Tabelas derivadas de SQL permanentes
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Encerramento da consulta
Sim
Tabelas dinâmicas baseadas em SQL
Sim
Fusos horários
Sim
SSL
Sim
Subtotais
Sim
Parâmetros adicionais do JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos da exibição do SQL Runner
Sim
Tabela de descrição do executor do SQL
Sim
Índices de exibição do SQL Runner
Sim
Seleção do SQL Runner 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais OAuth
No
Comentários do contexto
Sim
Pooling de conexão
Sim
Esboços do HLL
No
Reconhecimento agregado
Sim
TDPs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
No
Contagem aproximada distinta
No