PostgreSQL

Dialectes utilisant ces instructions

Les dialectes suivants partagent les exigences de configuration de la base de données, comme décrit sur cette page:

• PostgreSQL
• Cloud SQL pour PostgreSQL
• Microsoft Azure PostgreSQL
• AlloyDB pour PostgreSQL
• Amazon Aurora PostgreSQL
• Amazon RDS pour PostgreSQL

Remarque : Looker est compatible avec l'intégration d'AlloyDB pour PostgreSQL, d'Amazon RDS pour PostgreSQL et d'Amazon Aurora PostgreSQL. Pour créer une connexion pour ces dialectes, sélectionnez PostgreSQL 9.5+ dans la liste déroulante Dialect de la page New Connection (Nouvelle connexion).

Remarque:Pour PostgreSQL sur Heroku, consultez la documentation Heroku.

Chiffrement du trafic réseau

Il est vivement conseillé de chiffrer le trafic réseau entre l'application Looker et votre base de données. Choisissez l'une des options décrites sur la page de documentation Activer l'accès sécurisé aux bases de données.

Si vous souhaitez utiliser le chiffrement SSL, consultez la documentation PostgreSQL.

Utilisateurs et sécurité

Remplacez some_password_here par un mot de passe unique et sécurisé:

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;

Si vous utilisez un schéma autre que public, exécutez la commande suivante pour accorder des autorisations d'utilisation à Looker:

GRANT USAGE ON SCHEMA schema_name TO looker;

Pour vous assurer que les tables que vous ajouterez ultérieurement au schéma public seront également disponibles pour l'utilisateur looker, exécutez les commandes suivantes:

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

En fonction de votre configuration, les commandes précédentes peuvent nécessiter une modification. Si un autre utilisateur ou rôle crée des tables pour lesquelles l'utilisateur looker a besoin d'autorisations futures, vous devez spécifier un rôle ou un utilisateur cible pour appliquer les autorisations looker accordées à l'utilisateur:

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;

Par exemple, si un utilisateur web_app crée des tables et que vous souhaitez que l'utilisateur looker puisse utiliser ces tables, vous devez exécuter une instruction GRANT pour accorder à l'utilisateur looker des autorisations sur les tables créées par l'utilisateur web_app. Dans ce cas, le rôle/utilisateur cible est l'utilisateur web_app, ce qui signifie que nous ciblons les tables créées par web_app afin que l'utilisateur looker puisse être autorisé à lire les tables. Voici un exemple :

ALTER DEFAULT PRIVILEGES FOR USER web_app IN SCHEMA public GRANT SELECT ON tables TO looker;

Pour en savoir plus, consultez la section concernant ALTER DEFAULT PRIVILEGES sur le site Web de PostgreSQL.

Configuration d'un schéma temporaire

Postgres auto-hébergé

Créez un schéma appartenant à l'utilisateur looker:

CREATE SCHEMA looker_scratch AUTHORIZATION looker;

Postgres sous Amazon RDS

Créez un schéma entièrement nouveau :

CREATE SCHEMA looker_scratch;

Remplacez la propriété du schéma de travail par l'utilisateur looker:

ALTER SCHEMA looker_scratch OWNER TO looker;

Remarque:Pour que les tables dérivées persistantes de PostgreSQL fonctionnent, vous ne devez pas utiliser Looker sur une base de données en réplication par flux "à chaud". Vous devez pouvoir écrire dans la base de données depuis l'extérieur de l'application.

Définir le search_path

Enfin, vous devez définir un search_path approprié, que l'exécuteur SQL de Looker utilise pour récupérer certaines métadonnées de votre base de données. En supposant que vous ayez créé un utilisateur nommé looker et un schéma temporaire appelé looker_scratch, la commande est la suivante:

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

Ajout de la connexion

Une fois la base de données configurée, vous pouvez vous y connecter depuis Looker. Dans la section Admin de Looker, sélectionnez Connections (Connexions), puis cliquez sur Add Connection (Ajouter une connexion).

Indiquez les détails de la connexion. La majorité de ces paramètres sont communs à la plupart des dialectes de base de données. Elles sont décrites sur la page de documentation Connecter Looker à votre base de données.

Remarque : Pour créer une connexion pour le dialecte AlloyDB pour PostgreSQL, sélectionnez PostgreSQL 9.5+ dans le menu déroulant Dialect de la page New Connection (Nouvelle connexion).

Après avoir configuré les options de connexion, cliquez sur Tester ces paramètres pour vérifier que la connexion à PostgreSQL a réussi. Consultez la page de documentation Test de la connectivité à la base de données pour obtenir des informations de dépannage.

Cliquez sur Add Connection (Ajouter une connexion) pour enregistrer la connexion.

Prise en charge de fonctionnalités

Pour que Looker prenne en charge certaines fonctionnalités, votre dialecte de base de données doit également les prendre en charge.

Dans la dernière version de Looker, PostgreSQL est compatible avec les fonctionnalités suivantes:

Dans la dernière version de Looker, Cloud SQL pour PostgreSQL est compatible avec les fonctionnalités Looker suivantes:

Dans la dernière version de Looker, Microsoft Azure PostgreSQL est compatible avec les fonctionnalités Looker suivantes: