system-variables: add tiflash_hashagg_preaggregation_mode

Signed-off-by: guo-shaoge <[email protected]>

system-variables.md

@@ -5189,6 +5189,18 @@ Query OK, 0 rows affected, 1 warning (0.00 sec)
 > - 如果 TiDB 节点未设置[区域属性](/schedule-replicas-by-topology-labels.md#设置-tidb-的-labels可选)，并且 TiFlash 副本选择策略不是 `all_replicas` 时，TiFlash 引擎将忽略 TiFlash 副本选择策略，使用所有 TiFlash 副本进行 TiFlash 查询，并且返回警告 `The variable tiflash_replica_read is ignored`。
 > - 如果 TiFlash 节点未设置[区域属性](/schedule-replicas-by-topology-labels.md#设置-tikv-和-tiflash-的-labels)，则将其视为不属于任何区域的节点。
 
+### `tiflash_hashagg_preaggregation_mode` <span class="version-mark">从 v8.3.0 版本开始引入</span>
+
+- 作用域：SESSION | GLOBAL
+- 是否持久化到集群：是
+- 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：是
+- 默认值：`auto`
+- 可选值：`auto`、`force_streaming`、`force_preagg`
+- 该变量用于控制下推到 TiFlash 的两阶段或者三阶段 HashAgg 的第一阶段采用哪种预聚合策略：
+    - `force_preagg`: 表示 TiFlash 会在第一阶段的 HashAgg 进行强制预聚合操作
+    - `force_streaming`: 表示 TiFlash 会直接将数据发送给下一阶段的 HashAgg ，不进行预聚合操作
+    - `auto`: 表示 TiFlash 会自动根据所看到的 workload 的聚合度进行判断是否进行预聚合
+
 ### `tikv_client_read_timeout` <span class="version-mark">从 v7.4.0 版本开始引入</span>
 
 - 作用域：SESSION | GLOBAL