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

group_by_overflow_mode

集約に使用する一意なキーの数が上限を超えた場合の動作を設定します。
  • throw: 例外を送出する
  • break: クエリの実行を停止し、途中までの結果を返す
  • any: set に含まれているキーについては集約を続行しますが、新しいキーは set に追加しません。
any を使用すると、GROUP BY の近似結果を得られます。この近似の精度は、 データの統計的な性質に依存します。

group_by_two_level_threshold

この数以上のキーになると、二段階集約が開始されます。0 の場合、しきい値は設定されません。

group_by_two_level_threshold_bytes

集約状態のサイズが何バイト以上になると二段階集約を使用し始めるかを指定します。0 の場合、しきい値は設定されません。いずれか 1 つのしきい値がトリガーされると、二段階集約が使用されます。

group_by_use_nulls

GROUP BY 句で集約キーの型をどのように扱うかを変更します。 ROLLUPCUBE、または GROUPING SETS 指定子を使用すると、一部の結果行の生成時に使われない集約キーが生じることがあります。 この設定に応じて、これらのキーに対応するカラムは、該当する行でデフォルト値または NULL で埋められます。 設定可能な値:
  • 0 — 欠損値の生成には、集約キー型のデフォルト値が使用されます。
  • 1 — ClickHouse は SQL 標準に従って GROUP BY を実行します。集約キーの型は Nullable に変換されます。対応する集約キーのカラムは、そのキーが使われなかった行では NULL で埋められます。
関連項目:
最終更新日 2026年7月23日