> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# iceberg_* セッション設定

> iceberg_* グループに属する ClickHouse のセッション設定。

これらの設定は [system.settings](https://clickhouse.com/docs/ja/reference/system-tables/settings.md) で参照でき、[source](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。

## iceberg\_delete\_data\_on\_drop

型

Bool

デフォルト値

0

drop 時に Iceberg のすべてのファイルを削除するかどうか。

## iceberg\_file\_entries\_queue\_size

型

NonZeroUInt64

デフォルト値

100

Iceberg データマニフェストのデコードタスクとクエリの間のキュー容量を、データファイルエントリ数で指定します。

キューが満杯になり、クエリ側が消費していない場合、デコードタスクは一時停止します。そのため、この設定は先読み量の上限にもなります。

ゼロより大きい値を指定する必要があります。

## iceberg\_list\_only\_v\_prefixed\_metadata\_files

型

Bool

デフォルト値

0

S3 または Azure 上のIcebergテーブルをパス指定で読み取る際、キープレフィックス `metadata/v` のみを一覧表示して最新のメタデータファイルを探します。これにより、同じ `metadata` ディレクトリに保存されているマニフェストは一覧表示の対象外となります。このプレフィックス配下に `.metadata.json` ファイルが存在する場合はそれらのみが候補となり、存在しない場合はディレクトリ全体が一覧表示されます。`iceberg_use_version_hint`、`iceberg_metadata_file_path`、`iceberg_metadata_table_uuid`、`iceberg_recent_metadata_file_by_last_updated_ms_field` のいずれかと併用した場合や、データレイクカタログデータベースのテーブルには適用されません。

この設定は、すべてのメタデータファイルが `v<N>...` という形式の名前 (ClickHouse および Hadoop カタログが使用する命名規則) であるテーブルに対してのみ有効化してください。`<N>-<uuid>.metadata.json` ファイルが混在するディレクトリでは、それらのファイルが候補になることはないため、それらを書き込んだライターによるコミットは認識されません。

## iceberg\_manifest\_decode\_concurrency

**別名**: `iceberg_delete_manifest_decode_concurrency`

型

NonZeroUInt64

デフォルト値

16

テーブルの読み取り中に同時実行でデコードされる Iceberg マニフェストファイルの最大数です。

削除マニフェストは、データファイルが 1 つでも読み取られる前にすべてデコードされます。データマニフェストは、クエリ対象のデータファイル一覧が生成される間にデコードされ、クエリがデコード済みのエントリを消費するのに合わせて新たなものがデコードされます。複数のマニフェストを同時にデコードすることで、object storage へのラウンドトリップとエントリごとの pruning 処理を重ね合わせることができます。

Iceberg metadata files cache が無効、または満杯の場合、転送中の各マニフェストがそれぞれデコード済みの内容を保持するため、値を大きくするとピークメモリが増加します。

ゼロより大きい値である必要があります。`1` の場合はマニフェストを 1 つずつデコードします。

## iceberg\_manifest\_min\_count\_to\_compact

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

UInt64

デフォルト値

100

OPTIMIZE TABLE ... MANIFEST によるマニフェストのみの コンパクション をトリガーするために必要な、最小のマニフェストファイル数です。
現在のマニフェストファイル数がこのしきい値以下の場合、コンパクション はスキップされます。
allow\_experimental\_iceberg\_compaction を有効にする必要があります。

デフォルト値は、Iceberg テーブルプロパティ `commit.manifest.min-count-to-merge` のドキュメント記載のデフォルト値 (100) に準じています。
[https://iceberg.apache.org/docs/1.5.2/configuration/](https://iceberg.apache.org/docs/1.5.2/configuration/) を参照してください。

## iceberg\_max\_number\_datafiles\_to\_compact

型

UInt64

デフォルト値

1000

Iceberg における コンパクション data files のしきい値。

## iceberg\_orphan\_files\_min\_retention\_seconds

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

UInt64

デフォルト値

86400

`ALTER TABLE ... EXECUTE remove_orphan_files` が Icebergテーブルから削除できるファイルの最小経過時間 (秒) です。`older_than` (明示的に指定された値、または `iceberg_orphan_files_older_than_seconds` から導出された値) が現在時刻からこの値よりも近い場合、その指定は拒否されます。まだコミットされていない書き込みのファイルはテーブルのメタデータから参照されていないため削除対象となり、その書き込みがコミットされた時点でテーブルが破損するためです。テーブルへの書き込みのコミットに要しうる最長時間よりも大きい値を設定してください。0 を指定するとこのチェックは無効になります。

## iceberg\_orphan\_files\_older\_than\_seconds

[実験的な機能](https://clickhouse.com/docs/reference/settings/beta-and-experimental-features.md#experimental-features)

型

UInt64

デフォルト値

259200

Icebergテーブルで孤立ファイルを削除する際の、デフォルトの経過時間しきい値 (秒) です。これより新しいファイルは孤立ファイルと見なされません。`remove_orphan_files()` プロシージャ呼び出しで `older_than` 引数が省略された場合に使用されます。デフォルトは259200 (3日) です。

## iceberg\_snapshot\_id

型

Int64

デフォルト値

0

特定のスナップショット ID を使用して Iceberg テーブルをクエリします。

## iceberg\_timestamp\_ms

型

Int64

デフォルト値

0

特定のタイムスタンプ時点で有効だったスナップショットを使用してIcebergテーブルをクエリします。

## iceberg\_tolerate\_conflicting\_manifest\_schemas

型

Bool

デフォルト値

1

有効な場合、Iceberg のマニフェストファイルの schema-id が metadata.json からすでに登録されていれば、metadata.json のスキーマが使用され、マニフェストファイルヘッダーの `schema` キーにあるコピーは比較されずに無視されます。無効な場合、マニフェストヘッダー側のコピーは metadata.json のスキーマと比較され、競合が発生するとクエリは ICEBERG\_SPECIFICATION\_VIOLATION エラーで失敗します。

マニフェストヘッダーのスキーマは、マニフェストが書き込まれた時点のテーブルスキーマのコピーにすぎず、一部の writer (例: AWS S3 Tables のメンテナンスジョブ) がそこに劣化したコピーを保存する事例が確認されています。他のクエリエンジンは metadata.json からスキーマを解決し、内容が食い違うヘッダー側のコピーを無視するため、デフォルトの挙動もそれに倣っています。なお、2 つの metadata.json のスキーマ定義間に競合がある場合は、引き続き常にクエリが失敗します。
