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 les rapports et les analyses dans Looker, ce qui facilite 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 0.2 ou version ultérieure, et ClickHouse 26 ou version ultérieure à l'aide de pilotes JDBC modernisés et de 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 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 sur les paramètres du serveur global 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 entre Looker et 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 de ligne de commande TCP natif de ClickHouse, mais Looker doit utiliser des ports HTTP(S) pour se connecter à ClickHouse.
  • Votre administrateur ClickHouse peut avoir choisi d'autres ports avec les paramètres http_port ou https_port dans la configuration ClickHouse. Demandez à votre administrateur ClickHouse les paramètres approprié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 option pour vous connecter à ClickHouse via SSL/TLS.
• Vérifier SSL : (facultatif) cochez cette option 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 approuvée. 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 est établie, 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 Connexion possible, 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 de la section Administration de Looker.

Paramètres JDBC compatibles

Pour ClickHouse, Looker accepte les paramètres JDBC suivants dans le champ Paramètres JDBC supplémentaires de la connexion. Pour en savoir plus sur ces paramètres, consultez la documentation de votre base de données.

Plus de 26 paramètres ClickHouse

• 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
• ssl_mode
• transactionSupport
• use_server_time_zone
• use_time_zone
• wait_for_async_insert
• wrapperObject

Paramètres ClickHouse (ancien)

• 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+

ClickHouse 26 et versions ultérieures sont compatibles avec les fonctionnalités suivantes à partir de Looker 26.20 :

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
Pivots 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 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 d'exécuteurs SQL
SQL Explain
Identifiants OAuth 2.0
Commentaires sur le contexte
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 d'analyse 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.20 :

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
Pivots 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 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 d'exécuteurs SQL
SQL Explain
Identifiants OAuth 2.0
Commentaires sur le contexte
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 d'analyse 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.