> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-revert-104359-revert-104251-parquet-single.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 支持矩阵 > ClickHouse 开放表格式集成和数据目录连接的完整支持矩阵。 本页提供 ClickHouse 数据湖集成的完整支持矩阵，涵盖各类开放表格式支持的功能、ClickHouse 可连接的目录，以及各类目录所支持的能力。 ClickHouse Cloud 和自管理 ClickHouse 的支持情况将分别列出。Experimental 功能在 ClickHouse Cloud 中默认处于禁用状态，且[必须通过 Support 申请](https://clickhouse.com/blog/common-getting-started-issues-with-clickhouse#13-experimental-features-in-production)。是否可用取决于具体功能，因此请联系 Support 确认能否启用特定的 Experimental 功能。特定部署的配置和限制将在 Notes 列中说明。
## 开放表格式支持
ClickHouse 可与四种开放表格式集成：[Apache Iceberg](/zh/reference/engines/table-engines/integrations/iceberg)、[Delta Lake](/zh/reference/engines/table-engines/integrations/deltalake)、[Apache Hudi](/zh/reference/engines/table-engines/integrations/hudi) 和 [Apache Paimon](/zh/reference/functions/table-functions/paimon)。请选择下方的一种格式以查看其支持矩阵。 **图例：** ✅ 支持 | ⚠️ 部分支持、Experimental 或已弃用 | ❌ 不支持 | 功能 | ClickHouse Cloud | 自管理 | 说明 | | ------------------------- | :-------------------------------------------: | :-----: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **存储后端** | | | | | AWS S3 | ✅ | ✅ | 通过 [`icebergS3()`](/zh/reference/functions/table-functions/iceberg) 或其别名 `iceberg()` | | GCS | ✅ | ✅ | 通过 [`icebergS3()`](/zh/reference/functions/table-functions/iceberg) 或其别名 `iceberg()` | | Azure Blob 存储 | ✅ | ✅ | 通过 [`icebergAzure()`](/zh/reference/functions/table-functions/iceberg) | | HDFS | ❌ | ⚠️ 已弃用 | 通过 [`icebergHDFS()`](/zh/reference/functions/table-functions/iceberg) | | 本地文件系统 | ❌ | ✅ | 通过 [`icebergLocal()`](/zh/reference/functions/table-functions/iceberg) | | **访问方式** | | | | | 表函数 | ✅ | ✅ | [`icebergS3()`](/zh/reference/functions/table-functions/iceberg)，各后端均有对应变体 | | 表引擎 | ✅ | ✅ | [`IcebergS3`](/zh/reference/engines/table-engines/integrations/iceberg)，各后端均有对应变体 | | 集群分布式读取 | ✅ | ✅ | [`icebergS3Cluster`](/zh/reference/functions/table-functions/icebergCluster)、[`icebergAzureCluster`](/zh/reference/functions/table-functions/icebergCluster)、[`icebergHDFSCluster`](/zh/reference/functions/table-functions/icebergCluster) | | 命名集合 | ⚠️ | ✅ | 部分 ClickHouse Cloud 服务可启用通过 DDL 创建的[命名集合](/zh/concepts/features/configuration/server-config/named-collections)。请联系 Support 确认可用性。 | | | | | | | **读取功能** | | | | | 读取支持 | ✅ | ✅ | 完整支持 `SELECT` 及所有 ClickHouse SQL 函数 | | 分区裁剪 | ✅ | ✅ | 请参阅[分区裁剪](/zh/reference/engines/table-engines/integrations/iceberg#partition-pruning)。 | | 隐藏分区 | ✅ | ✅ | 支持基于 Iceberg transform 的分区 | | 分区演进 | ✅ | ✅ | 支持读取分区规范随时间变化的表 | | schema 演进 | ✅ | ✅ | 支持添加、删除和重新排列列。请参阅[schema 演进](/zh/reference/engines/table-engines/integrations/iceberg#schema-evolution)。 | | 类型提升 / 扩展 | ✅ | ✅ | `int` → `long`、`float` → `double`、`decimal(P,S)` → `decimal(P',S)`，其中 P' > P。请参阅[schema 演进](/zh/reference/engines/table-engines/integrations/iceberg#schema-evolution)。 | | 时间旅行 / 快照 | ✅ | ✅ | 通过 `iceberg_timestamp_ms` 或 `iceberg_snapshot_id` 设置。请参阅[时间旅行](/zh/reference/engines/table-engines/integrations/iceberg#time-travel)。 | | 位置删除 | ✅ | ✅ | 请参阅[处理已删除行](/zh/reference/engines/table-engines/integrations/iceberg#deleted-rows)。 | | 相等删除 | ✅ | ✅ | 表函数和表引擎自 v25.8+ 起支持。请参阅[处理已删除行](/zh/reference/engines/table-engines/integrations/iceberg#deleted-rows)。 | | 读取时合并 | ⚠️ | ⚠️ | 实验性功能。支持[删除操作](/zh/reference/functions/table-functions/iceberg#iceberg-writes-delete)。 | | 格式版本 | ⚠️ 部分支持 | ⚠️ 部分支持 | 支持 v1 和 v2。部分支持 v3；不支持删除向量和清单压缩。 | | 列统计信息 | ✅ | ✅ | | | 布隆过滤器 / Puffin 文件 | ❌ | ❌ | 不支持 Puffin 文件中的布隆过滤器索引 | | 虚拟列 | ✅ | ✅ | `_path`、`_file`、`_size`、`_time`、`_etag`。请参阅[虚拟列](/zh/reference/functions/table-functions/iceberg#virtual-columns)。 | | | | | | | **写入功能** | | | | | 表创建 | ⚠️ | ⚠️ | 实验性功能。需要 `allow_insert_into_iceberg = 1`。自 v25.7+ 起支持。请参阅[创建表](/zh/reference/functions/table-functions/iceberg#create-iceberg-table)。 | | `INSERT` | ✅ Beta | ✅ Beta | 自 26.2 版本起处于 Beta 阶段。需要 `allow_insert_into_iceberg = 1`。请参阅[插入数据](/zh/reference/functions/table-functions/iceberg#writes-inserts)。 | | `DELETE` | ⚠️ | ⚠️ | Experimental。需要 `allow_insert_into_iceberg = 1`。通过 `ALTER TABLE ... DELETE WHERE` 执行。请参阅[删除数据](/zh/reference/functions/table-functions/iceberg#iceberg-writes-delete)。 | | `ALTER TABLE` (schema 变更) | ⚠️ | ⚠️ | Experimental。需要 `allow_insert_into_iceberg = 1`。支持添加、删除、修改和重命名列。请参阅[Schema 演进](/zh/reference/functions/table-functions/iceberg#iceberg-writes-schema-evolution)。 | | 合并整理 | ⚠️ | ⚠️ | Experimental。需要 `allow_experimental_iceberg_compaction = 1`。请参阅[合并整理](/zh/reference/functions/table-functions/iceberg#iceberg-writes-compaction)。 | | `UPDATE` / `MERGE` | ❌ | ❌ | 不支持。请参阅合并整理。 | | 写时复制 | ❌ | ❌ | 不支持 | | 快照过期 | ⚠️ | ⚠️ | Experimental。需要 Iceberg v2、`allow_insert_into_iceberg = 1` 和 `allow_experimental_expire_snapshots = 1`。请参阅[快照过期](/zh/reference/functions/table-functions/iceberg#iceberg-expire-snapshots)。 | | 移除孤立文件 | ⚠️ | ⚠️ | Experimental。需要 Iceberg v2 或更高版本、`allow_insert_into_iceberg = 1` 和 `allow_iceberg_remove_orphan_files = 1`。请参阅[移除孤立文件](/zh/reference/functions/table-functions/iceberg#iceberg-remove-orphan-files)。 | | 写入分区 | ✅ Beta | ✅ Beta | 支持写入 Iceberg。 | | 修改分区 | ❌ | ❌ | 不支持通过 ClickHouse 更改分区方案。ClickHouse 可以写入采用演进后分区方案的 Iceberg 表。 | | | | | | | **元数据** | | | | | 分支和标签 | ❌ | ❌ | 不支持 Iceberg 分支/标签引用。 | | 元数据文件解析 | ✅ | ✅ | 支持通过目录、目录列表、`version-hint` 和特定路径进行解析。请参阅[元数据文件解析](/zh/reference/engines/table-engines/integrations/iceberg#metadata-file-resolution)。 | | 数据缓存 | ✅ | ✅ | 与 S3/Azure/HDFS 存储引擎使用相同的机制。请参阅[数据缓存](/zh/reference/engines/table-engines/integrations/iceberg#data-cache)。 | | 元数据缓存 | ✅ | ✅ | 默认通过 `use_iceberg_metadata_files_cache` 启用。请参阅[元数据缓存](/zh/reference/engines/table-engines/integrations/iceberg#metadata-cache)。 | 从 25.6 版本起，ClickHouse 使用 Delta Lake Rust 内核读取 Delta Lake 表，支持更多功能；但访问 Azure Blob 存储中的数据时存在已知问题。因此，从 Azure Blob 存储读取数据时会禁用该内核。下文标明了哪些功能需要此内核。 | 功能 | ClickHouse Cloud | 自管理 | 说明 | | ----------------------------- | :---------------------------------------: | :----: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **存储后端** | | | | | AWS S3 | ✅ | ✅ | 通过 [`deltaLake()`](/zh/reference/functions/table-functions/deltalake) 或 `deltaLakeS3()` | | GCS | ✅ | ✅ | 通过 [`deltaLake()`](/zh/reference/functions/table-functions/deltalake) 或 `deltaLakeS3()` | | Azure Blob 存储 | ✅ | ✅ | 通过 [`deltaLakeAzure()`](/zh/reference/functions/table-functions/deltalake) | | HDFS | ❌ | ❌ | 不支持 | | 本地文件系统 | ❌ | ✅ | 通过 [`deltaLakeLocal()`](/zh/reference/functions/table-functions/deltalake) | | **访问方法** | | | | | 表函数 | ✅ | ✅ | [`deltaLake()`](/zh/reference/functions/table-functions/deltalake)，不同后端对应不同变体 | | 表引擎 | ✅ | ✅ | [`DeltaLake`](/zh/reference/engines/table-engines/integrations/deltalake) | | 集群分布式读取 | ✅ | ✅ | [`deltaLakeCluster`](/zh/reference/functions/table-functions/deltalakeCluster)、[`deltaLakeAzureCluster`](/zh/reference/functions/table-functions/deltalakeCluster) | | 命名集合 | ⚠️ | ✅ | 可在部分 ClickHouse Cloud 服务上启用通过 DDL 创建的[命名集合](/zh/concepts/features/configuration/server-config/named-collections)。请联系支持团队确认是否可用。 | | **读取功能** | | | | | 读取支持 | ✅ | ✅ | 完整支持 `SELECT` 及所有 ClickHouse SQL 函数 | | 分区裁剪 | ✅ Beta | ✅ Beta | 需要 Delta Kernel。 | | 模式演进 | ✅ Beta | ✅ Beta | 需要 Delta Kernel。 | | 时间旅行 | ✅ Beta | ✅ Beta | 需要 Delta Kernel。 | | 删除向量 | ✅ | ✅ | | | 列映射 | ✅ | ✅ | | | 变更数据馈送 | ✅ Beta | ✅ Beta | 需要 Delta Kernel。 | | 虚拟列 | ✅ | ✅ | `_path`、`_file`、`_size`、`_time`、`_etag`。请参阅[虚拟列](/zh/reference/functions/table-functions/deltalake#virtual-columns)。 | | **写入功能** | | | | | `INSERT` | ✅ Beta | ✅ Beta | 需要 Delta Kernel。支持写入 S3 和 GCS；不支持写入 Azure。从 v26.7 起，需要设置 `allow_delta_lake_writes = 1`；在更早版本中，请使用 `allow_experimental_delta_lake_writes = 1`。请参阅[Delta Lake 写入](/zh/reference/functions/table-functions/deltalake#inserting-data)。 | | `DELETE` / `UPDATE` / `MERGE` | ❌ | ❌ | 不支持 | | 创建空表 | ❌ | ❌ | `CREATE TABLE` 操作假定 Delta Lake 表已存在于对象存储中。 | | **缓存** | | | | | 数据缓存 | ✅ | ✅ | 与 S3/Azure/HDFS 存储引擎采用相同的机制。请参阅[数据缓存](/zh/reference/engines/table-engines/integrations/deltalake#data-cache)。 | | 功能 | ClickHouse Cloud | 自管理 | 说明 | | ------------------------------ | :--------------------------------------: | :-: | ------------------------------------------------------------------------------------------------------------------------------- | | **存储后端** | | | | | AWS S3 | ✅ | ✅ | 通过 [`hudi()`](/zh/reference/functions/table-functions/hudi) | | GCS | ✅ | ✅ | 通过 [`hudi()`](/zh/reference/functions/table-functions/hudi) | | Azure Blob 存储 | ❌ | ❌ | 不支持 | | HDFS | ❌ | ❌ | 不支持 | | 本地文件系统 | ❌ | ❌ | 不支持 | | **访问方式** | | | | | 表函数 | ✅ | ✅ | [`hudi()`](/zh/reference/functions/table-functions/hudi) | | 表引擎 | ✅ | ✅ | [`Hudi`](/zh/reference/engines/table-engines/integrations/hudi) | | 集群分布式读取 | ✅ | ✅ | [`hudiCluster`](/zh/reference/functions/table-functions/hudiCluster) (仅支持 S3) | | 命名集合 | ⚠️ | ✅ | 可在部分 ClickHouse Cloud 服务中启用通过 DDL 创建的[命名集合](/zh/concepts/features/configuration/server-config/named-collections)。请联系支持团队确认是否可用。 | | **读取功能** | | | | | 读取支持 | ✅ | ✅ | 完整支持 `SELECT` 以及所有 ClickHouse SQL 函数 | | schema 演进 | ❌ | ❌ | 不支持 | | 时间旅行 | ❌ | ❌ | 不支持 | | 虚拟列 | ✅ | ✅ | `_path`、`_file`、`_size`、`_time`、`_etag`。请参阅[虚拟列](/zh/reference/functions/table-functions/hudi#virtual-columns)。 | | **写入功能** | | | | | `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | 只读集成 | | **缓存** | | | | | 数据缓存 | ❌ | ❌ | 不支持 | | 功能 | ClickHouse Cloud | 自管理 | 说明 | | ------------------------------ | :-------------------------------------------: | :-: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **存储后端** | | | | | S3 | ⚠️ | ⚠️ | Experimental。通过 [`paimon()`](/zh/reference/functions/table-functions/paimon) 或 `paimonS3()` | | GCS | ⚠️ | ⚠️ | Experimental。通过 [`paimon()`](/zh/reference/functions/table-functions/paimon) 或 `paimonS3()` | | Azure Blob 存储 | ⚠️ | ⚠️ | Experimental。通过 [`paimonAzure()`](/zh/reference/functions/table-functions/paimon) | | HDFS | ❌ | ⚠️ | Experimental，且已弃用。通过 [`paimonHDFS()`](/zh/reference/functions/table-functions/paimon) | | 本地文件系统 | ❌ | ⚠️ | Experimental。通过 [`paimonLocal()`](/zh/reference/functions/table-functions/paimon) | | **访问方式** | | | | | 表函数 | ⚠️ | ⚠️ | Experimental。[`paimon()`](/zh/reference/functions/table-functions/paimon)，每种后端均有对应变体 | | 表引擎 | ⚠️ | ⚠️ | Experimental。[`Paimon`](/zh/reference/engines/table-engines/integrations/paimon)，每种后端均有对应变体。需要 `allow_experimental_paimon_storage_engine = 1`。 | | 集群分布式读取 | ⚠️ | ⚠️ | Experimental。[`paimonS3Cluster`](/zh/reference/functions/table-functions/paimonCluster)、[`paimonAzureCluster`](/zh/reference/functions/table-functions/paimonCluster)、[`paimonHDFSCluster`](/zh/reference/functions/table-functions/paimonCluster) | | 命名集合 | ⚠️ | ⚠️ | Experimental。可在部分 ClickHouse Cloud 服务上启用通过 DDL 创建的[命名集合](/zh/concepts/features/configuration/server-config/named-collections)。请联系 Support 确认可用性。 | | **读取功能** | | | | | 读取支持 | ⚠️ | ⚠️ | Experimental。完整支持 `SELECT` 以及所有 ClickHouse SQL 函数 | | schema 演进 | ❌ | ❌ | 不支持 | | 时间旅行 | ❌ | ❌ | 不支持 | | 虚拟列 | ⚠️ | ⚠️ | Experimental。`_path`、`_file`、`_size`、`_time`、`_etag`。请参阅[虚拟列](/zh/reference/functions/table-functions/paimon#virtual-columns)。 | | **写入功能** | | | | | `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | 只读集成 | | **缓存** | | | | | 数据缓存 | ❌ | ❌ | 不支持 |
## 目录支持
ClickHouse 可以使用 [`DataLakeCatalog`](/zh/reference/engines/database-engines/datalake) 数据库引擎连接外部数据目录，并将该目录映射为一个 ClickHouse 数据库。注册在目录中的表会自动显示出来，并可使用标准 SQL 查询。 当前支持以下目录。有关完整的设置说明，请参阅各目录的参考指南。 | 目录 | 格式 | 读取 | 创建表 | INSERT | 参考指南 | | ------------------------------------------------------------------------------- | -------------- | :------------: | :----: | :----: | ----------------------------------------------------------------------------- | | [AWS Glue Catalog](/zh/guides/use-cases/data-warehousing/glue-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [Glue 目录 指南](/zh/guides/use-cases/data-warehousing/glue-catalog) | | [BigLake Metastore](/zh/guides/use-cases/data-warehousing/biglake-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [BigLake Metastore 指南](/zh/guides/use-cases/data-warehousing/biglake-catalog) | | [Databricks Unity Catalog](/zh/guides/use-cases/data-warehousing/unity-catalog) | Delta, Iceberg | ✅ Beta | ✅ Beta | ✅ Beta | [Unity Catalog 指南](/zh/guides/use-cases/data-warehousing/unity-catalog) | | [Iceberg REST](/zh/guides/use-cases/data-warehousing/rest-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [REST 目录 指南](/zh/guides/use-cases/data-warehousing/rest-catalog) | | [Lakekeeper](/zh/guides/use-cases/data-warehousing/lakekeeper-catalog) | Iceberg | ✅ Beta | ❌ | ❌ | [Lakekeeper 目录 指南](/zh/guides/use-cases/data-warehousing/lakekeeper-catalog) | | [Project Nessie](/zh/guides/use-cases/data-warehousing/nessie-catalog) | Iceberg | ✅ Experimental | ❌ | ❌ | [Nessie 目录 指南](/zh/guides/use-cases/data-warehousing/nessie-catalog) | | [Microsoft OneLake](/zh/guides/use-cases/data-warehousing/onelake-catalog) | Iceberg | ✅ Beta | ✅ Beta | ✅ Beta | [OneLake 目录 指南](/zh/guides/use-cases/data-warehousing/onelake-catalog) | | [SeaweedFS](/zh/guides/use-cases/data-warehousing/seaweedfs-catalog) | Iceberg | ✅ Beta | ✅ Beta | ✅ Beta | [SeaweedFS 目录 指南](/zh/guides/use-cases/data-warehousing/seaweedfs-catalog) | 目前所有目录集成都需要启用 Experimental 或 Beta 设置。除 Microsoft OneLake、Databricks Unity Catalog 和 SeaweedFS 外，所有目录都仅提供 **read-only** 访问——可以查询表，但不能通过目录连接创建表或写入数据。若要将目录中的数据加载到 ClickHouse 以加快分析速度，请使用[加速分析指南](/zh/guides/use-cases/data-warehousing/getting-started/accelerating-analytics)中所述的 `INSERT INTO SELECT`。若要将数据写回开放表格式，请按[写入数据指南](/zh/guides/use-cases/data-warehousing/getting-started/writing-data)中的说明创建独立的 Iceberg 表。