Set up docs MCPデータウェアハウジングCloud
前提条件
このクイックスタートを始める前に、以下を用意しておいてください。
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.
- Iceberg互換のデータレイク へのアクセス
- データレイクカタログ (URL + 認証情報)
- データレイクカタログの種類に応じたオブジェクトストレージの認証情報 (例: S3互換ストレージ)
- カタログに登録済みのIcebergテーブルが少なくとも1つ
Icebergカタログにまだデータがない場合は、このデータセットをアップロードできます。ここではこのデータセットを使用して説明します。
構築するもの
このクイックスタートでは、次のことを行います。
- ClickHouse Cloud で Iceberg REST Catalog に接続する
- そのカタログを基盤とする ClickHouse データベースを作成する
- 既存の Iceberg テーブルを ClickHouse から直接クエリする
- ClickHouse がデータレイクからデータを読み取っていることを確認する
完了すると、ClickHouse Cloud が Iceberg カタログに接続され、データをコピーすることなく Iceberg テーブルに対して SQL クエリを実行できるようになります。
DataLakeCatalog 接続を作成する
このステップでは、ClickHouse Cloud で データレイクカタログ に接続します。
-
ClickHouse Cloud サービスを開きます。
-
Data Sources â Connect to your Data Lake Catalog に移動します。
-
ドロップダウンでデータカタログを選択します。
-
認証情報と接続情報をフォームに入力します。 Unity Catalog の場合は、次の項目を入力します。
- Open Table Format (Iceberg)
- ClickHouse データベース名。これは、Iceberg テーブルをクエリするために使用する ClickHouse データベースの名前になります。
- Workspace ID
- Databricks catalog name
- Client ID
- Client Secret
画像を挿入
-
カタログを保存します。すると、Data Sources ページに データカタログ が読み込まれ、データベース内で利用可能なテーブル数が表示されます。
Iceberg テーブルをクエリする
このステップでは、データカタログ から Iceberg テーブルをクエリします。
Show TablesまたはSQL Consoleのいずれかをクリックすると、SQL Console が開き、データレイクに接続された新しいデータベースが表示されます。SQL Consoleから開いた場合は、データベースのドロップダウンを Iceberg データベースに変更してください。- ファイルツリーに 1 つ以上の Iceberg テーブルが表示されるはずです。次のクエリを実行します。
select * from iceberg_database.`iceberg_db.your_table`- ClickHouse は Iceberg テーブルの行を返します。
次のステップ
データレイクへの接続が完了したので、次は ClickHouse で Icebergテーブルへの書き込みを試すことができます。
