From 9543f460656430d52d6aa99cc2cd01f74e058c51 Mon Sep 17 00:00:00 2001 From: guo-shaoge Date: Thu, 1 Aug 2024 15:32:02 +0800 Subject: [PATCH] system-variables: add tiflash_hashagg_preaggregation_mode Signed-off-by: guo-shaoge --- system-variables.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/system-variables.md b/system-variables.md index c726f3ea7dba..ff948a630d7c 100644 --- a/system-variables.md +++ b/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` 从 v8.3.0 版本开始引入 + +- 作用域：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` 从 v7.4.0 版本开始引入 - 作用域：SESSION | GLOBAL