PostgreSQL

Dialetos que usam estas instruções

Os seguintes dialetos 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

Observação: o Looker tem suporte de integração para AlloyDB para PostgreSQL, Amazon RDS para PostgreSQL e Amazon Aurora PostgreSQL. Para criar uma conexão com esses dialetos, selecione PostgreSQL 9.5+ no menu suspenso Dialect na página New Connection.

Observação: para PostgreSQL no Heroku, consulte a documentação do Heroku.

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 Ativar o acesso seguro a 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 futuras 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 sua configuração, pode ser necessário alterar os comandos anteriores. Se outro usuário ou papel estiver criando tabelas para as quais o usuário looker precise de permissões futuras, especifique um papel ou usuário de destino para aplicar as permissões da permissão do usuário looker para:

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 do web_app criar tabelas e você quiser que o usuário do looker possa usar essas tabelas, você deve executar uma instrução GRANT para dar as permissões do usuário da looker em tabelas criadas pelo usuário da web_app Neste caso, o papel/usuário de destino é o usuário web_app, o que significa que estamos segmentando 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-hospedados

Crie um esquema do usuário looker:

CREATE SCHEMA looker_scratch AUTHORIZATION looker;

Postgres no Amazon RDS

Criar um esquema de raspadinha:

CREATE SCHEMA looker_scratch;

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

ALTER SCHEMA looker_scratch OWNER TO looker;

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 "hot swap". É necessário saber gravar no banco de dados fora do aplicativo.

Como definir search_path

Por fim, defina um search_path apropriado que o SQL Runner do 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 adicionar a conexão

Depois de concluir a configuração do banco de dados, conecte-se ao banco de dados no Looker. Na seção Administrador do Looker, selecione Conexões e, em seguida, clique em Adicionar conexão.

Preencha os detalhes de conexão. A maioria dessas configurações é comum para a maioria dos dialetos do banco de dados. Elas são descritas na página de documentação Como conectar o Looker ao seu banco de dados.

Observação: para criar uma conexão para o dialeto AlloyDB para PostgreSQL, selecione PostgreSQL 9.5+ no menu suspenso Dialect da página New Connection.

Depois de definir as opções de conexão, clique em Testar estas configurações para confirmar que a conexão com o PostgreSQL foi concluída. Consulte a página de documentação Como testar a conectividade do banco de dados para ver informações de solução de problemas.

Clique em Adicionar conexão para salvar a conexão.

Suporte a recursos

Para que o Looker ofereça suporte a alguns recursos, seu dialeto do banco de dados também precisa aceitá-los.

Na versão mais recente do Looker, o PostgreSQL oferece suporte aos seguintes recursos do Looker:

Na versão mais recente do Looker, o Cloud SQL para PostgreSQL é compatível com os seguintes recursos do Looker:

Na versão mais recente do Looker, o Microsoft Azure PostgreSQL é compatível com os seguintes recursos do Looker: