|
1 | 1 | ---
|
2 | 2 | title: TiFlash 配置参数
|
3 | 3 | 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 进行副本调度和多盘部署也是可行的。 |
5 | 5 | ---
|
6 | 6 |
|
7 | 7 | # TiFlash 配置参数
|
8 | 8 |
|
9 | 9 | 本文介绍了与部署使用 TiFlash 相关的配置参数。
|
10 | 10 |
|
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 |
| - |
31 | 11 | ## TiFlash 配置参数
|
32 | 12 |
|
33 | 13 | > **Tip:**
|
@@ -379,8 +359,8 @@ I/O 限流功能相关配置。
|
379 | 359 |
|
380 | 360 | - 所有查询过程中,节点对中间数据的内存限制。
|
381 | 361 | - 设置为整数时,单位为 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 | +- 当查询试图申请超过限制的内存时,查询终止执行并且报错。 |
384 | 364 | - 默认值:`0.8`,表示总内存的 80%
|
385 | 365 |
|
386 | 366 | ##### `cop_pool_size` <span class="version-mark">从 v5.0 版本开始引入</span>
|
@@ -597,19 +577,7 @@ I/O 限流功能相关配置。
|
597 | 577 |
|
598 | 578 | TiFlash 支持单节点多盘部署。如果你的部署节点上有多块硬盘,可以通过以下的方式配置参数,提高节点的硬盘 I/O 利用率。TiUP 中参数配置格式参照[详细 TiFlash 配置模版](/tiflash-deployment-topology.md#拓扑模版)。
|
599 | 579 |
|
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 性能。 |
613 | 581 |
|
614 | 582 | 如果节点上有多块相同规格的硬盘,推荐把硬盘目录填到 `storage.main.dir` 列表中,`storage.latest.dir` 列表留空。TiFlash 会在所有存储目录之间分摊 I/O 压力以及进行数据均衡。
|
615 | 583 |
|
|
0 commit comments