Prérequis
Avant de commencer ce guide de démarrage rapide, vous devez disposer de :
To successfully follow this guide, you’ll need the following:
- A running ClickHouse Cloud service. If you don’t have one yet, complete the ClickHouse Cloud quick start first.
- D'un lac de données compatible Iceberg
- D'un Data Lake Catalog (URL + identifiants)
- Selon le type de catalogue de lac de données : des identifiants de stockage d'objets (par exemple, un stockage compatible S3)
- D'au moins une table Iceberg existante enregistrée dans le catalogue
Si vous n'avez pas encore de données dans votre catalogue Iceberg, vous pouvez importer ce jeu de données. Nous utiliserons pour la démonstration le jeu de données disponible ici.
Ce que vous allez créer
Dans ce guide de démarrage rapide, vous allez :
- Vous connecter à un REST Catalog Iceberg dans ClickHouse Cloud
- Créer une base de données ClickHouse adossée à ce catalogue
- Interroger directement une table Iceberg existante depuis ClickHouse
- Vérifier que ClickHouse lit les données depuis votre lac de données
À la fin, ClickHouse Cloud sera connecté à votre catalogue Iceberg et vous pourrez exécuter des requêtes SQL sur des tables Iceberg sans copier les données.
Créer une connexion DataLakeCatalog
Dans cette étape, vous allez vous connecter à votre Data Lake Catalog dans ClickHouse Cloud.
-
Ouvrez votre service ClickHouse Cloud.
-
Accédez à Data Sources → Connect to your Data Lake Catalog.
-
Sélectionnez votre Data Catalog dans la liste déroulante.
-
Renseignez le formulaire avec vos identifiants et informations de connexion. Pour Unity Catalog, saisissez :
- Open Table Format (Iceberg)
- Nom de la base de données ClickHouse. Il s'agit du nom de la base de données ClickHouse depuis laquelle vous interrogerez vos tables Iceberg.
- ID de l'espace de travail
- Nom du catalogue Databricks
- ID client
- Secret client
insérer des images
-
Enregistrez le catalogue. Vous devriez maintenant voir le Data Catalog s'afficher dans votre page Data Sources avec le nombre de tables disponibles dans la base de données.
Interroger une table Iceberg
Dans cette étape, vous allez interroger une table Iceberg depuis votre Data Catalog.
- En cliquant soit sur
Show Tables, soit surSQL Console, vous arriverez dans la console SQL avec votre nouvelle base de données matérialisée, connectée à votre lac de données. Si vous passez parSQL Console, changez la base de données dans la liste déroulante pour votre base de données Iceberg. - Vous devriez voir une ou plusieurs tables Iceberg dans votre arborescence de fichiers. Exécutez cette requête :
select * from iceberg_database.`iceberg_db.your_table`- ClickHouse renverra les lignes de votre table Iceberg.
Étapes suivantes
Maintenant que vous êtes connecté à votre lac de données, vous pouvez essayer d’écrire une table Iceberg dans ClickHouse.
