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
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 dans la page 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 futures tables que vous ajouterez 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 de l'utilisateur looker pour:
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 s'en servir, vous devez exécuter une instruction GRANT pour accorder à l'utilisateur looker les autorisations sur les tables créées par l'utilisateur web_app. Dans ce cas, le rôle/utilisateur cible est l'utilisateur web_app. Cela signifie que nous ciblons les tables créées par web_app pour 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 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;
Définir 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
Créer la connexion Looker à votre base de données
Dans la section Administration de Looker, sélectionnez Connexions, puis cliquez sur Ajouter une connexion.
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.
Pour vérifier que la connexion a réussi, cliquez sur Tester. Pour en savoir plus sur le dépannage, consultez la page de test de la connectivité de la base de données.
Pour enregistrer ces paramètres, cliquez sur Connecter.
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.
PostgreSQL 9.5 et les versions ultérieures sont compatibles avec les fonctionnalités suivantes à partir de Looker 23.8:
| Caractéristique | Compatible ? |
|---|---|
| Niveau d'assistance | Compatible |
| Looker (Google Cloud Core) | Oui |
| Agrégations symétriques | Oui |
| Tables dérivées | Oui |
| Tables dérivées SQL persistantes | Oui |
| Tables dérivées natives persistantes | Oui |
| Vues stables | Oui |
| Arrêt des requêtes | Oui |
| Pivots basés sur SQL | Oui |
| Fuseaux horaires | Oui |
| SSL | Oui |
| Sous-totaux | Oui |
| Paramètres JDBC supplémentaires | Oui |
| Sensible à la casse | Oui |
| Type d'emplacement | Oui |
| Type de liste | Oui |
| Centile | Oui |
| Centile distinct | Oui |
| Processus d'affichage de l'exécuteur SQL | Oui |
| Table "Décrire" de l'exécuteur SQL | Oui |
| Index d'émissions SQL Runner | Oui |
| Exécuteur SQL 10 | Oui |
| Nombre d'exécuteurs SQL | Oui |
| SQL Explain | Oui |
| Identifiants OAuth | Non |
| Commentaires contextuels | Oui |
| Pooling de connexions | Oui |
| croquis HLL | Non |
| Reconnaissance d'agrégats. | Oui |
| Augmentation de tables PDT | Oui |
| Millisecondes | Oui |
| Microsecondes | Oui |
| Vues matérialisées | Non |
| Nombre approximatif distinct | Non |
À partir de Looker 23.8, Google Cloud PostgreSQL est compatible avec les fonctionnalités suivantes:
| Caractéristique | Compatible ? |
|---|---|
| Niveau d'assistance | Compatible |
| Looker (Google Cloud Core) | Oui |
| Agrégations symétriques | Oui |
| Tables dérivées | Oui |
| Tables dérivées SQL persistantes | Oui |
| Tables dérivées natives persistantes | Oui |
| Vues stables | Oui |
| Arrêt des requêtes | Oui |
| Pivots basés sur SQL | Oui |
| Fuseaux horaires | Oui |
| SSL | Oui |
| Sous-totaux | Oui |
| Paramètres JDBC supplémentaires | Oui |
| Sensible à la casse | Oui |
| Type d'emplacement | Oui |
| Type de liste | Oui |
| Centile | Oui |
| Centile distinct | Oui |
| Processus d'affichage de l'exécuteur SQL | Oui |
| Table "Décrire" de l'exécuteur SQL | Oui |
| Index d'émissions SQL Runner | Oui |
| Exécuteur SQL 10 | Oui |
| Nombre d'exécuteurs SQL | Oui |
| SQL Explain | Oui |
| Identifiants OAuth | Non |
| Commentaires contextuels | Oui |
| Pooling de connexions | Oui |
| croquis HLL | Non |
| Reconnaissance d'agrégats. | Oui |
| Augmentation de tables PDT | Oui |
| Millisecondes | Oui |
| Microsecondes | Oui |
| Vues matérialisées | Non |
| Nombre approximatif distinct | Non |
Microsoft Azure PostgreSQL est compatible avec les fonctionnalités suivantes à partir de Looker 23.8:
| Caractéristique | Compatible ? |
|---|---|
| Niveau d'assistance | Compatible |
| Looker (Google Cloud Core) | Oui |
| Agrégations symétriques | Oui |
| Tables dérivées | Oui |
| Tables dérivées SQL persistantes | Oui |
| Tables dérivées natives persistantes | Oui |
| Vues stables | Oui |
| Arrêt des requêtes | Oui |
| Pivots basés sur SQL | Oui |
| Fuseaux horaires | Oui |
| SSL | Oui |
| Sous-totaux | Oui |
| Paramètres JDBC supplémentaires | Oui |
| Sensible à la casse | Oui |
| Type d'emplacement | Oui |
| Type de liste | Oui |
| Centile | Oui |
| Centile distinct | Oui |
| Processus d'affichage de l'exécuteur SQL | Oui |
| Table "Décrire" de l'exécuteur SQL | Oui |
| Index d'émissions SQL Runner | Oui |
| Exécuteur SQL 10 | Oui |
| Nombre d'exécuteurs SQL | Oui |
| SQL Explain | Oui |
| Identifiants OAuth | Non |
| Commentaires contextuels | Oui |
| Pooling de connexions | Oui |
| croquis HLL | Non |
| Reconnaissance d'agrégats. | Oui |
| Augmentation de tables PDT | Oui |
| Millisecondes | Oui |
| Microsecondes | Oui |
| Vues matérialisées | Non |
| Nombre approximatif distinct | Non |