ClickHouse

Looker est compatible avec ClickHouse version 0.2 ou ultérieure.

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.

Pour activer le chiffrement SSL côté serveur, consultez la documentation de ClickHouse.

Utilisateurs et sécurité

Commencez par configurer votre utilisateur Looker sur le serveur ClickHouse. Les utilisateurs de la base de données ClickHouse ne sont pas créés avec la commande CREATE USER traditionnelle. Suivez le document Droits d'accès de ClickHouse pour configurer la section users du fichier users.xml. Voici un exemple de base:

<!-- Users and ACL. -->
<users>
    <looker>
        <password>CHANGEIT</password>
        <networks incl="networks" />
        <profile>default</profile>
        <quota>default</quota>
    </looker>

    <web>
        <password></password>
        <networks incl="networks" />
        <profile>web</profile>
        <quota>default</quota>
        <allow_databases>
           <database>test</database>
        </allow_databases>
        <allow_dictionaries>
           <dictionary>test</dictionary>
        </allow_dictionaries>
    </web>
</users>

Dans ce fichier, configurez également l'accès approprié à la base de données:

<allow_databases>
    <database>database_1</database>
    <database>database_2</database>
    <database>database_3</database>
</allow_databases>

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:

  • Dialecte: ClickHouse.
  • Hôte: nom d'hôte accessible.
  • Port: port sur lequel le service ClickHouse est accessible via HTTP(S).
    • Par défaut, les connexions HTTP utilisent le 8123 et le HTTPS 8443.
    • Les ports 9000 et 9440 sont utilisés par défaut par le client de ligne de commande ClickHouse, mais Looker ne peut pas les utiliser pour se connecter à ClickHouse.
    • Votre administrateur ClickHouse peut avoir choisi d'autres ports avec les paramètres http_port/https_port dans la configuration de ClickHouse. Demandez à votre administrateur ClickHouse les paramètres adaptés à votre configuration locale.
  • Base de données: nom de la base de données (doit correspondre à l'une des bases de données autorisées dans le fichier users.xml).
  • Username (Nom d'utilisateur) : nom d'utilisateur de la base de données.
  • Password (Mot de passe) : mot de passe de la base de données.
  • Paramètres JDBC supplémentaires (facultatif) : paramètres de chaîne JDBC supplémentaires.
  • Programmation de maintenance des groupes de données et des PDT: ClickHouse n'accepte pas les PDT. Vous pouvez donc ignorer ce message.
  • SSL: cochez cette case pour vous connecter à ClickHouse via SSL.
  • Valider SSL: (facultatif) cochez cette case pour appliquer une validation stricte du nom d'hôte sur le serveur ClickHouse. Ne sélectionnez cette option que si vous utilisez un certificat SSL signé par une autorité de certification généralement approuvée. Si vous utilisez un certificat SSL autosigné, laissez cette option décochée.

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.

Pour enregistrer ces paramètres, cliquez sur Connecter.

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.

ClickHouse 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
Oui
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
Oui
Centile
Oui
Centile distinct
Non
Processus d'affichage de l'exécuteur SQL
Oui
Table de description de l'exécuteur SQL
Oui
Afficher les index de l'exécuteur SQL
Non
SQL Runner Select 10
Oui
Nombre d'exécuteurs SQL
Oui
SQL Explain
Non
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
Non
Microsecondes
Non
Vues matérialisées
Non
Nombre approximatif distinct
Non