Apache Druid

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 équivaut à COUNT DISTINCT. Pour obtenir des résultats précis, ajoutez la ligne suivante 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 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. Certains des paramètres sont décrits ci-dessous:

• Nom: nom de la connexion.
• Dialect: Apache Druid, Apache Druid 0.13+ ou Apache Druid 0.18+.
• Hôte: DNS ou adresse IP du cluster Broker. Vous le trouverez dans votre fichier broker/runtime.properties.
• Port: port du Broker. Le port par défaut est 8082. Si votre cluster est sécurisé par SSL, le port par défaut est 8182.
• Base de données: nom de votre base de données. La valeur par défaut est druid.
• Nom d'utilisateur: le nom d'utilisateur de la base de données si votre cluster Apache Druid est configuré pour utiliser Druid Basic Security. Si ce n'est pas le cas, vous pouvez spécifier n'importe quelle chaîne.
• Password (Mot de passe) : mot de passe de l'utilisateur. Si votre cluster n'est pas configuré pour utiliser Druid Basic Security, vous pouvez spécifier n'importe quelle chaîne.
• Schéma: 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 JDBC Avatica séparés par un point-virgule.

  • Ces propriétés peuvent être définies en tant que propriétés de connexion :
    • useApproximateCountDistinct
    • useApproximateTopN
    • useFallback
    • sqlTimeZone

  Exemple : useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

• 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 Calendrier de maintenance des groupes de données et des tables dérivées persistantes.

• 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 validation 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 Connecter Looker à votre base de données.

• Expiration du pool de connexions: la valeur par défaut est de 120 secondes.

• Préchargement d'exécuteur SQL: permet de décocher l'option permettant de ne pas précharger les informations d'une table et de ne les charger que lorsqu'une table est sélectionnée. Pour en savoir plus sur ce paramètre, consultez la documentation sur le précache 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 Apache Druid 0.18+.

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.

Looker exécute une requête SELECT 1 pour vérifier une connexion de base et effectuer un test de requête. Il ne vérifie pas que la combinaison du catalogue et du schéma existe ni que l'utilisateur dispose de l'accès requis à ce schéma.

Si vous rencontrez des problèmes, consultez la documentation sur le test des connexions.

Pour enregistrer ces paramètres, cliquez sur Connecter.

Testez la connexion dans l'exécuteur SQL. Accédez à l'exécuteur SQL, sélectionnez votre connexion et votre schéma, puis vérifiez si vous pouvez voir les tables de votre base de données.

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.

Apache Druid

Apache Druid est compatible avec les fonctionnalités suivantes à partir de Looker 23.8:

Caractéristique	Compatible ?
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
Arrêt des requêtes	Non
Pivots basés sur SQL	Non
Fuseaux horaires	Non
SSL	Oui
Sous-totaux	Non
Paramètres JDBC supplémentaires	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 "Décrire" de l'exécuteur SQL	Non
Index d'émissions SQL Runner	Non
Exécuteur SQL 10	Oui
Nombre d'exécuteurs SQL	Oui
SQL Explain	Oui
Identifiants OAuth	Non
Commentaires contextuels	Oui
Pooling de connexions	Non
croquis HLL	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+

Apache Druid 0.13 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)	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
Arrêt des requêtes	Non
Pivots basés sur SQL	Non
Fuseaux horaires	Oui
SSL	Oui
Sous-totaux	Non
Paramètres JDBC supplémentaires	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 "Décrire" de l'exécuteur SQL	Non
Index d'émissions SQL Runner	Non
Exécuteur SQL 10	Oui
Nombre d'exécuteurs SQL	Oui
SQL Explain	Oui
Identifiants OAuth	Non
Commentaires contextuels	Oui
Pooling de connexions	Non
croquis HLL	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+

Apache Druid 0.18 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	Non
Tables dérivées	Oui
Tables dérivées SQL persistantes	Non
Tables dérivées natives persistantes	Non
Vues stables	Non
Arrêt des requêtes	Non
Pivots basés sur SQL	Non
Fuseaux horaires	Oui
SSL	Oui
Sous-totaux	Non
Paramètres JDBC supplémentaires	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 "Décrire" de l'exécuteur SQL	Non
Index d'émissions SQL Runner	Non
Exécuteur SQL 10	Oui
Nombre d'exécuteurs SQL	Oui
SQL Explain	Oui
Identifiants OAuth	Non
Commentaires contextuels	Oui
Pooling de connexions	Non
croquis HLL	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 terminée, configurez les options d'authentification.