Set up docs MCPConnectez 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:managepour 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
Ouvrez le panneau latéral du catalogue de données
- Sélectionnez Sources de données dans la navigation de gauche.
- Cliquez sur + Ajouter un catalogue si vous n’avez pas encore configuré de source de données. Sinon, cliquez sur Ajouter une source de données > Ajouter un catalogue de lac de données.
- Dans le panneau latéral Connecter votre catalogue de données, sélectionnez votre catalogue dans la liste déroulante Sélectionner un catalogue. Si le catalogue prend en charge plusieurs formats de table ouverts, choisissez-en un dans Format de table ouvert.
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.
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 SCHEMAetSELECTsur 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 SCHEMAetSELECTsur 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.
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.
Interrogez des tables Iceberg dans Microsoft Fabric OneLake à l’aide des identifiants d’une application Azure AD. Consultez le guide Fabric OneLake 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.
- Des tables Iceberg existent dans un espace de travail Fabric.
- Vous disposez d’une application Entra ID (Azure AD) avec un ID client et un secret.
- Vous disposez de votre ID de tenant, de votre ID d’espace de travail et d’un ID d’élément de données. Utilisez votre ID Lakehouse figurant dans l’URL de la page Lakehouse. Consultez les prérequis Microsoft OneLake pour savoir où trouver ces valeurs.
Dans le panneau latéral :
- Saisissez l’ID d’espace de travail Fabric.
- Saisissez l’ID d’élément de données — utilisez votre ID Lakehouse. Les ID d’entrepôt ne sont pas pris en charge.
- Saisissez votre ID de tenant Entra ID, votre ID d’application (client) et votre secret client.
- Saisissez un nom de base de données pour la base de données ClickHouse qui expose vos tables OneLake.
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.
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