Connecter un catalogue de données à ClickHouse Cloud

Connectez ClickHouse Cloud à vos catalogues de données pour accéder à vos tables aux formats de table ouverts. Vous pouvez configurer des connexions dans l’interface Sources de données. Pour effectuer la configuration via SQL, utilisez le moteur de base de données DataLakeCatalog dans l’éditeur SQL de votre choix. Une fois la connexion établie, les tables du catalogue s’affichent dans la console SQL sous le nom de base de données de votre choix. Vous pouvez les interroger avec du SQL ClickHouse standard, les joindre à des tables MergeTree et les utiliser comme sources pour des vues matérialisées.

Prérequis

Avant de connecter un catalogue, vérifiez les éléments suivants :

Autorisations du service. Vous devez disposer de l’autorisation control-plane:service:manage pour accéder à la page Sources de données et ajouter des catalogues.
Service en cours d’exécution. Si le service est inactif, réactivez-le depuis la page Sources de données ou les paramètres du service avant de connecter ou d’afficher des catalogues associés.
Identifiants du catalogue. Rassemblez les informations de connexion correspondant à votre type de catalogue avant d’ouvrir le panneau latéral. Chaque catalogue utilise des champs et des mécanismes d’authentification différents ; consultez Ajouter la connexion à votre catalogue ci-dessous.

Connectez votre catalogue

Ajoutez la connexion à votre catalogue

Sélectionnez votre catalog ci-dessous pour obtenir les instructions et les prérequis. Renseignez ensuite les paramètres de connection, ainsi qu’un Database name — la database ClickHouse qui expose les tables de votre catalog dans la SQL Console.

Le catalogue AWS Glue expose les tables Iceberg enregistrées dans le Glue Data Catalog.Avant de vous connecter, vérifiez les éléments suivants :

ClickHouse version 25.12 ou ultérieure.
Les tables Iceberg sont enregistrées dans le Glue Data Catalog AWS dans votre Region cible.
Pour l’authentification par clé d’accès, vous disposez d’une clé d’accès d’utilisateur IAM autorisée à lire les métadonnées Glue et les objets S3 sous-jacents.
Pour l’authentification par rôle IAM (26.2+), vous disposez d’un rôle IAM qui fait confiance à votre rôle de service ClickHouse. Incluez l’ARN du rôle de service figurant dans Settings → Network security information dans la stratégie d’approbation du rôle. Consultez Accéder aux données Iceberg de manière sécurisée pour obtenir des exemples de stratégies IAM.

Dans le flyout, saisissez votre Region AWS (par exemple, us-west-2), puis choisissez une méthode d’authentification :Authentification par clé d’accès

Sélectionnez AWS Access Key comme Authentication method.
Saisissez votre Access Key ID et votre Secret Access Key.
Saisissez un Database name pour la base de données ClickHouse qui expose vos tables Glue.

Authentification par rôle IAM (26.2+)

Sélectionnez AWS IAM Role comme Authentication method.
Copiez le Service role ID (IAM) depuis le panneau flyout et ajoutez-le à la stratégie d’approbation de votre rôle IAM.
Saisissez votre AWS Role ARN ainsi qu’un AWS Role Session Name facultatif.
Saisissez un Database name pour la base de données ClickHouse qui expose vos tables Glue.

Glue prend en charge plusieurs formats de tables, mais ClickHouse lit uniquement les tables Iceberg depuis Glue.

Interrogez les tables Iceberg Unity Catalog qui utilisent des emplacements de stockage externes, à l’aide des identifiants client OAuth d’un principal de service Databricks. Consultez le guide Unity Catalog pour connaître la procédure de configuration complète.Avant de vous connecter, vérifiez les points suivants :

Vous utilisez ClickHouse version 25.12 ou ultérieure.
Unity Catalog est configuré pour l’accès aux données externes.
Vous disposez d’un principal de service Databricks avec un ID client OAuth et un secret client. Ce principal de service dispose des privilèges USE CATALOG, USE SCHEMA, USE EXTERNAL SCHEMA et SELECT sur les tables que vous souhaitez interroger.

Dans le volet déroulant :

Saisissez l’URL de l’espace de travail Databricks (par exemple, dbc-1234567a-cbde.cloud.databricks.com).
Saisissez le nom du catalog Databricks auquel vous connecter (par exemple, icebench).
Saisissez l’ID client OAuth et le secret client de votre principal de service.
Saisissez un nom de base de données pour la base de données ClickHouse exposant vos tables Unity Catalog.

Interrogez les tables Unity Catalog Delta Lake utilisant des emplacements de stockage externes à l’aide d’un jeton d’accès personnel (PAT) Databricks. Consultez le guide Unity Catalog pour connaître la procédure de configuration complète.Avant de vous connecter, vérifiez les points suivants :

ClickHouse version 25.12 ou ultérieure.
Unity Catalog est configuré pour l’accès aux données externes.
Un jeton d’accès personnel Databricks disposant au minimum des autorisations EXTERNAL USE SCHEMA, USE CATALOG, USE SCHEMA et SELECT sur les tables cibles.

Dans le panneau latéral :

Saisissez l’URL de l’espace de travail Databricks (par exemple, dbc-1234567a-cbde.azuredatabricks.net).
Saisissez le nom du catalogue Databricks auquel vous souhaitez vous connecter.
Saisissez votre jeton d’accès personnel.
Saisissez un nom de base de données pour la base de données ClickHouse exposant vos tables Delta.

Iceberg et Delta utilisent des méthodes d’authentification différentes dans l’UI. Deux bases de données ClickHouse distinctes sont nécessaires pour accéder aux deux types de tables.

Connectez-vous à tout catalogue compatible avec la spécification Iceberg REST Catalog. Consultez le guide du catalogue REST pour connaître la procédure de configuration complète.Avant de vous connecter, vérifiez les points suivants :

Vous utilisez ClickHouse version 25.12 ou ultérieure.
Le endpoint de votre catalogue REST est accessible depuis ClickHouse Cloud.
Vous disposez d’identifiants client OAuth ou d’un jeton Bearer, selon la configuration de votre catalogue.
Vous disposez d’un URI S3 ou compatible pour le endpoint de stockage des données de table (par ex. s3://my-bucket/path).

Dans le volet latéral :

Saisissez l’URL du catalogue (par ex. https://catalog.example.com/v1).
Saisissez l’entrepôt ou l’espace de noms du catalogue (par ex. demo).
Saisissez le préfixe d’URI du endpoint de stockage pour le stockage des tables.
Sélectionnez une méthode d’authentification : Identifiants client OAuth ou Jeton Bearer, puis saisissez les identifiants correspondants.
Saisissez un nom de base de données pour la base de données ClickHouse qui expose les tables de votre catalogue REST.

Connectez-vous à un déploiement Snowflake Open Catalog (Polaris) pour les tables Iceberg. Consultez le guide du catalogue Polaris pour obtenir les instructions de configuration complètes.Avant de vous connecter, vérifiez les points suivants :

Vous utilisez ClickHouse version 26.2 ou ultérieure.
Vous disposez d’un catalogue Polaris avec des identifiants client OAuth.
Vous disposez d’un URI d’endpoint de stockage pour les données des tables Iceberg (par exemple, s3://company-iceberg-prod/warehouse/).

Dans le flyout :

Saisissez l’identifiant du compte de catalogue (par exemple, ab12345.snowflakecomputing.com).
Saisissez le nom du catalogue (par exemple, snowflake_open_catalog).
Saisissez l’ID client OAuth et le secret client.
Saisissez le préfixe d’URI de l’endpoint de stockage pour le stockage des tables.
Saisissez un nom de base de données pour la base de données ClickHouse qui expose vos tables Polaris.

Connectez-vous à Google Cloud BigLake Metastore (aussi appelé Lakehouse runtime catalog) pour les tables Iceberg stockées dans GCS. Consultez le guide BigLake Metastore pour connaître la procédure de configuration complète.Avant de vous connecter, vérifiez les points suivants :

Version 26.2 ou ultérieure de ClickHouse.
Vous disposez d’une instance BigLake Metastore contenant des tables Iceberg dans GCS.
Vous disposez d’identifiants Google Application Default Credentials (ADC), notamment d’un ID client, d’un secret client, d’un jeton d’actualisation et d’un ID de projet de quota.

Dans le flyout :

Saisissez votre ID client Google ADC, votre secret client, votre jeton d’actualisation et votre ID de projet de quota.
Saisissez l’URI du bucket Cloud Storage contenant les données des tables (par exemple, gs://biglake-public-nyc-taxi-iceberg).
Saisissez un nom de base de données pour la base de données ClickHouse qui expose vos tables BigLake.

Enregistrer la connexion

Après avoir renseigné les champs :

Cliquez sur Add catalog. ClickHouse valide la connexion et les identifiants lors de l’enregistrement.
En cas de réussite, une notification de confirmation s’affiche avec un lien View in SQL console. Votre catalogue apparaît dans la table Linked catalogs, avec son état de connexion et le nombre de tables.

Dans le menu Actions d’une ligne de catalogue lié, vous pouvez supprimer la connexion au catalogue. Cette opération supprime la base de données du catalogue dans ClickHouse, mais ne supprime aucune donnée de votre catalogue externe.

Interrogez vos données

Afficher les tables de votre catalogue

Sur la page Sources de données, repérez votre catalogue dans le tableau Catalogues liés, puis cliquez sur Afficher les tables.ClickHouse ouvre la Console SQL avec la base de données de votre catalogue sélectionnée et affiche la liste des tables disponibles.

Les tables peuvent ne pas apparaître immédiatement après la connexion d’un catalogue. Selon le catalogue, leur affichage peut prendre jusqu’à 3 minutes.

Exécuter une requête

Saisissez une requête dans l’éditeur SQL, puis cliquez sur Run. Placez le nom complet de la table entre accents graves :

SELECT * FROM `identity_profiles.identity_profiles_iceberg`

Résolution des problèmes

Si vous ne voyez pas vos tables dans la console SQL : vérifiez les identifiants, l’accès réseau et les types de tables dans le catalogue. Assurez-vous que les tables attendues utilisent des formats de fichiers et de tables pris en charge.

Voir aussi

Accélérer les analyses sur les données lakehouse — charger les tables du catalogue dans MergeTree pour les requêtes récurrentes
Accéder aux données Iceberg en toute sécurité — configuration du rôle IAM pour accéder à AWS Iceberg et Glue

​Prérequis

​Connectez votre catalogue

​Interrogez vos données

​Résolution des problèmes

​Voir aussi

Prérequis

Connectez votre catalogue

Interrogez vos données

Résolution des problèmes

Voir aussi