Apache Druid

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 cette ligne au fichier de configuration broker/runtime.properties:

<DRUID_BASE_DIR>/conf/druid/broker/runtime.properties

druid.sql.enable=true

Désactiver l'approximation COUNT DISTINCT (facultatif)

Par défaut, Druid se rapproche de COUNT DISTINCT. 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 des paramètres sont décrits ci-dessous:

  • Name (Nom) : nom de la connexion.

  • Dialecte: Apache Druid, Apache Druid 0.13 ou version ultérieure ou Apache Druid 0.18.

  • Host (Hôte) : le DNS ou l'adresse IP de l'agent de service du cluster. Vous le trouverez dans votre 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é Druid Basic. 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.

  • Schema (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 délimité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 : none useApproximateCountDistinct=false;truststore=/path/to/truststore.jks;truststore_password=changeit

  • Planification de maintenance des groupes de données et des tables PDT: 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 PDT.

  • SSL: vérifiez si votre cluster Apache Druid est configuré pour utiliser Druid TLS.

  • Vérifier SSL: cochez cette case pour appliquer une validation stricte du nom d'hôte.

  • Nombre maximal de connexions par nœud: la valeur par défaut est 25. Dans un premier temps, 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 connexion: la valeur par défaut est de 120 secondes.

  • SQL Runner Precache (Précache de l'exécuteur SQL) : pour empêcher SQL Runner de précharger les informations de table et pour charger ces informations uniquement lorsqu'une table est sélectionnée, désactivez cette option. Pour en savoir plus sur ce paramètre, consultez la documentation sur la 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, Apache Druid 0.18 et versions ultérieures.

Pour vérifier que la connexion est établie, cliquez sur 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.

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

Pour enregistrer ces paramètres, cliquez sur Connecter.

Tester 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 vos tables de 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 prend en charge les fonctionnalités suivantes à partir de Looker 24.8:

Sélection 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 de la requête
Non
Tableaux croisés dynamiques 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 de description de l'exécuteur SQL
Non
Afficher les index 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 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 et versions ultérieures

Apache Druid 0.13+ prend en charge les fonctionnalités suivantes à partir de Looker 24.8:

Sélection 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 de la requête
Non
Tableaux croisés dynamiques 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 de description de l'exécuteur SQL
Non
Afficher les index 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 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 et versions ultérieures

Apache Druid 0.18+ prend en charge les fonctionnalités suivantes à partir de Looker 24.8:

Sélection 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 de la requête
Non
Tableaux croisés dynamiques 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 de description de l'exécuteur SQL
Non
Afficher les index 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 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.