PostgreSQL

Dialectes utilisant ces instructions

Les dialectes suivants partagent les mêmes exigences de configuration de la base de données que celles décrites sur cette page :

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

Looker est compatible avec AlloyDB pour PostgreSQL, Amazon RDS pour PostgreSQL et Amazon Aurora PostgreSQL. Looker est compatible avec AlloyDB pour PostgreSQL, Amazon RDS pour PostgreSQL et Amazon Aurora PostgreSQL.

Pour PostgreSQL sur Heroku, consultez la documentation Heroku.

Pour Google Cloud SQL pour PostgreSQL, consultez notre page dédiée Google Cloud SQL pour PostgreSQL.

Chiffrement du trafic réseau

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

Si vous envisagez d'utiliser le chiffrement SSL, consultez la documentation PostgreSQL.

Utilisateurs et sécurité

Pour effectuer des actions sur votre base de données, Looker doit disposer d'un compte utilisateur dans celle-ci.

Pour configurer un utilisateur de base de données que Looker pourra utiliser, procédez comme suit dans votre base de données :

  1. Créez un utilisateur et un mot de passe pour la base de données.

    CREATE USER USERNAME WITH ENCRYPTED PASSWORD 'PASSWORD';

  2. Accordez des autorisations à l'utilisateur de la base de données afin que Looker puisse effectuer des actions dans votre base de données :

    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. Si vous utilisez un schéma autre que public, exécutez cette commande pour accorder des autorisations d'utilisation à Looker :

    GRANT USAGE ON SCHEMA SCHEMA_NAME TO USERNAME;

  4. Pour être certain qu'à l'avenir, les tables que vous ajouterez au schéma public soient elles aussi accessibles à l'utilisateur Looker, exécutez les commandes suivantes :

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

En fonction de votre configuration, les commandes précédentes peuvent nécessiter une modification. Si un autre utilisateur crée des tables pour lesquelles l'utilisateur Looker aura besoin d'autorisations, vous devez indiquer un rôle ou un utilisateur cible auquel appliquer les autorisations de l'utilisateur 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;

Par exemple, si un utilisateur web_app crée des tables et que vous souhaitez que l'utilisateur looker puisse les utiliser, 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 ou l'utilisateur cible est l'utilisateur web_app. Cela signifie que vous souhaitez modifier les droits sur les tables créées par web_app afin que l'utilisateur looker puisse avoir l'autorisation de 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 page ALTER DEFAULT PRIVILEGES sur le site Web de PostgreSQL.

Configuration d'un schéma temporaire

Postgres auto-hébergé

Créez un schéma dont le propriétaire est l'utilisateur Looker :

CREATE SCHEMA SCHEMA_NAME AUTHORIZATION USERNAME;

Postgres sous Amazon RDS

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

CREATE SCHEMA SCHEMA_NAME;

Remplacez le propriétaire du nouveau schéma par l'utilisateur Looker :

ALTER SCHEMA SCHEMA_NAME OWNER TO USERNAME;

Définir le search_path

Avant de connecter Looker à votre base de données, vous devez définir un search_path approprié, que l'exécuteur SQL de Looker pourra utiliser pour récupérer certaines métadonnées de votre base de données :

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

Créer la connexion Looker à votre base de données

Procédez comme suit pour créer la connexion entre Looker et votre base de données :

  1. Dans la section Admin de Looker, sélectionnez Connections (Connexions), puis cliquez sur Add Connection (Ajouter une connexion).

  2. Dans le menu déroulant Dialect (Dialecte), sélectionnez le nom du dialecte de votre base de données :

    • Pour Microsoft Azure PostgreSQL, sélectionnez Microsoft Azure PostgreSQL.
    • Pour PostgreSQL, sélectionnez PostgreSQL 9.5+ ou PostgreSQL pre-9.5 (PostgreSQL avant la version 9.5), selon votre version de PostgreSQL.
    • Pour AlloyDB pour PostgreSQL, Amazon RDS pour PostgreSQL et Amazon Aurora PostgreSQL, sélectionnez PostgreSQL 9.5+.

  3. Saisissez les informations de connexion. La majorité des paramètres sont communs à la plupart des dialectes de base de données. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données.

  4. Pour vérifier que la connexion a réussi, cliquez sur Test (Tester). Pour obtenir des informations sur la résolution des problèmes, consultez la page de documentation Tester la connectivité de la base de données.

  5. Pour enregistrer ces paramètres, cliquez sur Connect (Se connecter).

Compatibilité avec les fonctionnalités

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

Depuis Looker 25.18, PostgreSQL 9.5+ est compatible avec les fonctionnalités suivantes :

Fonctionnalité Compatibilité
Niveau d'assistanceCompatible
Looker (Google Cloud Core)
Agrégations symétriques
Tables dérivées
Tables dérivées SQL persistantes
Tables dérivées natives persistantes
Vues stables
Arrêt des requêtes
Tableaux croisés dynamiques basés sur SQL
Fuseaux horaires
SSL
Sous-totaux
Paramètres JDBC supplémentaires
Sensibilité à la casse
Type de lieu
Type de liste
Centile
Centile distinct
Afficher les processus dans l'exécuteur SQL
Décrire la table dans l'exécuteur SQL
Afficher les index dans l'exécuteur SQL
Sélectionner 10 dans l'exécuteur SQL
Nombre dans l'exécuteur SQL
Explication SQL
Identifiants OAuth 2.0
Commentaires contextuels
Regroupement de connexions
Résumés HLL
Reconnaissance d'agrégats
Augmentation de tables PDT
Millisecondes
Microsecondes
Vues matérialisées
Mesures de variation par période
Nombre approximatif d'éléments distincts

Depuis Looker 25.18, Microsoft Azure PostgreSQL est compatible avec les fonctionnalités suivantes :

Fonctionnalité Compatibilité
Niveau d'assistanceCompatible
Looker (Google Cloud Core)
Agrégations symétriques
Tables dérivées
Tables dérivées SQL persistantes
Tables dérivées natives persistantes
Vues stables
Arrêt des requêtes
Tableaux croisés dynamiques basés sur SQL
Fuseaux horaires
SSL
Sous-totaux
Paramètres JDBC supplémentaires
Sensibilité à la casse
Type de lieu
Type de liste
Centile
Centile distinct
Afficher les processus dans l'exécuteur SQL
Décrire la table dans l'exécuteur SQL
Afficher les index dans l'exécuteur SQL
Sélectionner 10 dans l'exécuteur SQL
Nombre dans l'exécuteur SQL
Explication SQL
Identifiants OAuth 2.0
Commentaires contextuels
Regroupement de connexions
Résumés HLL
Reconnaissance d'agrégats
Augmentation de tables PDT
Millisecondes
Microsecondes
Vues matérialisées
Mesures de variation par période
Nombre approximatif d'éléments distincts