Skip to content

Commit 862d08c

Browse files
committed
Refine some tiflash docs
Signed-off-by: JaySon-Huang <[email protected]>
1 parent 112a825 commit 862d08c

File tree

2 files changed

+5
-37
lines changed

2 files changed

+5
-37
lines changed

tiflash/tiflash-configuration.md

+4-36
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,13 @@
11
---
22
title: TiFlash 配置参数
33
aliases: ['/docs-cn/dev/tiflash/tiflash-configuration/','/docs-cn/dev/reference/tiflash/configuration/']
4-
summary: TiFlash 配置参数包括 PD 调度参数和 TiFlash 配置参数。PD 调度参数可通过 pd-ctl 调整,包括 replica-schedule-limit 和 store-balance-rate。TiFlash 配置参数包括 tiflash.toml 和 tiflash-learner.toml,用于配置 TiFlash TCP/HTTP 服务的监听和存储路径。另外,通过拓扑 label 进行副本调度和多盘部署也是可行的。
4+
summary: TiFlash 配置参数。TiFlash 配置参数包括 tiflash.toml 和 tiflash-learner.toml,用于配置 TiFlash TCP/HTTP 服务的监听和存储路径。另外,通过拓扑 label 进行副本调度和多盘部署也是可行的。
55
---
66

77
# TiFlash 配置参数
88

99
本文介绍了与部署使用 TiFlash 相关的配置参数。
1010

11-
## PD 调度参数
12-
13-
可通过 [pd-ctl](/pd-control.md) 调整参数。如果你使用 TiUP 部署,可以用 `tiup ctl:v<CLUSTER_VERSION> pd` 代替 `pd-ctl -u <pd_ip:pd_port>` 命令。
14-
15-
- [`replica-schedule-limit`](/pd-configuration-file.md#replica-schedule-limit):用来控制 replica 相关 operator 的产生速度(涉及到下线、补副本的操作都与该参数有关)
16-
17-
> **注意:**
18-
>
19-
> 不要超过 `region-schedule-limit`,否则会影响正常 TiKV 之间的 Region 调度。
20-
21-
- `store-balance-rate`:用于限制每个 TiKV store 或 TiFlash store 的 Region 调度速度。注意这个参数只对新加入集群的 store 有效,如果想立刻生效请用下面的方式。
22-
23-
> **注意:**
24-
>
25-
> 4.0.2 版本之后(包括 4.0.2 版本)废弃了 `store-balance-rate` 参数且 `store limit` 命令有部分变化。该命令变化的细节请参考 [store-limit 文档](/configure-store-limit.md)
26-
27-
- 使用 `pd-ctl -u <pd_ip:pd_port> store limit <store_id> <value>` 命令单独设置某个 store 的 Region 调度速度。(`store_id` 可通过 `pd-ctl -u <pd_ip:pd_port> store` 命令获得)如果没有单独设置,则继承 `store-balance-rate` 的设置。你也可以使用 `pd-ctl -u <pd_ip:pd_port> store limit` 命令查看当前设置值。
28-
29-
- [`replication.location-labels`](/pd-configuration-file.md#location-labels):用来表示 TiKV 实例的拓扑关系,其中 key 的顺序代表了不同标签的层次关系。在 TiFlash 开启的情况下需要使用 [`pd-ctl config placement-rules`](/pd-control.md#config-show--set-option-value--placement-rules) 来设置默认值,详细可参考 [geo-distributed-deployment-topology](/geo-distributed-deployment-topology.md)
30-
3111
## TiFlash 配置参数
3212

3313
> **Tip:**
@@ -379,8 +359,8 @@ I/O 限流功能相关配置。
379359

380360
- 所有查询过程中,节点对中间数据的内存限制。
381361
- 设置为整数时,单位为 byte,比如 `34359738368` 表示 32 GiB 的内存限制,`0` 表示无限制。
382-
- 设置为 `[0.0, 1.0)` 之间的浮点数时,指节点总内存的比值,比如 `0.8` 表示总内存的 80%,`0.0` 表示无限制。
383-
- 当查询试图申请超过限制的内存时,查询终止执行并且报错
362+
- 从 v6.6.0 开始支持设置为 `[0.0, 1.0)` 之间的浮点数。当设置为浮点数时,该值指节点总内存的比值,比如 `0.8` 表示总内存的 80%,`0.0` 表示无限制。
363+
- 当查询试图申请超过限制的内存时,查询终止执行并且报错
384364
- 默认值:`0.8`,表示总内存的 80%
385365

386366
##### `cop_pool_size` <span class="version-mark">从 v5.0 版本开始引入</span>
@@ -597,19 +577,7 @@ I/O 限流功能相关配置。
597577

598578
TiFlash 支持单节点多盘部署。如果你的部署节点上有多块硬盘,可以通过以下的方式配置参数,提高节点的硬盘 I/O 利用率。TiUP 中参数配置格式参照[详细 TiFlash 配置模版](/tiflash-deployment-topology.md#拓扑模版)
599579

600-
#### TiDB 集群版本低于 v4.0.9
601-
602-
TiDB v4.0.9 之前的版本中,TiFlash 只支持将存储引擎中的主要数据分布在多盘上。通过 `path`(TiUP 中为 `data_dir`)和 `path_realtime_mode` 这两个参数配置多盘部署。
603-
604-
多个数据存储目录在 `path` 中以英文逗号分隔,比如 `/nvme_ssd_a/data/tiflash,/sata_ssd_b/data/tiflash,/sata_ssd_c/data/tiflash`。如果你的节点上有多块硬盘,推荐把性能最好的硬盘目录放在最前面,以更好地利用节点性能。
605-
606-
如果节点上有多块相同规格的硬盘,可以把 `path_realtime_mode` 参数留空(或者把该值明确地设为 `false`)。这表示数据会在所有的存储目录之间进行均衡。但由于最新的数据仍然只会被写入到第一个目录,因此该目录所在的硬盘会较其他硬盘繁忙。
607-
608-
如果节点上有多块规格不一致的硬盘,推荐把 `path_relatime_mode` 参数设置为 `true`,并且把性能最好的硬盘目录放在 `path` 参数内的最前面。这表示第一个目录只会存放最新数据,较旧的数据会在其他目录之间进行均衡。注意此情况下,第一个目录规划的容量大小需要占总容量的约 10%。
609-
610-
#### TiDB 集群版本为 v4.0.9 及以上
611-
612-
TiDB v4.0.9 及之后的版本中,TiFlash 支持将存储引擎的主要数据和新数据都分布在多盘上。多盘部署时,推荐使用 `[storage]` 中的参数,以更好地利用节点的 I/O 性能。但 TiFlash 仍然支持 [TiDB 集群版本低于 v4.0.9](#tidb-集群版本低于-v409) 中的参数。
580+
TiDB v4.0.9 及之后的版本中,TiFlash 支持将存储引擎的主要数据和新数据都分布在多盘上。多盘部署时,推荐使用 `[storage]` 中的参数,以更好地利用节点的 I/O 性能。
613581

614582
如果节点上有多块相同规格的硬盘,推荐把硬盘目录填到 `storage.main.dir` 列表中,`storage.latest.dir` 列表留空。TiFlash 会在所有存储目录之间分摊 I/O 压力以及进行数据均衡。
615583

tiflash/troubleshoot-tiflash.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -265,7 +265,7 @@ show warnings;
265265
266266
同步慢可能由多种原因引起,你可以按以下步骤进行排查。
267267
268-
1. 调大调度参数 [`store limit`](/configure-store-limit.md#使用方法),加快同步速度。
268+
1. 参考 [加快 TiFlash 副本同步速度](create-tiflash-replicas.md#加快-tiflash-副本同步速度) 调整调度参数,加快同步速度。
269269
270270
2. 调整 TiFlash 侧负载。
271271

0 commit comments

Comments
 (0)