From accd98f56842b18b96265ca0a861440161bed628 Mon Sep 17 00:00:00 2001 From: hehechen Date: Wed, 15 Dec 2021 14:15:33 +0800 Subject: [PATCH 1/7] Update tiflash-configuration.md, add description of tiflash-proxy apply-pool-size and store-pool-size configuration --- tiflash/tiflash-configuration.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 95ecd6969a93..8729fce8d82e 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -176,6 +176,10 @@ delta_index_cache_size = 0 [server] engine-addr = 外部访问 TiFlash coprocessor 服务的地址 [raftstore] + ## 处理 Raft 数据落盘的线程池中线程的数量 + apply-pool-size = 4 + ## 表示处理 Raft 的线程池中线程的数量，即 Raftstore 线程池的大小。 + store-pool-size = 4 ## 控制处理 snapshot 的线程数，默认为 2。设为 0 则关闭多线程优化 snap-handle-pool-size = 2 ## 控制 raft store 持久化 WAL 的最小间隔。通过适当增大延迟以减少 IOPS 占用，默认为 4ms，设为 0ms 则关闭该优化。 From db0e3a92bdf43a3bcade01fae859191fc0401256 Mon Sep 17 00:00:00 2001 From: hehechen Date: Wed, 15 Dec 2021 14:58:52 +0800 Subject: [PATCH 2/7] Update tiflash-configuration.md, change some default value of configurations. --- tiflash/tiflash-configuration.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 8729fce8d82e..440ddbdb35e6 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -130,17 +130,21 @@ delta_index_cache_size = 0 advertise-status-addr = 外部访问 status-addr 的地址，不填则默认是 status-addr [logger] - level = log 级别（支持 trace、debug、information、warning、error） + ## log 级别（支持 trace、debug、information、warning、error），默认是 debug + level = debug log = TiFlash log 路径 errorlog = TiFlash error log 路径 - size = 单个日志文件的大小 - count = 最多保留日志文件个数 + ## 单个日志文件的大小，默认是 100 MB + size = "100M" + ## 最多保留日志文件个数，默认是 10 + count = 10 [raft] pd_addr = pd 服务地址 # 多个地址以逗号隔开 [status] - metrics_port = Prometheus 拉取 metrics 信息的端口 + ## Prometheus 拉取 metrics 信息的端口，默认是 8234 + metrics_port = 8234 [profiles] @@ -180,8 +184,8 @@ delta_index_cache_size = 0 apply-pool-size = 4 ## 表示处理 Raft 的线程池中线程的数量，即 Raftstore 线程池的大小。 store-pool-size = 4 - ## 控制处理 snapshot 的线程数，默认为 2。设为 0 则关闭多线程优化 - snap-handle-pool-size = 2 + ## 控制处理 snapshot 的线程数，默认为 4。设为 0 则关闭多线程优化 + snap-handle-pool-size = 4 ## 控制 raft store 持久化 WAL 的最小间隔。通过适当增大延迟以减少 IOPS 占用，默认为 4ms，设为 0ms 则关闭该优化。 store-batch-retry-recv-timeout = "4ms" ``` From e4d244348eb5b18bd9090df70a2b6e5c3ec108bc Mon Sep 17 00:00:00 2001 From: TomShawn <41534398+TomShawn@users.noreply.github.com> Date: Thu, 30 Dec 2021 16:27:25 +0800 Subject: [PATCH 3/7] Update tiflash/tiflash-configuration.md Co-authored-by: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 440ddbdb35e6..cffe3f50ab94 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -182,7 +182,7 @@ delta_index_cache_size = 0 [raftstore] ## 处理 Raft 数据落盘的线程池中线程的数量 apply-pool-size = 4 - ## 表示处理 Raft 的线程池中线程的数量，即 Raftstore 线程池的大小。 + ## 处理 Raft 的线程池中线程的数量，即 Raftstore 线程池的大小。 store-pool-size = 4 ## 控制处理 snapshot 的线程数，默认为 4。设为 0 则关闭多线程优化 snap-handle-pool-size = 4 From 45585e8641f4f9215961d597a671c40814064088 Mon Sep 17 00:00:00 2001 From: hehechen Date: Thu, 30 Dec 2021 16:31:54 +0800 Subject: [PATCH 4/7] Update tiflash-configuration.md --- tiflash/tiflash-configuration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index cffe3f50ab94..e6e5d9497d62 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -184,8 +184,8 @@ delta_index_cache_size = 0 apply-pool-size = 4 ## 处理 Raft 的线程池中线程的数量，即 Raftstore 线程池的大小。 store-pool-size = 4 - ## 控制处理 snapshot 的线程数，默认为 4。设为 0 则关闭多线程优化 - snap-handle-pool-size = 4 + ## 控制处理 snapshot 的线程数，默认为 2。设为 0 则关闭多线程优化 + snap-handle-pool-size = 2 ## 控制 raft store 持久化 WAL 的最小间隔。通过适当增大延迟以减少 IOPS 占用，默认为 4ms，设为 0ms 则关闭该优化。 store-batch-retry-recv-timeout = "4ms" ``` From 98823d2755cd71c31f64e8bec0958b7710392d6c Mon Sep 17 00:00:00 2001 From: hehechen Date: Thu, 6 Jan 2022 17:53:17 +0800 Subject: [PATCH 5/7] Update tiflash-configuration.md --- tiflash/tiflash-configuration.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index e6e5d9497d62..e8fdab596273 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -120,13 +120,13 @@ delta_index_cache_size = 0 log = pd buddy log 路径 [flash.proxy] - addr = proxy 监听地址 + addr = proxy 监听地址，不填则默认是 127.0.0.1:20170 advertise-addr = 外部访问 addr 的地址，不填则默认是 addr data-dir = proxy 数据存储路径 config = proxy 配置文件路径 log-file = proxy log 路径 log-level = proxy log 级别，默认为 "info" - status-addr = 拉取 proxy metrics｜status 信息的监听地址 + status-addr = 拉取 proxy metrics｜status 信息的监听地址，不填则默认是127.0.0.1:20292 advertise-status-addr = 外部访问 status-addr 的地址，不填则默认是 status-addr [logger] From 6d2ca8612cf173a7a07d5a670640d0f4bd088012 Mon Sep 17 00:00:00 2001 From: shichun-0415 Date: Fri, 7 Jan 2022 19:21:09 +0800 Subject: [PATCH 6/7] Unify the style --- tiflash/tiflash-configuration.md | 14 +++++++------- tiflash/use-tiflash.md | 14 +++++++------- 2 files changed, 14 insertions(+), 14 deletions(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index e8fdab596273..4006f990c029 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -121,20 +121,20 @@ delta_index_cache_size = 0 [flash.proxy] addr = proxy 监听地址，不填则默认是 127.0.0.1:20170 - advertise-addr = 外部访问 addr 的地址，不填则默认是 addr + advertise-addr = 外部访问 addr 的地址，不填则默认是 "addr" data-dir = proxy 数据存储路径 config = proxy 配置文件路径 log-file = proxy log 路径 - log-level = proxy log 级别，默认为 "info" - status-addr = 拉取 proxy metrics｜status 信息的监听地址，不填则默认是127.0.0.1:20292 - advertise-status-addr = 外部访问 status-addr 的地址，不填则默认是 status-addr + log-level = proxy log 级别，默认是 "info" + status-addr = 拉取 proxy metrics｜status 信息的监听地址，不填则默认是 127.0.0.1:20292 + advertise-status-addr = 外部访问 status-addr 的地址，不填则默认是 "status-addr" [logger] - ## log 级别（支持 trace、debug、information、warning、error），默认是 debug + ## log 级别（支持 trace、debug、information、warning、error），默认是 "debug" level = debug log = TiFlash log 路径 errorlog = TiFlash error log 路径 - ## 单个日志文件的大小，默认是 100 MB + ## 单个日志文件的大小，默认是 "100 M" size = "100M" ## 最多保留日志文件个数，默认是 10 count = 10 @@ -186,7 +186,7 @@ delta_index_cache_size = 0 store-pool-size = 4 ## 控制处理 snapshot 的线程数，默认为 2。设为 0 则关闭多线程优化 snap-handle-pool-size = 2 - ## 控制 raft store 持久化 WAL 的最小间隔。通过适当增大延迟以减少 IOPS 占用，默认为 4ms，设为 0ms 则关闭该优化。 + ## 控制 raft store 持久化 WAL 的最小间隔。通过适当增大延迟以减少 IOPS 占用，默认为 "4ms"，设为 "0ms" 则关闭该优化。 store-batch-retry-recv-timeout = "4ms" ``` diff --git a/tiflash/use-tiflash.md b/tiflash/use-tiflash.md index 6ebd58fa0ba8..7047b7689c00 100644 --- a/tiflash/use-tiflash.md +++ b/tiflash/use-tiflash.md @@ -148,7 +148,7 @@ SELECT * FROM information_schema.tiflash_replica WHERE TABLE_SCHEMA = ' ... ``` - + 关于使用 label 进行副本调度划分可用区的更多内容，可以参考[通过拓扑 label 进行副本调度](/schedule-replicas-by-topology-labels.md)，[同城多数据中心部署 TiDB](/multi-data-centers-in-one-city-deployment.md) 与[两地三中心部署](/three-data-centers-in-two-cities-deployment.md)。 ## 使用 TiDB 读取 TiFlash @@ -321,7 +321,7 @@ TiFlash 支持部分算子的下推，支持的算子如下： * 聚合函数：`min, max, sum, count, avg, approx_count_distinct, group_concat` * 其他函数：`inetntoa, inetaton, inet6ntoa, inet6aton` -另外，所有包含 Bit/Set/Geometry 类型的表达式均不能下推到 TiFlash。 +另外，所有包含 Bit、Set 和 Geometry 类型的表达式均不能下推到 TiFlash。 如查询遇到不支持的下推计算，则需要依赖 TiDB 完成剩余计算，可能会很大程度影响 TiFlash 加速效果。对于暂不支持的算子/表达式，将会在后续版本中陆续支持。 @@ -371,18 +371,18 @@ Session 变量 `tidb_enforce_mpp` 的初始值等于这台 tidb-server 实例的 > **注意：** > > `tidb_enforce_mpp=1` 在生效时，TiDB 优化器会忽略代价估算选择 MPP 模式。但如果存在其它不支持 MPP 的因素，例如没有 TiFlash 副本、TiFlash 副本同步未完成、语句中含有 MPP 模式不支持的算子或函数等，那么 TiDB 仍然不会选择 MPP 模式。 -> +> > 如果由于代价估算之外的原因导致 TiDB 优化器无法选择 MPP，在你使用 `EXPLAIN` 语句查看执行计划时，会返回警告说明原因，例如： -> +> > {{< copyable "sql" >}} -> +> > ```sql > set @@session.tidb_enforce_mpp=1; > create table t(a int); -> explain select count(*) from t; +> explain select count(*) from t; > show warnings; > ``` -> +> > ``` > +---------+------+-----------------------------------------------------------------------------+ > | Level | Code | Message | From 7c8cd3ec9a51262155918c15d32e674f169c1ff3 Mon Sep 17 00:00:00 2001 From: shichun-0415 <89768198+shichun-0415@users.noreply.github.com> Date: Fri, 7 Jan 2022 19:58:02 +0800 Subject: [PATCH 7/7] Update tiflash/tiflash-configuration.md --- tiflash/tiflash-configuration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tiflash/tiflash-configuration.md b/tiflash/tiflash-configuration.md index 5d6ca07dff3a..430c1f684bee 100644 --- a/tiflash/tiflash-configuration.md +++ b/tiflash/tiflash-configuration.md @@ -134,7 +134,7 @@ delta_index_cache_size = 0 level = debug log = TiFlash log 路径 errorlog = TiFlash error log 路径 - ## 单个日志文件的大小，默认是 "100 M" + ## 单个日志文件的大小，默认是 "100M" size = "100M" ## 最多保留日志文件个数，默认是 10 count = 10