Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

iceberg_* 会话设置

这些设置可在 system.settings 中查看,并根据 源代码 自动生成。

iceberg_delete_data_on_drop

类型
Bool
默认值
0
版本历史
版本默认值注释
25.90新增设置

执行 drop 时,是否删除所有 Iceberg 文件。

iceberg_delete_manifest_decode_concurrency

类型
NonZeroUInt64
默认值
4
版本历史
版本默认值注释
26.84新增设置,用于限制读取第一行之前可并发解码的 Iceberg 删除 manifest 文件数量。在 26.8 之前,每次解码一个 manifest,同时拉取下一个 manifest,因此 `2` 是最接近此前行为的等效值;此前行为会将这些 manifest 的对象存储往返时间之和置于返回第一行前的关键路径上。

在读取任何数据文件之前,查询执行期间可并发解码的 Iceberg 删除 manifest 文件的最大数量。

必须先解码所有删除 manifest,才能读取任何数据文件,因此这项工作位于返回第一行之前的关键路径上。一次解码多个 manifest 可重叠执行对象存储往返和按行剪枝工作。

当 Iceberg 元数据文件缓存被禁用或已满时,较高的值会增加查询初始化期间的峰值内存占用,因为每个正在处理的 manifest 都会保留各自解码后的内容。

必须大于零;1 表示每次解码一个 manifest。

iceberg_manifest_min_count_to_compact

Experimental 功能
类型
UInt64
默认值
30
版本历史
版本默认值注释
26.730用于控制 Iceberg 表 manifest 合并整理的新设置。

通过 OPTIMIZE TABLE … MANIFEST 触发仅针对 manifest 的合并整理所需的最少 manifest 文件数量。 如果当前 manifest 文件数量小于或等于该阈值,则会跳过合并整理。 需要启用 allow_experimental_iceberg_compaction。

iceberg_max_number_datafiles_to_compact

类型
UInt64
默认值
1000
版本历史
版本默认值注释
26.51000新增设置

Iceberg 中参与合并整理的数据文件数量阈值。

iceberg_orphan_files_older_than_seconds

Experimental 功能
类型
UInt64
默认值
259200
版本历史
版本默认值注释
26.4259200新增默认孤立文件期限阈值设置

Iceberg 表中删除孤立文件时使用的默认文件期限阈值 (以秒为单位) 。新于该阈值的文件不会被视为孤立文件。当在 remove_orphan_files() 过程调用中省略 older_than 参数时,将使用此设置。默认值为 259200 (3 天) 。

iceberg_snapshot_id

类型
Int64
默认值
0
版本历史
版本默认值注释
25.40新增设置。

使用指定的快照 ID 查询 Iceberg 表。

iceberg_timestamp_ms

类型
Int64
默认值
0
版本历史
版本默认值注释
25.40新增设置。

使用特定时间戳对应的快照查询 Iceberg 表。

Navigation