Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

iceberg_metadata_* session settings

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

iceberg_metadata_compression_method

Experimental feature
Version history
VersionDefault valueComment
25.8New setting

Method to compress .metadata.json file.

iceberg_metadata_log_level

Type
IcebergMetadataLogLevel
Default
none
Version history
VersionDefault valueComment
25.9noneNew setting.

Controls the level of metadata logging for Iceberg tables to system.iceberg_metadata_log. Usually this setting can be modified for debugging purposes.

Possible values:

  • none - No metadata log.
  • metadata - Root metadata.json file.
  • manifest_list_metadata - Everything above + metadata from avro manifest list which corresponds to a snapshot.
  • manifest_list_entry - Everything above + avro manifest list entries.
  • manifest_file_metadata - Everything above + metadata from traversed avro manifest files.
  • manifest_file_entry - Everything above + traversed avro manifest files entries.

iceberg_metadata_staleness_ms

Type
UInt64
Default
0
Version history
VersionDefault valueComment
26.30New setting allowing using cached metadata version at READ operations to prevent fetching from remote catalog

If non-zero, skip fetching iceberg metadata from remote catalog if there is a cached metadata snapshot, more recent than the given staleness window. Zero means to always fetch the latest metadata version from the remote catalog. Setting this a non-zero trades staleness to a lower latency of read operations.

Navigation