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.
Configurer votre cluster Apache Druid
<DRUID_BASE_DIR>
fait référence au répertoire de base dans lequel le cluster Apache Druid est installé sur un serveur.
Activer SQL
Pour activer SQL sur votre base de données Druid, ajoutez la ligne suivante au fichier de configuration broker/runtime.properties
:
<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties
druid.sql.enable=true
Désactivation de l'approximation COUNT DISTINCT
(facultatif)
Par défaut, Druid utilise COUNT DISTINCT
approximativement. Pour obtenir des résultats précis, ajoutez cette ligne au fichier de configuration broker/runtime.properties
:
<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties
`druid.sql.planner.useApproximateCountDistinct=false`
Créer la connexion Looker à votre base de données
Dans la section Admin 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. Certains de ces paramètres sont décrits ci-dessous:
- Nom: nom de la connexion.
Dialecte: Apache Druid, Apache Druid 0.13+ ou Apache Druid 0.18+.
Host (Hôte) : DNS ou adresse IP du cluster Broker. Vous le trouverez dans le fichier
broker/runtime.properties
.Port: port de Broker. Le port par défaut est 8082. Si votre cluster est sécurisé par SSL, le port par défaut est 8182.
Database (Base de données) : nom de votre base de données. La valeur par défaut est
druid
.Nom d'utilisateur : nom d'utilisateur de la base de données si votre cluster Apache Druid est configuré pour utiliser la sécurité de base Druid. Si ce n'est pas le cas, vous pouvez spécifier n'importe quelle chaîne.
Mot de passe: mot de passe utilisateur. Si votre cluster n'est pas configuré pour utiliser Druid Basic Security, vous pouvez spécifier n'importe quelle chaîne.
Schéma: le schéma par défaut à utiliser lorsqu'aucun schéma n'est spécifié. La saisie d'un schéma est facultative.
Paramètres JDBC supplémentaires: paramètres Avro JDBC délimités par un point-virgule.
- Ces propriétés peuvent être définies comme propriétés de connexion :
useApproximateCountDistinct
useApproximateTopN
useFallback
sqlTimeZone
Exemple :
none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit
- Ces propriétés peuvent être définies comme propriétés de connexion :
Calendrier de maintenance des groupes de données et des tables dérivées persistantes : expression
cron
qui indique quand Looker doit vérifier les groupes de données et les tables dérivées persistantes. Pour en savoir plus sur ce paramètre, consultez la documentation Planification de la maintenance des groupes de données et des tables PDT.SSL: vérifiez si votre cluster Apache Druid est configuré pour utiliser Druid TLS.
Vérifier le protocole SSL : cochez cette option pour appliquer une vérification stricte du nom d'hôte.
Nombre maximal de connexions par nœud: la valeur par défaut est 25. Vous pouvez conserver la valeur par défaut de ce paramètre. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données.
Expiration du pool de connexions: la valeur par défaut est de 120 secondes.
Précache de l'exécuteur SQL: pour empêcher SQL Runner de précharger les informations de table et de ne les charger que lorsqu'une table est sélectionnée, désélectionnez cette option. Pour en savoir plus sur ce paramètre, consultez la documentation Mise en cache préalable de l'exécuteur SQL.
Database Time Zone (Fuseau horaire de la base de données) : fuseau horaire de la base de données. Compatible avec Apache Druid 0.13 et versions ultérieures, ainsi qu'avec Apache Druid 0.18 et versions ultérieures.
Pour vérifier que la connexion est établie, cliquez sur Test (Tester). Consultez la page de documentation Tester la connectivité de la base de données pour obtenir des informations de dépannage.
Looker exécute une requête SELECT 1
pour vérifier une connexion de base et effectuer un test de requête. Cela ne confirme pas l'existence de la combinaison catalogue/schéma, ni que l'utilisateur dispose de l'accès requis à ce schéma.
En cas de problème, consultez notre documentation Tester des connexions.
Pour enregistrer ces paramètres, cliquez sur Connecter.
Testez la connexion dans SQL Runner. Accédez à SQL Runner, sélectionnez votre connexion et votre schéma, puis vérifiez si vous pouvez voir les tables de votre base de données.
Compatibilité des caractéristiques
Pour que Looker prenne en charge certaines fonctionnalités, votre dialecte de base de données doit également les prendre en charge.
Apache Druid
Apache Druid prend en charge les fonctionnalités suivantes à partir de Looker 24.16:
Caractéristique | Compatibilité |
---|---|
Niveau d'assistance | Compatible |
Looker (Google Cloud Core) | Non |
Agrégations symétriques | Non |
Tables dérivées | Oui |
Tables dérivées SQL persistantes | Non |
Tables dérivées natives persistantes | Non |
Vues stables | Non |
Suppression des requêtes | Non |
Pivots basés sur SQL | Non |
Fuseaux horaires | Non |
SSL | Oui |
Sous-totaux | Non |
Paramètres supplémentaires JDBC | Oui |
Sensible à la casse | Oui |
Type d'emplacement | Oui |
Type de liste | Non |
Centile | Non |
Centile distinct | Non |
Processus d'affichage de l'exécuteur SQL | Non |
Table de description de l'exécuteur SQL | Non |
Index d'affichage de l'exécuteur SQL | Non |
SQL Runner Select 10 | Oui |
Nombre d'exécuteurs SQL | Oui |
SQL Explain | Oui |
Identifiants Oauth | Non |
Commentaires sur le contexte | Oui |
Pooling des connexions | Non |
HLL Sketches | Non |
Reconnaissance d'agrégats. | Non |
Augmentation de tables PDT | Non |
Millisecondes | Oui |
Microsecondes | Non |
Vues matérialisées | Non |
Nombre approximatif distinct | Non |
Apache Druid 0.13 et versions ultérieures
Apache Druid 0.13 et versions ultérieures sont compatibles avec les fonctionnalités suivantes à partir de Looker 24.16:
Caractéristique | Compatibilité |
---|---|
Niveau d'assistance | Compatible |
Looker (Google Cloud Core) | Non |
Agrégations symétriques | Non |
Tables dérivées | Oui |
Tables dérivées SQL persistantes | Non |
Tables dérivées natives persistantes | Non |
Vues stables | Non |
Suppression des requêtes | Non |
Pivots basés sur SQL | Non |
Fuseaux horaires | Oui |
SSL | Oui |
Sous-totaux | Non |
Paramètres supplémentaires JDBC | Oui |
Sensible à la casse | Oui |
Type d'emplacement | Non |
Type de liste | Non |
Centile | Non |
Centile distinct | Non |
Processus d'affichage de l'exécuteur SQL | Non |
Table de description de l'exécuteur SQL | Non |
Index d'affichage de l'exécuteur SQL | Non |
SQL Runner Select 10 | Oui |
Nombre d'exécuteurs SQL | Oui |
SQL Explain | Oui |
Identifiants Oauth | Non |
Commentaires sur le contexte | Oui |
Pooling des connexions | Non |
HLL Sketches | Non |
Reconnaissance d'agrégats. | Non |
Augmentation de tables PDT | Non |
Millisecondes | Oui |
Microsecondes | Non |
Vues matérialisées | Non |
Nombre approximatif distinct | Non |
Apache Druid 0.18 ou version ultérieure
Apache Druid 0.18 et versions ultérieures sont compatibles avec les fonctionnalités suivantes à partir de Looker 24.16 :
Caractéristique | Compatibilité |
---|---|
Niveau d'assistance | Compatible |
Looker (Google Cloud Core) | Oui |
Agrégations symétriques | Non |
Tables dérivées | Oui |
Tables dérivées SQL persistantes | Non |
Tables dérivées natives persistantes | Non |
Vues stables | Non |
Suppression des requêtes | Non |
Pivots basés sur SQL | Non |
Fuseaux horaires | Oui |
SSL | Oui |
Sous-totaux | Non |
Paramètres supplémentaires JDBC | Oui |
Sensible à la casse | Oui |
Type d'emplacement | Oui |
Type de liste | Non |
Centile | Non |
Centile distinct | Non |
Processus d'affichage de l'exécuteur SQL | Non |
Table de description de l'exécuteur SQL | Non |
Index d'affichage de l'exécuteur SQL | Non |
SQL Runner Select 10 | Oui |
Nombre d'exécuteurs SQL | Oui |
SQL Explain | Oui |
Identifiants Oauth | Non |
Commentaires sur le contexte | Oui |
Pooling des connexions | Non |
HLL Sketches | Non |
Reconnaissance d'agrégats. | Non |
Augmentation de tables PDT | Non |
Millisecondes | Oui |
Microsecondes | Non |
Vues matérialisées | Non |
Nombre approximatif distinct | Non |
Étapes suivantes
Une fois la connexion à la base de données établie, configurez les options d'authentification.