Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

hdfs_* セッション設定

これらの設定は system.settings で参照でき、ソース から自動生成されています。

hdfs_create_new_file_on_insert

Bool
デフォルト値
0

HDFS エンジンのテーブルで、insert のたびに新しいファイルを作成するかどうかを切り替えます。有効にすると、insert のたびに次のような名前の新しい HDFS ファイルが作成されます。

initial: data.Parquet.gz -> data.1.Parquet.gz -> data.2.Parquet.gz など。

設定可能な値:

  • 0 — INSERT クエリで新しいデータがファイルの末尾に追記されます。
  • 1 — INSERT クエリで新しいファイルが作成されます。

hdfs_ignore_file_doesnt_exist

Bool
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
24.60HDFS table engineで、要求されたファイルが存在しない場合に、例外を発生させる代わりに0行を返せるようにします

特定のキーの読み取り時に、対象のファイルが存在しない場合は無視します。

設定可能な値:

  • 1 — SELECT は空の結果を返します。
  • 0 — SELECT は例外を発生させます。

hdfs_replication

UInt64
デフォルト値
0

実際のレプリカ数は、HDFS ファイルの作成時に指定できます。

hdfs_skip_empty_files

Bool
デフォルト値
0

HDFS エンジンのテーブルで、空のファイルをスキップする機能を有効または無効にします。

設定可能な値:

  • 0 — 空のファイルが指定されたフォーマットと互換性がない場合、SELECT は例外をスローします。
  • 1 — 空のファイルに対して、SELECT は空の結果を返します。

hdfs_throw_on_zero_files_match

Bool
デフォルト値
0
バージョン履歴
バージョンデフォルト値コメント
24.60ListObjects リクエストが HDFS engine でどのファイルにも一致しない場合に、空のクエリ結果を返す代わりにエラーをスローできるようにします

glob の展開ルールに従って一致するファイルが 0 個の場合にエラーをスローします。

設定可能な値:

  • 1 — SELECT は例外をスローします。
  • 0 — SELECT は空の結果を返します。

hdfs_truncate_on_insert

Bool
デフォルト値
0

HDFS エンジンのテーブルで insert を実行する前に、切り詰めを有効または無効にします。無効の場合、HDFS 内のファイルがすでに存在している状態で insert を実行しようとすると、例外がスローされます。

設定可能な値:

  • 0 — INSERT クエリは新しいデータをファイルの末尾に追加します。
  • 1 — INSERT クエリはファイルの既存の内容を新しいデータで置き換えます。
Navigation