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. Pour ce faire, consultez les options détaillées sur la page Sécurisation de l'accès à la base de données de la documentation.

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 dans 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 approxime COUNT DISTINCT. Pour obtenir des résultats précis, ajoutez cette ligne au broker/runtime.properties fichier de configuration :

<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 Connections (Connexions), puis cliquez sur Add Connection (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. Voici quelques-uns des paramètres :

  • Nom : nom de la connexion.

  • Dialecte : Apache Druid , Apache Druid 0.13+ (Apache Druid 0.13.x - 0.17.x) ou Apache Druid 0.18+.

  • Hôte : adresse DNS ou IP du broker de cluster Broker. Vous trouverez cette information dans votre broker/runtime.properties fichier.

  • 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 : nom d'utilisateur de la base de données si votre cluster Apache Druid est configuré pour utiliser la sécurité de base de Druid. Sinon, vous pouvez spécifier n'importe quelle chaîne.

  • Mot de passe : mot de passe de l'utilisateur. Si votre cluster n'est pas configuré pour utiliser la sécurité de base de Druid, vous pouvez spécifier n'importe quelle chaîne.

  • Schéma : schéma par défaut à utiliser lorsqu'aucun schéma n'est indiqué. La saisie d'un schéma est facultative.

  • Paramètres JDBC supplémentaires : paramètres JDBC JDBC Avatica délimités par des points-virgules. Pour obtenir la liste des paramètres compatibles avec Looker, consultez la section Paramètres JDBC compatibles sur cette page.

    • 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

  • Maintenance Schedule (Plan de maintenance) : 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 Plan de maintenance.

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

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

  • Max connections per node (Nombre maximal de connexions par nœud) : la valeur par défaut est 25. Vous pouvez laisser ce paramètre sur sa valeur par défaut au début. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données.

  • Connection Pool Timeout (Délai avant expiration du pool de connexions) : la valeur par défaut est 120 secondes.

  • SQL Runner Precache (Pré-cache de l'exécuteur SQL) : pour que l'exécuteur SQL ne précharge pas les informations d'une table et les charge uniquement lorsque la table est sélectionnée, désélectionnez cette option. Pour en savoir plus sur ce paramètre, consultez la documentation Pré-cache de l'Exécuteur SQL.

  • 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 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.

Looker exécute une requête SELECT 1 pour vérifier une connexion de base et effectuer un test de requête. Cela ne permet pas de confirmer 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 notre documentation Tester les connexions.

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

Testez la connexion dans l'Exécuteur SQL. Accédez à 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.

Paramètres JDBC compatibles

Pour Apache Druid, Looker est compatible avec les paramètres JDBC suivants dans le champ Additional JDBC parameters (Paramètres JDBC supplémentaires) pour la connexion. Pour en savoir plus sur ces paramètres, consultez la documentation de votre base de données.

  • authentication
  • avatica_password
  • avatica_user
  • serialization
  • sqlTimeZone
  • timeZone
  • useApproximateCountDistinct
  • useApproximateTopN
  • useFallback
  • url

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.

Apache Druid

Depuis Looker 26.8, Apache Druid est compatible avec les fonctionnalités suivantes :

Fonctionnalité Compatibilité
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 SQL Runner
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
Agendas personnalisés

Apache Druid 0.13.x - 0.17.x

Depuis Looker 26.8, Apache Druid 0.13.x - 0.17.x est compatible avec les fonctionnalités suivantes :

Fonctionnalité Compatibilité
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 SQL Runner
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
Agendas personnalisés

Apache Druid 0.18+

Depuis Looker 26.8, Apache Druid 0.18+ est compatible avec les fonctionnalités suivantes :

Fonctionnalité Compatibilité
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 SQL Runner
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
Agendas personnalisés

Étapes suivantes

Une fois la connexion à la base de données établie, configurez les options d'authentification.