> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ClickHouse Cloud で Iceberg カタログに接続する方法

> ClickHouse Cloud をデータカタログに接続し、Iceberg テーブルをクエリする方法を学びます。

export const e_1 = undefined

export const e_0 = undefined

<a href="/docs/get-started/quickstarts/home" onClick={(e_0) => { e_0.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">データウェアハウジング</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## 前提条件
</div>

このクイックスタートを始める前に、以下を用意しておいてください。

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](/docs/get-started/setup/cloud) first.

- **Iceberg互換のデータレイク** へのアクセス
- **データレイクカタログ** (URL + 認証情報)
- データレイクカタログの種類に応じたオブジェクトストレージの認証情報 (例: S3互換ストレージ)
- カタログに登録済みのIcebergテーブルが少なくとも1つ

Icebergカタログにまだデータがない場合は、このデータセットをアップロードできます。ここではこのデータセットを使用して説明します。

<div id="what-youll-build">
  ## 構築するもの
</div>

このクイックスタートでは、次のことを行います。

* ClickHouse Cloud で Iceberg REST Catalog に接続する
* そのカタログを基盤とする ClickHouse データベースを作成する
* 既存の Iceberg テーブルを ClickHouse から直接クエリする
* ClickHouse がデータレイクからデータを読み取っていることを確認する

完了すると、ClickHouse Cloud が Iceberg カタログに接続され、データをコピーすることなく Iceberg テーブルに対して SQL クエリを実行できるようになります。

<Steps titleSize="h3">
  <Step title="DataLakeCatalog 接続を作成する" id="create-a-datalakecatalog-connection">
    このステップでは、ClickHouse Cloud で データレイクカタログ に接続します。

    1. ClickHouse Cloud サービスを開きます。

    2. **Data Sources â Connect to your Data Lake Catalog** に移動します。

    3. ドロップダウンでデータカタログを選択します。

    4. 認証情報と接続情報をフォームに入力します。
       Unity Catalog の場合は、次の項目を入力します。

       * Open Table Format (Iceberg)
       * ClickHouse データベース名。これは、Iceberg テーブルをクエリするために使用する ClickHouse データベースの名前になります。
       * Workspace ID
       * Databricks catalog name
       * Client ID
       * Client Secret

       **画像を挿入**

    5. カタログを保存します。すると、Data Sources ページに データカタログ が読み込まれ、データベース内で利用可能なテーブル数が表示されます。
  </Step>

  <Step title="Iceberg テーブルをクエリする" id="query-iceberg-table">
    このステップでは、データカタログ から Iceberg テーブルをクエリします。

    1. `Show Tables` または `SQL Console` のいずれかをクリックすると、SQL Console が開き、データレイクに接続された新しいデータベースが表示されます。`SQL Console` から開いた場合は、データベースのドロップダウンを Iceberg データベースに変更してください。
    2. ファイルツリーに 1 つ以上の Iceberg テーブルが表示されるはずです。次のクエリを実行します。

    ```sql theme={null}
    select * from iceberg_database.`iceberg_db.your_table`
    ```

    3. ClickHouse は Iceberg テーブルの行を返します。
  </Step>
</Steps>

<div id="next-steps">
  ## 次のステップ
</div>

データレイクへの接続が完了したので、次は ClickHouse で Icebergテーブルへの書き込みを試すことができます。

<Tip>
  クォートの扱いに注意してください。ClickHouse は 3 部構成のネームスペースをサポートしていないため、`schema.table` は引用符で囲む必要があります。
</Tip>

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99/EDr8ydtGBgFPOQea/images/academy.webp?fit=max&auto=format&n=EDr8ydtGBgFPOQea&q=85&s=27e92fc656183cc2f176211907a7aa49" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.webp" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/docs/get-started/quickstarts/home" onClick={(e_1) => { e_1.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>
</div>
