> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # distributed_plan_* セッション設定 > ClickHouse の distributed_plan_* 生成グループに含まれるセッション設定。 export const PrivatePreviewBadge = () => { return

{'プライベートプレビュー'}

; }; export const ExperimentalBadge = () => { return

実験的な機能 ; }; export const VersionHistory = ({rows = []}) => { if (rows.length === 0) { return null; } const headers = ["バージョン", "デフォルト値", "コメント"]; const border = "1px solid rgba(128, 128, 128, 0.3)"; const cell = { border, padding: "0.25rem 0.5rem", textAlign: "start", verticalAlign: "top" }; return

バージョン履歴

{headers.map(header => )} {rows.map((row, row_index) => {(row.items ?? []).map((item, item_index) => )} )}

{header}
{item?.label}

; }; export const SettingsInfoBlock = ({type, default_value, changeable_without_restart}) => { return

型

{type}

デフォルト値

{default_value}

{changeable_without_restart &&

再起動せずに変更可能

} {changeable_without_restart &&

{changeable_without_restart}

}

; }; これらの設定は [system.settings](/ja/reference/system-tables/settings) にあり、[ソース](https://github.com/ClickHouse/ClickHouse/blob/master/src/Core/Settings.cpp) から自動生成されています。 ## distributed\_plan\_default\_reader\_bucket\_count 分散クエリで並列読み取りを行う際のデフォルトのタスク数です。タスクはレプリカ間に分散されます。ルールベースの分散プランナーで使用されます。コストベースのオプティマイザは推定コストに基づいて読み取りのファンアウトを選択するため、この設定は使用しません。 ## distributed\_plan\_default\_shuffle\_join\_bucket\_count 分散 shuffle-hash-join のデフォルトのバケット数。ルールベースの分散プランナーで使用されます。コストベースのオプティマイザは推定コストに基づいてファンアウトを選択するため、この設定は使用しません。 ## distributed\_plan\_execute\_locally 分散クエリプランのすべてのタスクをローカルで実行します。テストやデバッグに有用です。 ## distributed\_plan\_fallback\_to\_local\_execution クエリプランに分散実行に対応していないステップが含まれている場合、例外をスローするのではなく、その理由をログに記録してイニシエーター上でクエリを実行します。無効にすると、代わりに例外がスローされます。 `make_distributed_plan` (プライベートプレビュー) が有効な場合にのみ有効になります。 ## distributed\_plan\_force\_exchange\_kind 分散クエリのステージ間で、指定した種類の Exchange 演算子を強制します。設定可能な値: * '' - どの種類の Exchange 演算子も強制せず、オプティマイザに選択させます。 * 'Persisted' - オブジェクトストレージ内の一時ファイルを使用します。 * 'Streaming' - Exchange データをネットワーク経由でストリーミングします。 ## distributed\_plan\_force\_shuffle\_aggregation 分散クエリプランでは、PartialAggregation + Merge の代わりに Shuffle 集約戦略を使用します。 Shuffle 戦略が正しい結果を生成できない場合、たとえば `GROUPING SETS` の場合や、集約が bucket 順で結果を生成しなければならない場合には無視されます。 ## distributed\_plan\_max\_rows\_to\_broadcast 分散クエリプランで、shuffle join の代わりに broadcast join を使用する際の最大行数。ルールベースの分散プランナーにおけるヒューリスティックです。コストベースのオプティマイザが有効な場合、broadcast と shuffle の選択は推定コストに基づいて行われるため、この設定は効果がありません。 ## distributed\_plan\_optimize\_exchanges 分散クエリプラン内の不要な Exchange を削除します。デバッグ時は無効にしてください。 ## distributed\_plan\_prefer\_replicas\_over\_workers レプリカで実行できるよう、分散クエリプランをシリアライズします。 ## distributed\_plan\_read\_in\_order 分散クエリプランにおける `ORDER BY` の read-in-order 最適化を許可します。これにより、スキャンしてソートする代わりに、テーブルのソーティングキー順に読み取ることでソートを省略し、早期に処理を打ち切れます。デフォルトでは無効です。ソートを分散させる rewrite は、対象のソートが「入力が既に順序付けられていること」に依存しないことを前提としていますが、実際に依存するソートに対しては、順序を保持しない exchange を経由して行が供給される可能性があります。現時点で安全なのは、読み取りとソートの間に exchange が残らない shape のみです。 ## distributed\_plan\_workers\_num このクエリの実行に使用するステートレスワーカーの数。0 を指定すると、分散プランでのステートレスワーカーのリースは無効になります。 ## distributed\_plan\_workers\_provisioning\_timeout\_ms 実行前に、クエリがステートレスワーカーのプロビジョニングに費やせる合計実時間 (ミリ秒) 。これには、discovery service からのワーカーのリースと、その到達可能性の検証が含まれます。クエリは、リースされたワーカーの準備が完了するまで、この時間の範囲内でブロックします。時間切れになると、それまでに検証済みのワーカーでクエリを続行するか、利用可能なワーカーが1つもない場合は失敗します。ゼロの場合は、最初のリースと検証のパスでのみ待機します (再試行は行いません) 。