PostgreSQL

Para conectar o Looker a um banco de dados PostgreSQL, é necessário configurar o banco de dados. Neste documento, explicamos como configurar contas de usuário, conceder as permissões necessárias e definir parâmetros de esquema e conexão. Para informações sobre o PostgreSQL no Heroku ou o Cloud SQL para PostgreSQL, consulte a documentação deles.

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
  • PostgreSQL do Microsoft Azure
  • Amazon Aurora PostgreSQL
  • Amazon RDS para PostgreSQL

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

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

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

Criptografia do tráfego de rede

É uma prática recomendada criptografar o tráfego de rede entre o aplicativo do 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ê quiser usar a criptografia SSL, consulte a documentação do PostgreSQL.

Usuários e segurança

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

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

  1. Crie um usuário e uma senha de 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 no seu banco 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;

  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 tabelas futuras 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 papel estiver criando tabelas para as quais o usuário do Looker precisará de permissões futuras, especifique um papel ou 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 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 ou usuário de destino é web_app, o que significa que você quer alterar os privilégios nas tabelas criadas por web_app para que o usuário looker tenha 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 do Looker:

CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;

Postgres no Amazon RDS

Crie um esquema de rascunho:

CREATE SCHEMA SCHEMA_NAME;

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

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

Como definir o search_path

Antes de conectar o Looker ao seu banco de dados, defina um search_path apropriado, que o SQL Runner do Looker pode usar para recuperar determinados metadados do seu 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 that you'll use with Looker

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. Abra a página Conectar seu banco de dados ao Looker seguindo um destes procedimentos:

    • Clique no ícone Menu principal, selecione Administrador e, em seguida, selecione Conexões na seção Banco de dados do painel Administrador. Na página Conexões, clique no botão Adicionar conexão.
    • Clique no botão Criar no menu de navegação principal e selecione o item de menu 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 PostgreSQL anterior à versão 9.5, dependendo da sua versão do PostgreSQL.
    • Para o Amazon RDS para PostgreSQL e o Amazon Aurora PostgreSQL, selecione PostgreSQL 9.5+.

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

  4. Para verificar se a conexão foi bem-sucedida, clique no botão Testar conexão na seção Detalhes do status na parte de baixo da página Configurações de conexões.

  5. Se o Looker exibir Pode se conectar, pressione Conectar para criar a conexão.

A conexão do banco de dados é adicionada à lista na página Administrador de Conexões do Looker.

Parâmetros JDBC compatíveis

Para o PostgreSQL, o Looker é compatível com os seguintes parâmetros JDBC no campo Parâmetros JDBC adicionais da conexão. Consulte a documentação do seu banco de dados para mais informações sobre esses parâmetros.

  • allowEncodingChanges
  • ApplicationName
  • assumeMinServerVersion
  • binaryTransfer
  • binaryTransferDisable
  • binaryTransferEnable
  • cancelSignalTimeout
  • connectTimeout
  • currentSchema
  • databaseMetadataCacheFields
  • defaultRowFetchSize
  • escapeSyntaxCallMode
  • gssEncMode
  • hostRecheckSeconds
  • jaasApplicationName
  • jaasLogin
  • kerberosServerName
  • loadBalanceHosts
  • loginTimeout
  • logServerErrorDetail
  • options
  • password
  • preferQueryMode
  • preparedStatementCacheQueries
  • prepareThreshold
  • queryTimeout
  • readOnly
  • reWriteBatchedInserts
  • socketTimeout
  • ssl
  • sslfactory
  • sslhostnameverifier
  • sslmode
  • sslNegotiation
  • sslpassword
  • sslpasswordcallback
  • stringtype
  • targetServerType
  • tcpKeepAlive
  • unknownLength
  • user

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+ é compatível com os seguintes recursos a partir do Looker 26.22:

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Encerramento de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da JDBC
Diferencia maiúsculas de minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Tabela de descrição 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 de contexto
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
Modelos analíticos no banco de dados
Agendas personalizadas

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

Recurso Compatível?
Looker (Google Cloud Core)
Conjuntos simétricos
Tabelas derivadas
Tabelas derivadas persistentes em SQL
Tabelas derivadas nativas persistentes
Visualizações estáveis
Encerramento de consultas
Tabelas dinâmicas baseadas em SQL
Fusos horários
SSL
Subtotais
Parâmetros adicionais da JDBC
Diferencia maiúsculas de minúsculas
Tipo de local
Tipo de lista
Percentil
Percentil distinto
Mostrar processos do SQL Runner
Tabela de descrição 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 de contexto
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
Modelos analíticos no banco de dados
Agendas personalizadas