Dialetos que usam estas instruções
Os seguintes dialetos partilham os requisitos de configuração da base de dados, conforme descrito nesta página:
- PostgreSQL
- Google Cloud SQL para PostgreSQL
- Microsoft Azure PostgreSQL
- AlloyDB para PostgreSQL
- Amazon Aurora PostgreSQL
- Amazon RDS para PostgreSQL
Para o Google Cloud SQL para PostgreSQL, o Looker (Google Cloud core) oferece Credenciais padrão da aplicação (ADC) como um método de autenticação. Consulte a documentação do Looker (Google Cloud core) para mais informações.
Para o AlloyDB para PostgreSQL, o Amazon RDS para PostgreSQL e o Amazon Aurora PostgreSQL, o Looker tem suporte de integração. Para criar uma associação para estes dialetos, selecione PostgreSQL 9.5 ou superior no menu pendente Dialeto na página Nova associação.
Para o PostgreSQL no Heroku, consulte a documentação do Heroku.
Encriptar o tráfego de rede
É uma prática recomendada encriptar o tráfego de rede entre a aplicação Looker e a sua base de dados. Considere uma das opções descritas na página de documentação Ativar o acesso seguro à base de dados.
Se tiver interesse em usar a encriptação SSL, consulte a documentação do PostgreSQL.
Utilizadores e segurança
Para realizar ações na sua base de dados, o Looker tem de ter uma conta de utilizador na sua base de dados.
Se estiver numa instância do Looker (essencial para o Google Cloud) e quiser usar o ADC, use o nome de utilizador da conta de serviço simulada que adicionou à sua base de dados do Cloud SQL. O nome de utilizador da conta de serviço tem o formato service-<project number>@gcp-sa-looker.iam.gserviceaccount.com. Se o nome de utilizador da sua conta de serviço terminar em .gserviceaccount.com, remova a parte .gserviceaccount.com do nome de utilizador. Depois de ser truncado, o nome de utilizador teria o seguinte aspeto: service-<project number>@gcp-sa-looker.iam.
Para configurar um utilizador da base de dados para o Looker usar, siga estes passos na sua base de dados:
Crie um utilizador e uma palavra-passe da base de dados.
CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';Conceda autorizações ao utilizador da base de dados para que o Looker possa realizar ações na sua base de dados:
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;Se estiver a usar um esquema diferente de
public, execute este comando para conceder autorizações de utilização ao Looker:GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;Para se certificar de que as tabelas futuras que adicionar ao esquema público também estão disponíveis para o utilizador 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;
Consoante a sua configuração, pode ter de alterar os comandos anteriores. Se outro utilizador ou função estiver a criar tabelas para as quais o utilizador do Looker precisa de autorizações futuras, tem de especificar uma função ou um utilizador de destino para aplicar as concessões de autorizações do utilizador 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 utilizador web_app criar tabelas e quiser que o utilizador looker possa usar essas tabelas, tem de executar uma declaração GRANT para conceder autorizações ao utilizador looker nas tabelas criadas pelo utilizador web_app. Neste caso, a função ou o utilizador de destino é o utilizador web_app, o que significa que quer alterar os privilégios nas tabelas criadas por web_app para que o utilizador looker possa ter autorizações para ler as tabelas. Vejamos um exemplo:
ALTER DEFAULT PRIVILEGES FOR USER web_app IN SCHEMA public GRANT SELECT ON tables TO looker;
Consulte ALTER DEFAULT PRIVILEGES no Website do PostgreSQL para mais informações.
Configuração do esquema de temperatura
Postgres autoalojado
Crie um esquema pertencente ao utilizador do Looker:
CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;
Postgres no Amazon RDS
Crie um esquema de rascunho:
CREATE SCHEMA SCHEMA_NAME;
Altere a propriedade do esquema temporário para o utilizador do Looker:
ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;
Definir o search_path
Antes de ligar o Looker à sua base de dados, deve definir um search_path adequado, que o SQL Runner do Looker pode usar para obter determinados metadados da sua base 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
Criar a ligação do Looker à sua base de dados
Siga estes passos para criar a ligação do Looker à sua base de dados:
- Na secção Administração do Looker, selecione Ligações e, de seguida, clique em Adicionar ligação.
No menu pendente Dialeto, selecione o nome do dialeto da base de dados. Para o dialeto do AlloyDB para PostgreSQL, selecione PostgreSQL 9.5 ou superior.
Preencha os detalhes da ligação. A maioria das definições é comum à maioria dos dialetos de bases de dados. Consulte a página de documentação Associar o Looker à sua base de dados para ver informações.
Para verificar se a associação foi bem-sucedida, clique em Testar. Consulte a página de documentação Testar a conetividade da base de dados para ver informações de resolução de problemas.
Para guardar estas definições, clique em Associar.
Suporte de funcionalidades
Para que o Looker suporte algumas funcionalidades, o dialeto da base de dados também tem de as suportar.
O PostgreSQL 9.5 ou superior suporta as seguintes funcionalidades a partir do Looker 25.14:
| Funcionalidade | Compatível? |
|---|---|
| Nível de apoio técnico | Suportado |
| Looker (Google Cloud Core) | Sim |
| Dados agregados simétricos | Sim |
| Tabelas derivadas | Sim |
| Tabelas derivadas SQL persistentes | Sim |
| Tabelas derivadas nativas persistentes | Sim |
| Vistas estáveis | Sim |
| Interrupção de consultas | Sim |
| Tabelas dinâmicas baseadas em SQL | Sim |
| Fusos horários | Sim |
| SSL | Sim |
| Subtotais | Sim |
| Parâmetros JDBC adicionais | Sim |
| Sensível a maiúsculas e minúsculas | Sim |
| Tipo de localização | Sim |
| Tipo de lista | Sim |
| Percentil | Sim |
| Percentil distinto | Sim |
| Execução de SQL Mostrar processos | Sim |
| Execução de SQL Describe Table | Sim |
| Execução de SQL Mostrar índices | Sim |
| Execução de SQL Select 10 | Sim |
| Contagem da execução de SQL | Sim |
| SQL Explain | Sim |
| Credenciais do OAuth 2.0 | Não |
| Comentários de contexto | Sim |
| Agrupamento de ligações | Sim |
| Esboços HLL | Não |
| Notoriedade agregada | Sim |
| PDTs incrementais | Sim |
| Milissegundos | Sim |
| Microssegundos | Sim |
| Vistas materializadas | Não |
| Medidas de comparação de períodos | Não |
| Contagem distinta aproximada | Não |
O Google Cloud PostgreSQL suporta as seguintes funcionalidades a partir do Looker 25.14:
| Funcionalidade | Compatível? |
|---|---|
| Nível de apoio técnico | Suportado |
| Looker (Google Cloud Core) | Sim |
| Dados agregados simétricos | Sim |
| Tabelas derivadas | Sim |
| Tabelas derivadas SQL persistentes | Sim |
| Tabelas derivadas nativas persistentes | Sim |
| Vistas estáveis | Sim |
| Interrupção de consultas | Sim |
| Tabelas dinâmicas baseadas em SQL | Sim |
| Fusos horários | Sim |
| SSL | Sim |
| Subtotais | Sim |
| Parâmetros JDBC adicionais | Sim |
| Sensível a maiúsculas e minúsculas | Sim |
| Tipo de localização | Sim |
| Tipo de lista | Sim |
| Percentil | Sim |
| Percentil distinto | Sim |
| Execução de SQL Mostrar processos | Sim |
| Execução de SQL Describe Table | Sim |
| Execução de SQL Mostrar índices | Sim |
| Execução de SQL Select 10 | Sim |
| Contagem da execução de SQL | Sim |
| SQL Explain | Sim |
| Credenciais do OAuth 2.0 | Não |
| Comentários de contexto | Sim |
| Agrupamento de ligações | Sim |
| Esboços HLL | Não |
| Notoriedade agregada | Sim |
| PDTs incrementais | Sim |
| Milissegundos | Sim |
| Microssegundos | Sim |
| Vistas materializadas | Não |
| Medidas de comparação de períodos | Não |
| Contagem distinta aproximada | Não |
O Microsoft Azure PostgreSQL suporta as seguintes funcionalidades a partir do Looker 25.14:
| Funcionalidade | Compatível? |
|---|---|
| Nível de apoio técnico | Suportado |
| Looker (Google Cloud Core) | Sim |
| Dados agregados simétricos | Sim |
| Tabelas derivadas | Sim |
| Tabelas derivadas SQL persistentes | Sim |
| Tabelas derivadas nativas persistentes | Sim |
| Vistas estáveis | Sim |
| Interrupção de consultas | Sim |
| Tabelas dinâmicas baseadas em SQL | Sim |
| Fusos horários | Sim |
| SSL | Sim |
| Subtotais | Sim |
| Parâmetros JDBC adicionais | Sim |
| Sensível a maiúsculas e minúsculas | Sim |
| Tipo de localização | Sim |
| Tipo de lista | Sim |
| Percentil | Sim |
| Percentil distinto | Sim |
| Execução de SQL Mostrar processos | Sim |
| Execução de SQL Describe Table | Sim |
| Execução de SQL Mostrar índices | Sim |
| Execução de SQL Select 10 | Sim |
| Contagem da execução de SQL | Sim |
| SQL Explain | Sim |
| Credenciais do OAuth 2.0 | Não |
| Comentários de contexto | Sim |
| Agrupamento de ligações | Sim |
| Esboços HLL | Não |
| Notoriedade agregada | Sim |
| PDTs incrementais | Sim |
| Milissegundos | Sim |
| Microssegundos | Sim |
| Vistas materializadas | Não |
| Medidas de comparação de períodos | Não |
| Contagem distinta aproximada | Não |