Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

iceberg_compaction_* session settings

These settings are available in system.settings and are autogenerated from source.

iceberg_compaction_commit_batch_size

Type
UInt64
Default
100
Version history
VersionDefault valueComment
26.9100New setting
26.8100New setting

Number of merged data files that background Iceberg compaction accumulates before publishing them in a new snapshot.

Compaction results are published in any case once there are no candidates left to compact, so this setting only bounds how long already merged files stay unpublished while compaction keeps finding new work. 0 restores the old behaviour of publishing only when compaction runs out of candidates - a state that is never reached while the table keeps receiving new data files, so every merged output is then written to object storage and never referenced by a snapshot.

iceberg_compaction_data_cleanup

Type
Seconds
Default
10800
Version history
VersionDefault valueComment
26.510800New setting

The time after which the data will be deleted.

iceberg_compaction_delay_bias

Type
Seconds
Default
10800
Version history
VersionDefault valueComment
26.510800New setting

Minimum time of delay between 2 background compaction operations.

iceberg_compaction_max_bytes_in_data_file

Type
UInt64
Default
18446744073709551615
Version history
VersionDefault valueComment
26.918446744073709551615New setting for the max bytes of an iceberg data file produced by compaction, separate from the insert-time limit.
26.718446744073709551615New setting for the max bytes of an iceberg data file produced by compaction, separate from the insert-time limit.

Max bytes of an iceberg parquet data file produced by compaction. Defaults to the maximum so that compaction merges eligible files into as few output files as possible.

iceberg_compaction_max_rows_in_data_file

Type
UInt64
Default
18446744073709551615
Version history
VersionDefault valueComment
26.918446744073709551615New setting for the max rows of an iceberg data file produced by compaction, separate from the insert-time limit.
26.718446744073709551615New setting for the max rows of an iceberg data file produced by compaction, separate from the insert-time limit.

Max rows of an iceberg parquet data file produced by compaction. Defaults to the maximum so that compaction merges eligible files into as few output files as possible. Keeping this above the size compaction can actually produce would make every output file stay below iceberg_data_file_size_lower_threshold_compaction and be re-selected forever.

Navigation