ClickHouse

Connectez Looker à votre base de données ClickHouse pour analyser vos données et créer des tableaux de bord interactifs. Cette connexion permet de rendre vos données ClickHouse disponibles pour la création de rapports et l'analyse dans Looker, ce qui favorise la prise de décisions directes basées sur les données.

Cette page vous explique comment configurer votre instance ClickHouse et les paramètres de connexion Looker, y compris comment chiffrer le trafic réseau, définir les autorisations utilisateur et examiner les fonctionnalités compatibles. 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. 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.

Pour activer le chiffrement SSL côté serveur, consultez la documentation Paramètres globaux du serveur 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. Suivez la documentation Droits d'accès ClickHouse pour configurer la section users dans le 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 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 Connexion de Looker à votre base de données. Voici quelques-uns des paramètres :

  • Dialect (Dialecte) : ClickHouse.
  • Host (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 port 8123 et les connexions HTTPS utilisent le port 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 http_port/https_port paramètres dans la configuration ClickHouse. Demandez à votre administrateur ClickHouse les paramètres adaptés à votre configuration locale.
  • Database (Base de données) : nom de la base de données (doit être l'une des bases de données autorisées dans le users.xml fichier).
  • 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.

  • Additional JDBC parameters (Paramètres JDBC supplémentaires) : (facultatif) paramètres de chaîne JDBC supplémentaires. Pour obtenir la liste des paramètres compatibles avec Looker, consultez la section Paramètres JDBC compatibles sur cette page.

  • Maintenance Schedule (Programme de suivi) : ClickHouse n'est pas compatible avec les PDT. Vous pouvez donc ignorer ce paramètre.

  • SSL : cochez cette case pour vous connecter à ClickHouse via SSL.

  • Vérifier SSL : (facultatif) cochez cette case pour appliquer une validation stricte du nom d'hôte sur le serveur ClickHouse. Ne cochez cette case 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é, ne cochez pas cette case.

Pour vérifier que la connexion a réussi, cliquez sur le bouton Test Connection (Tester la connexion) dans la section Status details (Détails de l'état) en bas de la page Connections Settings (Paramètres de connexion).

Si Looker affiche Can Connect (Peut se connecter), appuyez sur Connect (Se connecter) pour créer la connexion.

Votre connexion de base de données est ensuite ajoutée à la liste de la page de Looker Connections Admin.

Paramètres JDBC compatibles

Pour ClickHouse, 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.

  • beta.row_binary_for_simple_insert
  • compress
  • connection_timeout
  • continueBatchOnError
  • createDatabaseIfNotExist
  • custom_http_headers
  • custom_http_params
  • default_query_settings
  • disable_frameworks_detection
  • jdbc_ignore_unsupported_values
  • jdbc_resultset_auto_close
  • jdbc_sql_parser
  • jdbc_use_max_result_rows
  • jdbcCompliance
  • max_execution_time
  • password
  • session_timezone
  • socket_timeout
  • typeMappings
  • use_server_time_zone
  • use_time_zone
  • user
  • wrapperObject

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.

Depuis Looker 26.14, ClickHouse 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 l'exécuteur SQL
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
Modèles analytiques dans la base de données
Agendas personnalisés