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, et ClickHouse 26+ à 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 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 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 des 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 ClickHouse, mais les ports HTTP(S) doivent être utilisés par Looker 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 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 SSL : (facultatif) cochez cette case pour appliquer une validation stricte du certificat SSL et du nom d'hôte sur le serveur ClickHouse. Sélectionnez Vérifier 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 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 compatibles

Pour ClickHouse, Looker est compatible avec 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.

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 (hérités)

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

Compatibilité avec les fonctionnalités ClickHouse 26+

ClickHouse 26+ est compatible avec les fonctionnalités suivantes à partir de Looker 26.20 :

Compatibilité avec les fonctionnalités ClickHouse

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

Étapes suivantes

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