> ## 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.

> データソース UI を使用して、ClickHouse Cloud で Iceberg または Delta Lake テーブル用のデータカタログに接続する方法。

# ClickHouse Cloud でデータカタログに接続する

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>ベータ</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>ベータ機能</span>
        </a>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<BetaBadge />

ClickHouse Cloud をデータカタログに接続すると、オープンテーブルフォーマットのテーブルにアクセスできます。接続は **データソース** UI で設定できます。SQL で設定する場合は、任意の SQL エディタで [`DataLakeCatalog`](/docs/ja/reference/engines/database-engines/datalake) データベースエンジンを使用します。

<Image img="https://mintcdn.com/private-7c7dfe99/NMEuR4JBQvfvT5BG/images/cloud/features/data-catalogs-ui.png?fit=max&auto=format&n=NMEuR4JBQvfvT5BG&q=85&s=23c85c7480fa5f37a9ab95aa2943fb10" size="md" alt="データカタログインテグレーションを表示する ClickHouse Cloud UI" width="4944" height="2610" data-path="images/cloud/features/data-catalogs-ui.png" />

接続後、カタログ内のテーブルは指定したデータベース名の下に SQL コンソールで表示されます。標準の ClickHouse SQL でクエリを実行したり、[MergeTree](/docs/ja/reference/engines/table-engines/mergetree-family/mergetree) テーブルと結合したり、[materialized view](/docs/ja/concepts/features/materialized-views) のソースとして使用したりできます。

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

カタログを接続する前に、以下を確認してください。

* **サービスの権限。** **データソース**ページにアクセスしてカタログを追加するには、`control-plane:service:manage`権限が必要です。
* **実行中のサービス。** サービスがアイドル状態の場合は、接続またはリンク済みカタログを表示する前に、**データソース**ページまたはサービス設定ページからサービスを起動してください。
* **カタログの認証情報。** フライアウトを開く前に、カタログの種類に応じた接続情報を用意してください。カタログごとに必要なフィールドと認証方法は異なります。以下の「[カタログ接続を追加する](#add-your-catalog-connection)」を参照してください。

<div id="connect-your-catalog">
  ## カタログに接続する
</div>

<Steps>
  <Step title="データカタログのフライアウトを開く" id="open-data-catalog-flyout">
    1. 左側のナビゲーションで**データソース**を選択します。
    2. データソースをまだ設定していない場合は、**+ カタログを追加**をクリックします。設定済みの場合は、**データソースを追加** > **データレイクカタログを追加**をクリックします。
    3. **データカタログに接続**フライアウトで、**カタログを選択**ドロップダウンからカタログを選択します。カタログが複数のオープンテーブルフォーマットに対応している場合は、**オープンテーブルフォーマット**でフォーマットを選択します。

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-flyout-select.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=d9db0300502c5a3504848e707b5030bd" alt="AWS Glue、BigLake Metastore、Microsoft OneLake、Polaris、REST Catalog、Unity Catalog が表示された［カタログを選択］ドロップダウンを含む［データカタログに接続］フライアウト" size="lg" width="4490" height="2842" data-path="images/integrations/data-catalogs/catalog-flyout-select.png" />
  </Step>

  <Step title="カタログ接続を追加する" id="add-your-catalog-connection">
    以下からカタログを選択し、手順と前提条件を確認してください。次に、接続パラメータと **データベース名** (SQLコンソールでカタログのテーブルを公開する ClickHouse データベース) を入力します。

    <Tabs>
      <Tab title="AWS Glue" id="aws-glue">
        [AWS Glue Catalog](/docs/ja/guides/use-cases/data-warehousing/glue-catalog) は、Glue Data Catalog に登録されている [Iceberg](/docs/ja/reference/engines/table-engines/integrations/iceberg) テーブルを公開します。

        接続する前に、以下を確認してください。

        * ClickHouse のバージョンが 25.12 以降であること。
        * Iceberg テーブルが、対象リージョンの AWS Glue Data Catalog に登録されていること。
        * アクセスキー認証の場合、Glue メタデータと基盤となる S3 オブジェクトの読み取り権限を持つ IAM ユーザーのアクセスキーがあること。
        * IAM ロール認証 (26.2 以降) の場合、ClickHouse サービスロールを信頼する IAM ロールがあること。ロールの信頼ポリシーに、**Settings → Network security information** に表示されるサービスロール ARN を含めてください。IAM ポリシーの例については、[Iceberg データへの安全なアクセス](/docs/ja/products/cloud/guides/data-sources/accessing-iceberg-data-securely)を参照してください。

        フライアウトで AWS **Region** (例: `us-west-2`) を入力し、認証方法を選択します。

        **アクセスキー認証**

        1. **Authentication method** として **AWS Access Key** を選択します。
        2. **Access Key ID** と **Secret Access Key** を入力します。
        3. Glue テーブルを公開する ClickHouse データベースの **Database name** を入力します。

        **IAM ロール認証 (26.2 以降) **

        1. **Authentication method** として **AWS IAM Role** を選択します。
        2. フライアウトパネルから **Service role ID (IAM)** をコピーし、IAM ロールの信頼ポリシーに追加します。
        3. **AWS Role ARN** と、任意の **AWS Role Session Name** を入力します。
        4. Glue テーブルを公開する ClickHouse データベースの **Database name** を入力します。

        <Note>
          Glue は複数のテーブルフォーマットをサポートしていますが、ClickHouse が Glue から読み取れるのは **Iceberg** テーブルのみです。
        </Note>
      </Tab>

      <Tab title="Unity Catalog（Iceberg）" id="unity-iceberg">
        Databricks サービスプリンシパルの OAuth クライアント認証情報を使用して、外部ストレージロケーションを使用する Unity Catalog の [Iceberg](/docs/ja/reference/engines/table-engines/integrations/iceberg) テーブルをクエリします。セットアップ手順の詳細については、[Unity Catalog ガイド](/docs/ja/guides/use-cases/data-warehousing/unity-catalog#read-iceberg)を参照してください。

        接続する前に、以下を確認してください。

        * ClickHouse バージョン 25.12 以降。
        * [Unity Catalog が外部データアクセス用に設定されていること](https://docs.databricks.com/aws/en/external-access/admin)。
        * OAuth クライアント ID とシークレットを持つ Databricks [サービスプリンシパル](https://docs.databricks.com/aws/en/dev-tools/auth/oauth-m2m)。サービスプリンシパルには、クエリするテーブルに対する `USE CATALOG`、`USE SCHEMA`、`USE EXTERNAL SCHEMA`、`SELECT` 権限が必要です。

        フライアウトで、次の操作を行います。

        1. Databricks の **Workspace URL** を入力します (例: `dbc-1234567a-cbde.cloud.databricks.com`) 。
        2. 接続する **Databricks カタログ名** を入力します (例: `icebench`) 。
        3. サービスプリンシパルの OAuth **Client ID** と **Client secret** を入力します。
        4. Unity Catalog テーブルを公開する ClickHouse データベースの **Database name** を入力します。
      </Tab>

      <Tab title="Unity Catalog（Delta）" id="unity-delta">
        Databricks Personal Access Token (PAT) を使用して、外部ストレージロケーションを使用する Unity Catalog の [Delta Lake](/docs/ja/reference/engines/table-engines/integrations/deltalake) テーブルをクエリできます。セットアップ手順の詳細については、[Unity Catalog ガイド](/docs/ja/guides/use-cases/data-warehousing/unity-catalog#read-delta)を参照してください。

        接続する前に、以下を確認してください。

        * ClickHouse のバージョンが 25.12 以降であること。
        * [Unity Catalog が外部データアクセス用に設定されている](https://docs.databricks.com/aws/en/external-access/admin)こと。
        * ターゲットテーブルに対する `EXTERNAL USE SCHEMA`、`USE CATALOG`、`USE SCHEMA`、`SELECT` の各権限を少なくとも持つ Databricks [Personal Access Token](https://docs.databricks.com/aws/en/dev-tools/auth/pat)。

        フライアウトで、以下を入力します。

        1. Databricks の **Workspace URL** (例: `dbc-1234567a-cbde.azuredatabricks.net`) 。
        2. 接続する **Databricks カタログ名**。
        3. **Personal Access Token**。
        4. Delta テーブルを公開する ClickHouse データベースの **Database name**。

        <Note>
          Iceberg と Delta では、UI 上で異なる認証方式を使用します。両方の種類のテーブルにアクセスするには、2 つの別個の ClickHouse データベースが必要です。
        </Note>
      </Tab>

      <Tab title="REST カタログ" id="rest">
        [Iceberg REST Catalog](https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml)仕様を実装している任意のカタログに接続できます。完全なセットアップ手順については、[REST カタログガイド](/docs/ja/guides/use-cases/data-warehousing/rest-catalog)を参照してください。

        接続する前に、以下を確認してください。

        * ClickHouse のバージョンが 25.12 以降であること。
        * ClickHouse Cloud から REST カタログのエンドポイントに到達できること。
        * カタログの設定に応じて、OAuth クライアント認証情報またはベアラートークンがあること。
        * テーブルデータ用の S3 または互換ストレージの**ストレージエンドポイント** URI (例: `s3://my-bucket/path`) があること。

        フライアウトで、次の操作を行います。

        1. **カタログ URL** (例: `https://catalog.example.com/v1`) を入力します。
        2. **Warehouse**またはカタログのネームスペース (例: `demo`) を入力します。
        3. テーブルストレージ用の**ストレージエンドポイント** URI のプレフィックスを入力します。
        4. **認証方法**として**OAuth クライアント認証情報**または**Bearer Token**を選択し、対応する認証情報を入力します。
        5. REST カタログのテーブルを公開する ClickHouse データベースの**データベース名**を入力します。
      </Tab>

      <Tab title="Microsoft OneLake" id="onelake">
        Azure AD アプリケーションの認証情報を使用して、Microsoft Fabric OneLake 内の [Iceberg](/docs/ja/reference/engines/table-engines/integrations/iceberg) テーブルにクエリを実行します。セットアップの詳細については、[Fabric OneLake ガイド](/docs/ja/guides/use-cases/data-warehousing/onelake-catalog)を参照してください。

        接続前に、以下を確認してください。

        * ClickHouse バージョンが 25.12 以降であること。
        * Fabric ワークスペースに Iceberg テーブルが存在すること。
        * クライアント ID とシークレットを持つ Entra ID (Azure AD) アプリケーションがあること。
        * テナント ID、ワークスペース ID、データ項目 ID を把握していること。Lakehouse ページの URL に含まれる **Lakehouse ID** を使用してください。これらの値の確認方法については、[Microsoft OneLake の前提条件](https://learn.microsoft.com/en-us/fabric/onelake/table-apis/table-apis-overview#prerequisites)を参照してください。

        フライアウトで、次の操作を行います。

        1. Fabric の **Workspace ID** を入力します。
        2. **Data Item ID** を入力します。Lakehouse ID を使用してください。Warehouse ID はサポートされていません。
        3. Entra ID の **Tenant ID**、**Application (client) ID**、**Client secret** を入力します。
        4. OneLake テーブルを公開する ClickHouse データベースの **Database name** を入力します。
      </Tab>

      <Tab title="Polaris" id="polaris">
        [Iceberg](/docs/ja/reference/engines/table-engines/integrations/iceberg)テーブル用のSnowflake Open Catalog (Polaris) デプロイメントに接続します。セットアップの詳細については、[Polaris catalogガイド](/docs/ja/guides/use-cases/data-warehousing/polaris-catalog)を参照してください。

        接続する前に、以下を確認してください。

        * ClickHouse バージョン26.2以降を使用していること。
        * OAuthクライアント認証情報を設定したPolaris catalogがあること。
        * Icebergテーブルデータ用のストレージendpoint URIがあること (例: `s3://company-iceberg-prod/warehouse/`) 。

        フライアウトで、次の情報を入力します。

        1. **Catalog Account Identifier** (例: `ab12345.snowflakecomputing.com`) を入力します。
        2. **Catalog Name** (例: `snowflake_open_catalog`) を入力します。
        3. OAuthの**Client ID**と**Client Secret**を入力します。
        4. テーブルストレージ用の**Storage Endpoint** URIプレフィックスを入力します。
        5. Polarisテーブルを公開するClickHouse databaseの**Database name**を入力します。
      </Tab>

      <Tab title="BigLake Metastore" id="biglake">
        GCS 内の [Iceberg](/docs/ja/reference/engines/table-engines/integrations/iceberg) テーブル用に、Google Cloud BigLake Metastore (Lakehouse runtime catalog とも呼ばれます) に接続します。セットアップの詳細については、[BigLake Metastore ガイド](/docs/ja/guides/use-cases/data-warehousing/biglake-catalog)を参照してください。

        接続前に、以下を確認してください。

        * ClickHouse のバージョンが 26.2 以降であること。
        * GCS 内の Iceberg テーブルを含む BigLake Metastore インスタンスがあること。
        * クライアント ID、クライアント シークレット、リフレッシュ トークン、割り当てプロジェクト ID を含む Google Application Default Credentials (ADC) があること。

        フライアウトで、次の操作を行います。

        1. **Google ADC Client ID**、**Client Secret**、**Refresh Token**、**Quota Project ID** を入力します。
        2. テーブルデータ用の **Cloud Storage Bucket** URI を入力します (例: `gs://biglake-public-nyc-taxi-iceberg`) 。
        3. BigLake テーブルを公開する ClickHouse データベースの **Database name** を入力します。
      </Tab>
    </Tabs>
  </Step>

  <Step title="接続を保存" id="save-connection">
    フィールドに入力したら:

    1. **カタログを追加**をクリックします。保存時に、ClickHouse が接続と認証情報を検証します。
    2. 成功すると、**SQL コンソールで表示**へのリンクを含む確認トーストが表示されます。カタログは、接続ステータスとテーブル数とともに **リンクされたカタログ**テーブルに表示されます。

    リンクされたカタログの行にある **アクション**メニューから、カタログ接続を削除できます。削除すると、ClickHouse からカタログのデータベースが削除されますが、外部カタログ内のデータは削除されません。
  </Step>
</Steps>

<div id="query-data">
  ## データをクエリする
</div>

<Steps>
  <Step title="カタログのテーブルを表示する" id="view-tables">
    **データソース**ページで、**リンク済みカタログ**テーブルからカタログを見つけ、**テーブルを表示**をクリックします。

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/linked-catalogs-table.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=0a1cc4e94f2ef096d9db5e5edf8699b6" alt="「テーブルを表示」操作を含むリンク済みカタログのテーブル" size="lg" width="3510" height="868" data-path="images/integrations/data-catalogs/linked-catalogs-table.png" />

    ClickHouse で SQL コンソールが開き、カタログデータベースが選択された状態で利用可能なテーブルが一覧表示されます。

    <Note>
      カタログを接続した直後は、テーブルが表示されないことがあります。カタログによっては、すべてのテーブルが一覧表示されるまでに最大 3 分かかる場合があります。
    </Note>

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-tables-browser.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=659600c739c761d3154018e338596fa6" alt="カタログのテーブルを表示する SQL コンソールのテーブルブラウザ" size="lg" width="3560" height="1578" data-path="images/integrations/data-catalogs/catalog-tables-browser.png" />
  </Step>

  <Step title="クエリを実行する" id="run-a-query">
    SQL エディタでクエリを記述し、**実行**をクリックします。完全なテーブル名をバッククォートで囲みます。

    ```sql theme={null}
    SELECT * FROM `identity_profiles.identity_profiles_iceberg`
    ```

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-sql-query.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=79bfd73f1b475795f1fd0e3c18950b50" alt="ドットを含むテーブル名をバッククォートで囲んだ、結果付きの SQL クエリ" size="lg" width="2810" height="1172" data-path="images/integrations/data-catalogs/catalog-sql-query.png" />
  </Step>
</Steps>

<div id="troubleshooting">
  ## トラブルシューティング
</div>

* SQL コンソールにテーブルが表示されない場合は、カタログ内の認証情報、ネットワークアクセス、テーブルの種類を確認してください。表示したいテーブルが、サポートされているファイル形式およびテーブル形式であることを確認してください。

<div id="see-also">
  ## 関連項目
</div>

* [レイクハウスデータの分析を高速化](/docs/ja/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) — 繰り返し実行するクエリに備え、カタログテーブルをMergeTreeに読み込む
* [Icebergデータへの安全なアクセス](/docs/ja/products/cloud/guides/data-sources/accessing-iceberg-data-securely) — AWS IcebergおよびGlueへのアクセスに必要なIAMロールの設定