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 vous aide à prendre des décisions directement basées sur les données.

Cette page vous guide dans la configuration de votre instance ClickHouse et de vos paramètres de connexion Looker, y compris pour 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, et ClickHouse 26+ utilisant des pilotes JDBC modernisés et la prise en charge de l'agrégation symétrique.

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.

Pour activer le chiffrement SSL côté serveur, consultez la documentation sur les 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 peuvent être configurés à l'aide de SQL (CREATE USER) ou via la section users du fichier users.xml. Suivez la documentation sur les droits d'accès ClickHouse pour configurer l'accès des utilisateurs. L'exemple de base suivant utilise users.xml :

<!-- 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. Voici quelques-uns de ces paramètres :

• Dialecte : sélectionnez ClickHouse 26+ ou ClickHouse.
• Hôte : nom d'hôte ou adresse IP accessible du serveur ClickHouse.
• Port : port sur lequel le service ClickHouse est accessible via HTTP(S).
  • Par défaut, les connexions HTTP utilisent 8123 et les connexions HTTPS utilisent 8443.
  • Les ports 9000 et 9440 sont utilisés par défaut par le client en ligne de commande TCP natif de ClickHouse, mais Looker doit utiliser les ports HTTP(S) pour se connecter à ClickHouse.
  • Il est possible que votre administrateur ClickHouse ait choisi d'autres ports avec les paramètres http_port ou https_port dans la configuration ClickHouse. Demandez à votre administrateur ClickHouse les paramètres adaptés à votre configuration.
• Base de données : nom de la base de données (doit être l'une des bases de données autorisées dans vos autorisations ClickHouse).
• Nom d'utilisateur : nom d'utilisateur de la base de données.
• Mot de passe : mot de passe de la base de données.
• SSL : cochez cette case pour vous connecter à ClickHouse via SSL/TLS.
• Vérifier le protocole SSL : (facultatif) cochez cette case pour appliquer une vérification stricte du certificat SSL et du nom d'hôte sur le serveur ClickHouse. Sélectionnez Vérifier le certificat SSL uniquement si vous utilisez un certificat SSL signé par une autorité de certification généralement fiable. Si vous utilisez un certificat SSL autosigné, laissez ce paramètre décoché.
• Paramètres JDBC supplémentaires : (facultatif) paramètres de chaîne JDBC supplémentaires. Pour obtenir la liste des paramètres JDBC compatibles avec Looker, consultez la section Paramètres JDBC compatibles sur cette page.

Pour vérifier que la connexion a réussi, cliquez sur le bouton Tester la connexion dans la section Détails de l'état en bas de la page Paramètres de connexion.

Si Looker affiche Peut se connecter, appuyez sur Connecter pour créer la connexion.

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

Paramètres JDBC acceptés

Pour ClickHouse, Looker est compatible avec les paramètres JDBC suivants dans le champ 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.

Paramètres ClickHouse 26+

• async_insert
• autoCommit
• compress
• compress_algorithm
• compress_level
• connect_timeout
• connection_timeout
• continueBatchOnError
• createDatabaseIfNotExist
• custom_settings
• database
• databaseTerm
• externalDatabase
• fetchSize
• format
• jdbcCompliant
• keep_alive_timeout
• max_buffer_size
• max_execution_time
• max_result_bytes
• max_result_rows
• max_threads
• namedParameter
• query_timeout
• receive_timeout
• result_overflow_mode
• retry
• session_check
• session_id
• session_timeout
• session_timezone
• socket_timeout
• ssl
• sslmode
• transactionSupport
• use_server_time_zone
• use_time_zone
• wait_for_async_insert
• wrapperObject

Paramètres ClickHouse (ancienne version)

• 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

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.

Compatibilité avec les fonctionnalités de ClickHouse 26+

À partir de Looker 26.18, ClickHouse 26+ 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 persistantes basées sur SQL
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
Sensible à la casse
Type de lieu
Type de liste
Centile
Centile distinct
Afficher les processus de l'exécuteur SQL
Décrire la table dans l'exécuteur SQL
Afficher les index dans l'Exécuteur SQL
Sélectionner 10 exécuteurs SQL
Nombre d'exécuteurs 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

Fonctionnalités ClickHouse compatibles

ClickHouse est compatible avec les fonctionnalités suivantes à partir de Looker 26.18 :

Fonctionnalité	Compatibilité
Looker (Google Cloud Core)
Agrégations symétriques
Tables dérivées
Tables dérivées persistantes basées sur SQL
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
Sensible à la casse
Type de lieu
Type de liste
Centile
Centile distinct
Afficher les processus de l'exécuteur SQL
Décrire la table dans l'exécuteur SQL
Afficher les index dans l'Exécuteur SQL
Sélectionner 10 exécuteurs SQL
Nombre d'exécuteurs 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

Étapes suivantes

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