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 de documentation Sécurisation de l'accès à 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 de COUNT DISTINCT (facultatif)

Par défaut, Druid approxime 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. Voici quelques-uns des paramètres :

• Nom : nom de la connexion.

• Dialect : 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 du cluster. 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 : 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 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 indiqué. La saisie d'un schéma est facultative.

• Paramètres JDBC supplémentaires : paramètres JDBC Avatica délimités par des points-virgules.

  • 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

• Planning 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 Calendrier de maintenance.

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

• Valider le protocole 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 de 25. Vous pouvez conserver la valeur par défaut indiquée. Pour en savoir plus, consultez la page de documentation Connecter Looker à votre base de données.

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

• Effectuer une mise en cache préalable de l'exécuteur SQL : pour que SQL Runner 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échargement de SQL Runner.

• 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 obtenir des informations sur le dépannage, consultez la page de documentation Tester la connectivité à 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 permettra 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.

En cas de problème, consultez notre documentation sur le test 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é 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

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

Apache Druid 0.13+ (Apache Druid 0.13.x à 0.17.x)

Apache Druid 0.13+ est compatible avec les fonctionnalités suivantes à partir de Looker 25.10 :

Apache Druid 0.18+

Apache Druid 0.18+ est compatible avec les fonctionnalités suivantes à partir de Looker 25.10 :

Étapes suivantes

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