Notez que vous consultez la documentation Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Click-House

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

Chiffrement du trafic réseau

Il est vivement conseillé de chiffrer le trafic réseau entre l'application Looker et votre base de données. Choisissez l'une des options décrites dans la page Activer l'accès sécurisé aux bases 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 classique. Suivez le document ClickHouse Access Rights pour configurer la section users dans le fichier users.xml. Voici un exemple basique:

<!-- 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>

Toujours dans ce fichier, configurez l'accès à la base de données appropriée:

<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 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:

Dialect: 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 code 8123 tandis que le protocole HTTPS utilise le code 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 a peut-être choisi d'autres ports avec les paramètres http_port/https_port dans la configuration ClickHouse. Demandez à votre administrateur ClickHouse de vous indiquer les paramètres adaptés à votre configuration locale.
Base de données: nom de la base de données (il doit s'agir de l'une des bases de données autorisées dans le fichier users.xml).
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.
Calendrier de maintenance des groupes de données et des tables dérivées persistantes: ClickHouse n'est pas compatible avec les tables dérivées persistantes. Vous pouvez donc l'ignorer.
SSL: cochez cette case pour vous connecter à ClickHouse via SSL.
Vérifier la conformité avec la norme SSL (facultatif) : cochez cette option pour appliquer une validation stricte du nom d'hôte sur le serveur ClickHouse. Ne vérifiez cette option que si vous utilisez un certificat SSL signé par une autorité de certification généralement fiable. Si vous utilisez un certificat SSL autosigné, laissez-le décoché.

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.

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 est compatible 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	Oui
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	Oui
Centile	Oui
Centile distinct	Non
Processus d'affichage de l'exécuteur SQL	Oui
Table "Décrire" de l'exécuteur SQL	Oui
Index d'émissions SQL Runner	Non
Exécuteur SQL 10	Oui
Nombre d'exécuteurs SQL	Oui
SQL Explain	Non
Identifiants OAuth	Non
Commentaires contextuels	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