PostgreSQL

Dialetos que usam estas instruções

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

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

Como criptografar o tráfego de rede

O Looker recomenda 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

Altere some_password_here para uma senha única 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 tabelas futuras que você adicionar 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 sua configuração, os comandos anteriores talvez precisem ser alterados. Se outro usuário ou papel estiver criando tabelas para as quais o usuário looker precisará de permissões futuras, será necessário especificar um papel de destino ou usuário para quem conceder as permissões do usuário looker:

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, será necessário executar uma instrução GRANT para conceder ao usuário looker permissões em tabelas criadas pelo usuário web_app. Neste caso, o usuário/papel de destino é 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-hospedados

Crie um esquema pertencente ao usuário looker:

CREATE SCHEMA looker_scratch AUTHORIZATION looker;

Postgres no Amazon RDS

Crie um esquema de rascunho:

CREATE SCHEMA looker_scratch;

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

ALTER SCHEMA looker_scratch OWNER TO looker;

Como definir o search_path

Por fim, você precisa definir um search_path apropriado que o SQL Runner da Looker usa para recuperar determinados metadados do seu banco de dados. Supondo que você tenha criado um usuário chamado looker e um esquema temporário chamado looker_scratch, o 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

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

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 Como conectar o Looker ao seu banco de dados para mais informações.

Para verificar se a conexão foi concluída, 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.

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

Suporte a recursos

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

O PostgreSQL 9.5 ou superior é compatível com os seguintes recursos a partir do Looker 23.8:

Recurso Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregados simétricos
Sim
Tabelas derivadas
Sim
Tabelas derivadas do SQL permanente
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Eliminação de consultas
Sim
Tabelas dinâmicas baseadas em SQL
Sim
Fusos horários
Sim
SSL
Sim
Subtotais
Sim
Parâmetros adicionais de JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos do SQL Runner Show
Sim
Tabela de descrição do SQL Runner
Sim
Índices do SQL Runner Show
Sim
SQL Runner Select 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais do OAuth
Não
Comentários de contexto
Sim
Pool de conexão
Sim
HLL Sketches
Não
Reconhecimento agregado
Sim
PDTs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
Não
Contagem aproximada diferente
Não

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

Recurso Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregados simétricos
Sim
Tabelas derivadas
Sim
Tabelas derivadas do SQL permanente
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Eliminação de consultas
Sim
Tabelas dinâmicas baseadas em SQL
Sim
Fusos horários
Sim
SSL
Sim
Subtotais
Sim
Parâmetros adicionais de JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos do SQL Runner Show
Sim
Tabela de descrição do SQL Runner
Sim
Índices do SQL Runner Show
Sim
SQL Runner Select 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais do OAuth
Não
Comentários de contexto
Sim
Pool de conexão
Sim
HLL Sketches
Não
Reconhecimento agregado
Sim
PDTs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
Não
Contagem aproximada diferente
Não

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

Recurso Compatível?
Nível do suporte
Compatível
Looker (Google Cloud Core)
Sim
Agregados simétricos
Sim
Tabelas derivadas
Sim
Tabelas derivadas do SQL permanente
Sim
Tabelas derivadas nativas nativas
Sim
Visualizações estáveis
Sim
Eliminação de consultas
Sim
Tabelas dinâmicas baseadas em SQL
Sim
Fusos horários
Sim
SSL
Sim
Subtotais
Sim
Parâmetros adicionais de JDBC
Sim
Diferenciar maiúsculas e minúsculas
Sim
Tipo de local
Sim
Tipo de lista
Sim
Percentil
Sim
Percentil distinto
Sim
Processos do SQL Runner Show
Sim
Tabela de descrição do SQL Runner
Sim
Índices do SQL Runner Show
Sim
SQL Runner Select 10
Sim
Contagem de executores do SQL
Sim
Explicação do SQL
Sim
Credenciais do OAuth
Não
Comentários de contexto
Sim
Pool de conexão
Sim
HLL Sketches
Não
Reconhecimento agregado
Sim
PDTs incrementais
Sim
Milissegundos
Sim
Microssegundos
Sim
Visualizações materializadas
Não
Contagem aproximada diferente
Não