> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# サポートマトリクス

> ClickHouse のオープンテーブルフォーマットのインテグレーションとデータカタログ接続に関する包括的なサポートマトリクス。

このページでは、ClickHouse のデータレイクインテグレーションに関する包括的なサポートマトリクスを紹介します。各オープンテーブルフォーマットで利用できる機能、ClickHouse が接続可能なカタログ、および各カタログでサポートされている機能をまとめています。

サポート状況は、ClickHouse Cloud とセルフマネージド ClickHouse で分けて示しています。実験的機能は ClickHouse Cloud ではデフォルトで無効になっており、[サポートを通じてリクエストする必要があります](https://clickhouse.com/blog/common-getting-started-issues-with-clickhouse#13-experimental-features-in-production)。利用可否は機能によって異なるため、特定の実験的機能を有効にできるかどうかはサポートにお問い合わせください。デプロイメント固有の設定と制限事項は、Notes カラムに記載されています。

<h2 id="format-support">
  オープンテーブルフォーマットのサポート
</h2>

ClickHouse は、[Apache Iceberg](/ja/reference/engines/table-engines/integrations/iceberg)、[Delta Lake](/ja/reference/engines/table-engines/integrations/deltalake)、[Apache Hudi](/ja/reference/engines/table-engines/integrations/hudi)、[Apache Paimon](/ja/reference/functions/table-functions/paimon) の 4 つのオープンテーブルフォーマットに対応しています。サポートマトリクスを表示するには、以下からフォーマットを選択してください。

**凡例:** ✅ 対応 | ⚠️ 一部対応、実験的、または非推奨 | ❌ 未対応

<Tabs>
  <Tab title="Apache Iceberg">
    | 機能 | ClickHouse Cloud | セルフマネージド | 注記 |
    | - | :-: | :-: | - |
    | **ストレージバックエンド** | | | |
    | AWS S3 | ✅ | ✅ | [`icebergS3()`](/ja/reference/functions/table-functions/iceberg) または `iceberg()` のエイリアス経由 |
    | GCS | ✅ | ✅ | [`icebergS3()`](/ja/reference/functions/table-functions/iceberg) または `iceberg()` のエイリアス経由 |
    | Azure Blob Storage | ✅ | ✅ | [`icebergAzure()`](/ja/reference/functions/table-functions/iceberg) 経由 |
    | HDFS | ❌ | ⚠️ 非推奨 | [`icebergHDFS()`](/ja/reference/functions/table-functions/iceberg) 経由 |
    | ローカルファイルシステム | ❌ | ✅ | [`icebergLocal()`](/ja/reference/functions/table-functions/iceberg) 経由 |
    | **アクセス方法** | | | |
    | テーブル関数 | ✅ | ✅ | バックエンドごとにバリアントがある [`icebergS3()`](/ja/reference/functions/table-functions/iceberg) |
    | テーブルエンジン | ✅ | ✅ | バックエンドごとにバリアントがある [`IcebergS3`](/ja/reference/engines/table-engines/integrations/iceberg) |
    | クラスター分散読み取り | ✅ | ✅ | [`icebergS3Cluster`](/ja/reference/functions/table-functions/icebergCluster)、[`icebergAzureCluster`](/ja/reference/functions/table-functions/icebergCluster)、[`icebergHDFSCluster`](/ja/reference/functions/table-functions/icebergCluster) |
    | 名前付きコレクション | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ✅ | DDL で作成した[名前付きコレクション](/ja/concepts/features/configuration/server-config/named-collections)は、一部の ClickHouse Cloud サービスで有効にできます。利用可否についてはサポートにお問い合わせください。 |
    | | | | |
    | **読み取り機能** | | | |
    | 読み取りサポート | ✅ | ✅ | すべての ClickHouse SQL 関数を使用した完全な `SELECT` サポート |
    | パーティションプルーニング | ✅ | ✅ | [パーティションプルーニング](/ja/reference/engines/table-engines/integrations/iceberg#partition-pruning)を参照してください。 |
    | 隠しパーティション化 | ✅ | ✅ | Iceberg の変換ベースのパーティション化をサポート |
    | パーティション進化 | ✅ | ✅ | 時間の経過に伴ってパーティション仕様が変化するテーブルの読み取りをサポート |
    | スキーマ進化 | ✅ | ✅ | カラムの追加、削除、並べ替えに対応。[スキーマ進化](/ja/reference/engines/table-engines/integrations/iceberg#schema-evolution)を参照してください。 |
    | 型の昇格 / 拡張 | ✅ | ✅ | P' > P の場合、`int` → `long`、`float` → `double`、`decimal(P,S)` → `decimal(P',S)` に対応。[スキーマ進化](/ja/reference/engines/table-engines/integrations/iceberg#schema-evolution)を参照してください。 |
    | タイムトラベル / スナップショット | ✅ | ✅ | `iceberg_timestamp_ms` または `iceberg_snapshot_id` 設定を使用します。[タイムトラベル](/ja/reference/engines/table-engines/integrations/iceberg#time-travel)を参照してください。 |
    | 位置削除 | ✅ | ✅ | [削除された行の処理](/ja/reference/engines/table-engines/integrations/iceberg#deleted-rows)を参照してください。 |
    | 等価削除 | ✅ | ✅ | v25.8+ 以降、テーブル関数およびテーブルエンジンでサポート。[削除された行の処理](/ja/reference/engines/table-engines/integrations/iceberg#deleted-rows)を参照してください。 |
    | 読み取り時マージ | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | 実験的機能。[削除操作](/ja/reference/functions/table-functions/iceberg#iceberg-writes-delete)でサポートされています。 |
    | フォーマットバージョン | ⚠️ 一部 | ⚠️ 一部 | v1 および v2 をサポートしています。v3 は一部のみサポートしており、削除ベクターの読み取りには対応していますが、マニフェスト圧縮には対応していません。 |
    | カラム統計 | ✅ | ✅ | |
    | ブルームフィルタ / Puffin ファイル | ❌ | ❌ | Puffin ファイル内のブルームフィルタインデックスはサポートされていません |
    | 仮想カラム | ✅ | ✅ | `_path`、`_file`、`_size`、`_time`、`_etag`。[仮想カラム](/ja/reference/functions/table-functions/iceberg#virtual-columns)を参照してください。 |
    | | | | |
    | **書き込み機能** | | | |
    | テーブル作成 | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | 実験的機能。`allow_insert_into_iceberg = 1` が必要です。v25.7+ 以降。[テーブルの作成](/ja/reference/functions/table-functions/iceberg#create-iceberg-table)を参照してください。 |
    | `INSERT` | ✅ ベータ | ✅ ベータ | 26.2 からベータです。`allow_insert_into_iceberg = 1` が必要です。[データの挿入](/ja/reference/functions/table-functions/iceberg#writes-inserts)を参照してください。 |
    | `DELETE` | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | 実験的機能です。`allow_insert_into_iceberg = 1` が必要です。`ALTER TABLE ... DELETE WHERE` で実行します。[データの削除](/ja/reference/functions/table-functions/iceberg#iceberg-writes-delete)を参照してください。 |
    | `ALTER TABLE` (スキーマ変更) | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | 実験的機能です。`allow_insert_into_iceberg = 1` が必要です。カラムの追加、削除、変更、リネームを行えます。[スキーマ進化](/ja/reference/functions/table-functions/iceberg#iceberg-writes-schema-evolution)を参照してください。 |
    | コンパクション | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | 実験的機能です。`allow_experimental_iceberg_compaction = 1` が必要です。[コンパクション](/ja/reference/functions/table-functions/iceberg#iceberg-writes-compaction)を参照してください。 |
    | `UPDATE` / `MERGE` | ❌ | ❌ | サポートされていません。コンパクションを参照してください。 |
    | コピーオンライト | ❌ | ❌ | サポートされていません。 |
    | スナップショットの期限切れ | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | 実験的機能です。Iceberg v2、`allow_insert_into_iceberg = 1`、および `allow_experimental_expire_snapshots = 1` が必要です。[スナップショットの期限切れ](/ja/reference/functions/table-functions/iceberg#iceberg-expire-snapshots)を参照してください。 |
    | 孤立ファイルの削除 | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | 実験的機能です。Iceberg v2 以降、`allow_insert_into_iceberg = 1`、および `allow_iceberg_remove_orphan_files = 1` が必要です。[孤立ファイルの削除](/ja/reference/functions/table-functions/iceberg#iceberg-remove-orphan-files)を参照してください。 |
    | パーティションへの書き込み | ✅ ベータ | ✅ ベータ | Iceberg への書き込みでサポートされています。 |
    | パーティションの変更 | ❌ | ❌ | ClickHouse からパーティション化スキームを変更することはサポートされていません。ClickHouse は、変更後のパーティション化スキームを持つ Iceberg テーブルに書き込むことができます。 |
    | | | | |
    | **メタデータ** | | | |
    | ブランチとタグ付け | ❌ | ❌ | Iceberg のブランチ/タグ参照はサポートされていません。 |
    | メタデータファイルの解決 | ✅ | ✅ | カタログ、ディレクトリの一覧表示、`version-hint`、および特定のパスによる解決をサポートします。[メタデータファイルの解決](/ja/reference/engines/table-engines/integrations/iceberg#metadata-file-resolution)を参照してください。 |
    | データキャッシュ | ✅ | ✅ | S3/Azure/HDFS ストレージエンジンと同じ仕組みです。[データキャッシュ](/ja/reference/engines/table-engines/integrations/iceberg#data-cache)を参照してください。 |
    | メタデータキャッシュ | ✅ | ✅ | `use_iceberg_metadata_files_cache` により、デフォルトで有効です。[メタデータキャッシュ](/ja/reference/engines/table-engines/integrations/iceberg#metadata-cache)を参照してください。 |
  </Tab>

  <Tab title="Delta Lake">
    バージョン25.6以降、ClickHouseはDelta Lake Rust kernelを使用してDelta Lakeテーブルを読み取ることで、より幅広い機能をサポートしています (Azure Blob Storageについてはバージョン26.4以降で有効) 。以下に、このKernelが必要な機能を示します。

    | 機能 | ClickHouse Cloud | セルフマネージド | 注記 |
    | - | :-: | :-: | - |
    | **ストレージバックエンド** | | | |
    | AWS S3 | ✅ | ✅ | [`deltaLake()`](/ja/reference/functions/table-functions/deltalake) または `deltaLakeS3()` 経由 |
    | GCS | ✅ | ✅ | [`deltaLake()`](/ja/reference/functions/table-functions/deltalake) または `deltaLakeS3()` 経由 |
    | Azure Blob Storage | ✅ | ✅ | [`deltaLakeAzure()`](/ja/reference/functions/table-functions/deltalake) 経由 |
    | HDFS | ❌ | ❌ | サポートされていません |
    | ローカルファイルシステム | ❌ | ✅ | [`deltaLakeLocal()`](/ja/reference/functions/table-functions/deltalake) 経由 |
    | **アクセス方法** | | | |
    | テーブル関数 | ✅ | ✅ | バックエンドごとのバリアントを持つ [`deltaLake()`](/ja/reference/functions/table-functions/deltalake) |
    | テーブルエンジン | ✅ | ✅ | [`DeltaLake`](/ja/reference/engines/table-engines/integrations/deltalake) |
    | クラスター分散読み取り | ✅ | ✅ | [`deltaLakeCluster`](/ja/reference/functions/table-functions/deltalakeCluster)、[`deltaLakeAzureCluster`](/ja/reference/functions/table-functions/deltalakeCluster) |
    | 名前付きコレクション | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ✅ | DDLで作成した[名前付きコレクション](/ja/concepts/features/configuration/server-config/named-collections)は、一部のClickHouse Cloudサービスで有効にできます。利用可否についてはサポートにお問い合わせください。 |
    | **読み取り機能** | | | |
    | 読み取りサポート | ✅ | ✅ | すべてのClickHouse SQL関数に対応した完全な`SELECT`サポート |
    | パーティションプルーニング | ✅ ベータ | ✅ ベータ | Delta Kernelが必要です。 |
    | スキーマ進化 | ✅ ベータ | ✅ ベータ | Delta Kernelが必要です。 |
    | タイムトラベル | ✅ ベータ | ✅ ベータ | Delta Kernelが必要です。 |
    | 削除ベクター | ✅ | ✅ | |
    | カラムマッピング | ✅ | ✅ | |
    | 変更データフィード | ✅ ベータ | ✅ ベータ | Delta Kernelが必要です。 |
    | 仮想カラム | ✅ | ✅ | `_path`、`_file`、`_size`、`_time`、`_etag`。[仮想カラム](/ja/reference/functions/table-functions/deltalake#virtual-columns)を参照してください。 |
    | **書き込み機能** | | | |
    | `INSERT` | ✅ ベータ | ✅ ベータ | Delta Kernelが必要です。S3およびGCSへの書き込みがサポートされており、Azureについてはv26.9以降でサポートされています。v26.7以降では`allow_delta_lake_writes = 1`が必要です。以前のバージョンでは`allow_experimental_delta_lake_writes = 1`を使用してください。[Delta Lakeへの書き込み](/ja/reference/functions/table-functions/deltalake#inserting-data)を参照してください。 |
    | `DELETE` / `UPDATE` / `MERGE` | ❌ | ❌ | サポートされていません |
    | 空のテーブルを作成 | ❌ | ❌ | `CREATE TABLE`操作では、Delta Lakeテーブルがすでにオブジェクトストレージ上に存在していることを前提としています。 |
    | **キャッシュ** | | | |
    | データキャッシュ | ✅ | ✅ | S3/Azure/HDFSストレージエンジンと同じメカニズムです。[データキャッシュ](/ja/reference/engines/table-engines/integrations/deltalake#data-cache)を参照してください。 |
  </Tab>

  <Tab title="Apache Hudi">
    | 機能 | ClickHouse Cloud | セルフマネージド | 注記 |
    | - | :-: | :-: | - |
    | **ストレージバックエンド** | | | |
    | AWS S3 | ✅ | ✅ | [`hudi()`](/ja/reference/functions/table-functions/hudi) 経由 |
    | GCS | ✅ | ✅ | [`hudi()`](/ja/reference/functions/table-functions/hudi) 経由 |
    | Azure Blob Storage | ❌ | ❌ | サポートされていません |
    | HDFS | ❌ | ❌ | サポートされていません |
    | ローカルファイルシステム | ❌ | ❌ | サポートされていません |
    | **アクセス方法** | | | |
    | テーブル関数 | ✅ | ✅ | [`hudi()`](/ja/reference/functions/table-functions/hudi) |
    | テーブルエンジン | ✅ | ✅ | [`Hudi`](/ja/reference/engines/table-engines/integrations/hudi) |
    | クラスター分散読み取り | ✅ | ✅ | [`hudiCluster`](/ja/reference/functions/table-functions/hudiCluster) (S3 のみ) |
    | 名前付きコレクション | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ✅ | DDL で作成した[名前付きコレクション](/ja/concepts/features/configuration/server-config/named-collections)は、一部の ClickHouse Cloud サービスで有効にできます。利用可否についてはサポートにお問い合わせください。 |
    | **読み取り機能** | | | |
    | 読み取りサポート | ✅ | ✅ | すべての ClickHouse SQL 関数に対応した完全な `SELECT` サポート |
    | スキーマ進化 | ❌ | ❌ | サポートされていません |
    | タイムトラベル | ❌ | ❌ | サポートされていません |
    | 仮想カラム | ✅ | ✅ | `_path`、`_file`、`_size`、`_time`、`_etag`。[仮想カラム](/ja/reference/functions/table-functions/hudi#virtual-columns)を参照してください。 |
    | **書き込み機能** | | | |
    | `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | 読み取り専用のインテグレーション |
    | **キャッシュ** | | | |
    | データキャッシュ | ❌ | ❌ | サポートされていません |
  </Tab>

  <Tab title="Apache Paimon">
    | 機能 | ClickHouse Cloud | セルフマネージド | 注記 |
    | - | :-: | :-: | - |
    | **ストレージバックエンド** | | | |
    | S3 | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。[`paimon()`](/ja/reference/functions/table-functions/paimon) または `paimonS3()` を使用 |
    | GCS | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。[`paimon()`](/ja/reference/functions/table-functions/paimon) または `paimonS3()` を使用 |
    | Azure Blob Storage | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。[`paimonAzure()`](/ja/reference/functions/table-functions/paimon) を使用 |
    | HDFS | ❌ | ⚠️ | Experimental かつ非推奨。[`paimonHDFS()`](/ja/reference/functions/table-functions/paimon) を使用 |
    | ローカルファイルシステム | ❌ | ⚠️ | Experimental。[`paimonLocal()`](/ja/reference/functions/table-functions/paimon) を使用 |
    | **アクセス方法** | | | |
    | テーブル関数 | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。バックエンドごとのバリアントを備えた [`paimon()`](/ja/reference/functions/table-functions/paimon) |
    | テーブルエンジン | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。バックエンドごとのバリアントを備えた [`Paimon`](/ja/reference/engines/table-engines/integrations/paimon)。`allow_experimental_paimon_storage_engine = 1` が必要です。 |
    | クラスター分散読み取り | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。[`paimonS3Cluster`](/ja/reference/functions/table-functions/paimonCluster)、[`paimonAzureCluster`](/ja/reference/functions/table-functions/paimonCluster)、[`paimonHDFSCluster`](/ja/reference/functions/table-functions/paimonCluster) |
    | 名前付きコレクション | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。DDL で作成した[名前付きコレクション](/ja/concepts/features/configuration/server-config/named-collections)は、一部の ClickHouse Cloud サービスで有効にできます。利用可否についてはサポートにお問い合わせください。 |
    | **読み取り機能** | | | |
    | 読み取りサポート | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。すべての ClickHouse SQL 関数を使用した完全な `SELECT` サポート |
    | スキーマ進化 | ❌ | ❌ | サポートされていません |
    | タイムトラベル | ❌ | ❌ | サポートされていません |
    | 仮想カラム | <Tooltip tip="利用可否についてはサポートにお問い合わせください">⚠️</Tooltip> | ⚠️ | Experimental。`_path`、`_file`、`_size`、`_time`、`_etag`。[仮想カラム](/ja/reference/functions/table-functions/paimon#virtual-columns)を参照してください。 |
    | **書き込み機能** | | | |
    | `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | 読み取り専用のインテグレーション |
    | **Caching** | | | |
    | データキャッシュ | ❌ | ❌ | サポートされていません |
  </Tab>
</Tabs>

<h2 id="catalog-support">
  カタログのサポート
</h2>

ClickHouse は、[`DataLakeCatalog`](/ja/reference/engines/database-engines/datalake) データベースエンジンを使用して外部データカタログに接続できます。このエンジンにより、カタログが ClickHouse データベースとして公開されます。カタログに登録されたテーブルは自動的に表示され、標準 SQL でクエリできます。

現在サポートされているカタログは次のとおりです。セットアップ手順の詳細については、各カタログのリファレンスガイドを参照してください。

| カタログ | フォーマット | 読み取り | テーブルの作成 | INSERT | 参照ガイド |
| - | - | :-: | :-: | :-: | - |
| [AWS Glue Catalog](/ja/guides/use-cases/data-warehousing/glue-catalog) | Iceberg | ✅ ベータ | ❌ | ❌ | [Glue カタログガイド](/ja/guides/use-cases/data-warehousing/glue-catalog) |
| [BigLake Metastore](/ja/guides/use-cases/data-warehousing/biglake-catalog) | Iceberg | ✅ ベータ | ❌ | ❌ | [BigLake Metastore ガイド](/ja/guides/use-cases/data-warehousing/biglake-catalog) |
| [Databricks Unity Catalog](/ja/guides/use-cases/data-warehousing/unity-catalog) | Delta, Iceberg | ✅ ベータ | ✅ ベータ | ✅ ベータ | [Unity Catalog ガイド](/ja/guides/use-cases/data-warehousing/unity-catalog) |
| [Iceberg REST](/ja/guides/use-cases/data-warehousing/rest-catalog) | Iceberg | ✅ ベータ | ❌ | ❌ | [REST カタログガイド](/ja/guides/use-cases/data-warehousing/rest-catalog) |
| [Lakekeeper](/ja/guides/use-cases/data-warehousing/lakekeeper-catalog) | Iceberg | ✅ ベータ | ❌ | ❌ | [Lakekeeper カタログガイド](/ja/guides/use-cases/data-warehousing/lakekeeper-catalog) |
| [Project Nessie](/ja/guides/use-cases/data-warehousing/nessie-catalog) | Iceberg | ✅ 実験的 | ❌ | ❌ | [Nessie カタログガイド](/ja/guides/use-cases/data-warehousing/nessie-catalog) |
| [Microsoft OneLake](/ja/guides/use-cases/data-warehousing/onelake-catalog) | Iceberg | ✅ ベータ | ✅ ベータ | ✅ ベータ | [OneLake カタログガイド](/ja/guides/use-cases/data-warehousing/onelake-catalog) |
| [SeaweedFS](/ja/guides/use-cases/data-warehousing/seaweedfs-catalog) | Iceberg | ✅ ベータ | ✅ ベータ | ✅ ベータ | [SeaweedFS カタログガイド](/ja/guides/use-cases/data-warehousing/seaweedfs-catalog) |

現在、すべてのカタログインテグレーションで実験的またはベータの設定を有効にする必要があります。Microsoft OneLake、Databricks Unity Catalog、SeaweedFS を除き、すべてのカタログは **読み取り専用** アクセスです。つまり、テーブルはクエリできますが、カタログ接続を通じて作成したり書き込んだりすることはできません。カタログから ClickHouse にデータを読み込んで分析を高速化するには、[分析高速化ガイド](/ja/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) で説明されている `INSERT INTO SELECT` を使用してください。オープンテーブルフォーマットにデータを書き戻すには、[データ書き込みガイド](/ja/guides/use-cases/data-warehousing/getting-started/writing-data) で説明されているように、スタンドアロンの Iceberg テーブルを作成してください。