Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

distributed_ddl_* セッション設定

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

distributed_ddl_entry_format_version

UInt64
デフォルト値
5

分散 DDL (ON CLUSTER) クエリの互換性バージョン

Cloud でのデフォルト値: 6

distributed_ddl_output_mode

DistributedDDLOutputMode
デフォルト値
throw

分散 DDL クエリの結果のフォーマットを設定します。

設定可能な値:

  • throw — クエリが完了したすべてのホストについて、クエリ実行ステータスを含む結果セットを返します。一部のホストでクエリが失敗した場合は、最初の例外を再スローします。一部のホストでクエリがまだ完了しておらず、distributed_ddl_task_timeout を超過した場合は、TIMEOUT_EXCEEDED 例外をスローします。
  • nonethrow と似ていますが、分散 DDL クエリは結果セットを返しません。
  • null_status_on_timeout — 対応するホストでクエリがまだ完了していない場合、TIMEOUT_EXCEEDED をスローする代わりに、結果セットの一部の行で実行ステータスとして NULL を返します。
  • never_throw — 一部のホストでクエリが失敗していても、TIMEOUT_EXCEEDED をスローせず、例外の再スローも行いません。
  • none_only_active - none と似ていますが、Replicated データベースの非アクティブなレプリカは待機しません。注: このモードでは、クエリが一部のレプリカで実行されておらず、バックグラウンドで実行されることを確認できません。
  • null_status_on_timeout_only_activenull_status_on_timeout と似ていますが、Replicated データベースの非アクティブなレプリカは待機しません
  • throw_only_activethrow と似ていますが、Replicated データベースの非アクティブなレプリカは待機しません

Cloud でのデフォルト値: none_only_active.

distributed_ddl_task_timeout

Int64
デフォルト値
180

クラスター内のすべてのホストからの DDLクエリの応答に対するタイムアウトを設定します。DDLリクエストがすべてのホストで実行されなかった場合、応答にはタイムアウトエラーが含まれ、リクエストは async モードで実行されます。負の値は無限を意味します。

設定可能な値:

  • 正の整数。
  • 0 — async モード。
  • 負の整数 — 無限タイムアウト。
Navigation