Merge branch 'master' into add-doc-for-external-timestamp-read

pingcap · Nov 2, 2022 · 2a2abcc · 2a2abcc
2 parents 6a9113a + 3b1c5c9
commit 2a2abcc
Show file tree

Hide file tree

Showing 113 changed files with 3,386 additions and 1,900 deletions.
diff --git a/TOC.md b/TOC.md
@@ -18,7 +18,7 @@
 - 应用开发
   - [概览](/develop/dev-guide-overview.md)
   - 快速开始
-    - [使用 TiDB Cloud (Developer Tier) 构建 TiDB 集群](/develop/dev-guide-build-cluster-in-cloud.md)
+    - [使用 TiDB Cloud (Serverless Tier) 构建 TiDB 集群](/develop/dev-guide-build-cluster-in-cloud.md)
     - [使用 TiDB 的增删改查 SQL](/develop/dev-guide-tidb-crud-sql.md)
     - 构建简单的 CRUD 应用程序
       - [Java](/develop/dev-guide-sample-application-java.md)
@@ -76,8 +76,9 @@
       - [SQL 开发规范](/develop/dev-guide-sql-development-specification.md)
   - 云原生开发环境
     - [Gitpod](/develop/dev-guide-playground-gitpod.md)
-  - 第三方软件支持
+  - 第三方工具支持
     - [TiDB 支持的第三方工具](/develop/dev-guide-third-party-support.md)
+    - [已知的第三方工具兼容问题](/develop/dev-guide-third-party-tools-compatibility.md)
     - [TiDB 与 ProxySQL 集成](/develop/dev-guide-proxysql-integration.md)
 - 部署标准集群
   - [软硬件环境需求](/hardware-and-software-requirements.md)
@@ -109,6 +110,7 @@
     - [从大数据量分库分表 MySQL 合并迁移数据到 TiDB](/migrate-large-mysql-shards-to-tidb.md)
     - [从 CSV 文件迁移数据到 TiDB](/migrate-from-csv-files-to-tidb.md)
     - [从 SQL 文件迁移数据到 TiDB](/migrate-from-sql-files-to-tidb.md)
+    - [从 Parquet 文件迁移数据到 TiDB](/migrate-from-parquet-files-to-tidb.md)
     - [从 TiDB 集群迁移数据至另一 TiDB 集群](/migrate-from-tidb-to-tidb.md)
     - [从 TiDB 集群迁移数据至兼容 MySQL 的数据库](/migrate-from-tidb-to-mysql.md)
   - 复杂迁移场景
@@ -156,6 +158,7 @@
   - [通过日志定位消耗系统资源多的查询](/identify-expensive-queries.md)
   - [SQL 语句统计](/statement-summary-tables.md)
   - [保存和恢复集群现场信息](/sql-plan-replayer.md)
+  - [TiDB OOM 故障排查](/troubleshoot-tidb-oom.md)
   - [TiDB 集群常见问题](/troubleshoot-tidb-cluster.md)
   - [TiDB 集群问题导图](/tidb-troubleshooting-map.md)
   - [热点问题处理](/troubleshoot-hot-spot-issues.md)
@@ -222,9 +225,9 @@
       - [执行计划管理](/sql-plan-management.md)
       - [优化规则及表达式下推的黑名单](/blocklist-control-plan.md)
 - 教程
-  - [同城多中心部署](/multi-data-centers-in-one-city-deployment.md)
-  - [两地三中心部署](/three-data-centers-in-two-cities-deployment.md)
-  - [同城两中心部署](/two-data-centers-in-one-city-deployment.md)
+  - [单区域多 AZ 部署](/multi-data-centers-in-one-city-deployment.md)
+  - [双区域多 AZ 部署](/three-data-centers-in-two-cities-deployment.md)
+  - [单区域双 AZ 部署](/two-data-centers-in-one-city-deployment.md)
   - 读取历史数据
     - 使用 Stale Read 功能读取历史数据（推荐）
       - [Stale Read 使用场景介绍](/stale-read.md)
@@ -921,11 +924,13 @@
   - v6.2
     - [6.2.0-DMR](/releases/release-6.2.0.md)
   - v6.1
+    - [6.1.2](/releases/release-6.1.2.md)
     - [6.1.1](/releases/release-6.1.1.md)
     - [6.1.0](/releases/release-6.1.0.md)
   - v6.0
     - [6.0.0-DMR](/releases/release-6.0.0-dmr.md)
   - v5.4
+    - [5.4.3](/releases/release-5.4.3.md)
     - [5.4.2](/releases/release-5.4.2.md)
     - [5.4.1](/releases/release-5.4.1.md)
     - [5.4.0](/releases/release-5.4.0.md)

diff --git a/analyze-slow-queries.md b/analyze-slow-queries.md
@@ -57,7 +57,7 @@ summary: 学习如何定位和分析慢查询。
 
 ### TiKV 处理慢
 
-如果是 TiKV 处理慢，可以很明显的通过 `explain analyze` 中看出来。例如下面这个例子，可以看到 `StreamAgg_8` 和 `TableFullScan_15` 这两个 `tikv-task` （在 `task` 列可以看出这两个任务类型是 `cop[tikv]`） 花费了 `170ms`，而 TiDB 部分的算子耗时，减去这 `170ms` 后，耗时占比非常小，说明瓶颈在 TiKV。
+如果是 TiKV 处理慢，可以很明显的通过 `explain analyze` 中看出来。例如下面这个例子，可以看到 `StreamAgg_8` 和 `TableFullScan_15` 这两个 `tikv-task` （在 `task` 列可以看出这两个任务类型是 `cop[tikv]`）花费了 `170ms`，而 TiDB 部分的算子耗时，减去这 `170ms` 后，耗时占比非常小，说明瓶颈在 TiKV。
 
 ```sql
 +----------------------------+---------+---------+-----------+---------------+------------------------------------------------------------------------------+---------------------------------+-----------+------+
@@ -236,7 +236,7 @@ mysql> explain select * from t t1, t t2 where t1.a>t2.a;
 
 下面是一组例子，假设表结构为 `create table t (id int, a int, b int, c int, primary key(id), key(a), key(b, c))`：
 
-1. `select * from t`: 没有过滤条件，会扫全表，所以会用 `TableFullScan` 算子读取数据；
+1. `select * from t`：没有过滤条件，会扫全表，所以会用 `TableFullScan` 算子读取数据；
 2. `select a from t where a=2`：有过滤条件且只读索引列，所以会用 `IndexReader` 算子读取数据；
 3. `select * from t where a=2`：在 `a` 有过滤条件，但索引 `a` 不能完全覆盖需要读取的内容，因此会采用 `IndexLookup`；
 4. `select b from t where c=3`：多列索引没有前缀条件就用不上，所以会用 `IndexFullScan`；

diff --git a/backup-and-restore-use-cases-for-maintain.md b/backup-and-restore-use-cases-for-maintain.md
@@ -191,7 +191,7 @@ BR 会在备份结束时输出备份总结到控制台。
 
 ### 性能调优
 
-如果 TiKV 的资源使用没有出现明显的瓶颈（例如[备份过程中的运行指标](#备份过程中的运行指标)中的 **Backup CPU Utilization** 最高为 `1500%` 左右，**IO Utilization** 普遍低于 `30%`），可以尝试调大 `--concurrency`（默认是 4）参数以进行性能调优。该方法不适用于存在许多小表的场景。
+如果 TiKV 的资源使用没有出现明显的瓶颈（例如[备份过程中的运行指标](#备份过程中的运行指标)中的 **Backup CPU Utilization** 最高为 `1500%` 左右，**IO Utilization** 普遍低于 `30%`），可以尝试调大 `--concurrency`（默认是 4）参数以进行性能调优。
 
 示例如下：
 

diff --git a/basic-features.md b/basic-features.md
@@ -163,26 +163,27 @@ aliases: ['/docs-cn/dev/basic-features/']
 
 ## 管理，可视化和工具
 
-| 管理，可视化和工具                                                          |   6.3    |   6.2    |   6.1    |   6.0    |   5.4    |   5.3    |   5.2    |   5.1    |   5.0    | 4.0      |
-|----------------------------------------------------------------------------| :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: |
-| [TiDB Dashboard 图形化展示](/dashboard/dashboard-intro.md)                  |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| [TiDB Dashboard 持续性能分析功能](/dashboard/continuous-profiling.md)       |    Y    |    Y    |    Y     |    Y     | 实验特性 | 实验特性 |    N     |    N     |    N     | N        |
-| [TiDB Dashboard Top SQL 功能](/dashboard/top-sql.md)                       |    Y    |    Y     |    Y     |    Y     | 实验特性 |    N     |    N     |    N     |    N     | N        |
-| [TiDB Dashboard SQL 诊断功能](/information-schema/information-schema-sql-diagnostics.md)    | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
-| [Information schema](/information-schema/information-schema.md)           |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| [Metrics schema](/metrics-schema.md)                                      |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| [Statements summary tables](/statement-summary-tables.md)                 |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| [慢查询日志](/identify-slow-queries.md)                                    |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| [TiUP 部署](/tiup/tiup-overview.md)                                      |    Y     |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| Ansible 部署                                                              |    N    |    N    |    N     |    N     |    N     |    N     |    N     |    N     |    N     | 已废弃   |
-| [Kubernetes operator](https://docs.pingcap.com/tidb-in-kubernetes/stable) |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| [内置物理备份](/br/backup-and-restore-use-cases.md)                        |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
-| [Global Kill](/sql-statements/sql-statement-kill.md)                     | Y  | Y | Y | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
-| [Lock View](/information-schema/information-schema-data-lock-waits.md)    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | 实验特性 | 实验特性 | 实验特性 |
-| [`SHOW CONFIG`](/sql-statements/sql-statement-show-config.md)             | Y | Y| Y | Y | Y | Y | Y | Y | Y | Y |
-| [`SET CONFIG`](/dynamic-config.md)                                        | Y | Y | Y | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
-| [DM WebUI](/dm/dm-webui-guide.md)                                         | 实验特性 | 实验特性 | 实验特性 | 实验特性 |    N     |    N     |    N     |    N     |    N     | N        |
-| [前台限流](/tikv-configuration-file.md#前台限流)                            | Y | Y | 实验特性 | 实验特性 |    N     |    N     |    N     |    N     |    N     | N        |
+| 管理，可视化和工具                                                          |   6.4    |   6.3    |   6.2    |   6.1    |   6.0    |   5.4    |   5.3    |   5.2    |   5.1    |   5.0    | 4.0      |
+|----------------------------------------------------------------------------| :------:| :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: | :------: |
+| [TiDB Dashboard 图形化展示](/dashboard/dashboard-intro.md)                  |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| [TiDB Dashboard 持续性能分析功能](/dashboard/continuous-profiling.md)       |    Y    |    Y    |    Y    |    Y     |    Y     | 实验特性 | 实验特性 |    N     |    N     |    N     | N        |
+| [TiDB Dashboard Top SQL 功能](/dashboard/top-sql.md)                       |    Y    |    Y    |    Y     |    Y     |    Y     | 实验特性 |    N     |    N     |    N     |    N     | N        |
+| [TiDB Dashboard SQL 诊断功能](/information-schema/information-schema-sql-diagnostics.md)    |    Y    | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
+| [TiDB Dashboard 集群诊断功能](/dashboard/dashboard-diagnostics-access.md)   |    Y    | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
+| [Information schema](/information-schema/information-schema.md)           |    Y    |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| [Metrics schema](/metrics-schema.md)                                      |    Y    |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| [Statements summary tables](/statement-summary-tables.md)                 |    Y    |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| [慢查询日志](/identify-slow-queries.md)                                    |    Y    |    Y    |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| [TiUP 部署](/tiup/tiup-overview.md)                                      |    Y    |    Y     |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| Ansible 部署                                                              |    N    |    N    |    N    |    N     |    N     |    N     |    N     |    N     |    N     |    N     | 已废弃   |
+| [Kubernetes operator](https://docs.pingcap.com/tidb-in-kubernetes/stable) |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| [内置物理备份](/br/backup-and-restore-use-cases.md)                        |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | Y        |
+| [Global Kill](/sql-statements/sql-statement-kill.md)                     | Y  | Y  | Y | Y | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
+| [Lock View](/information-schema/information-schema-data-lock-waits.md)    | Y  |    Y    |    Y     |    Y     |    Y     |    Y     |    Y     |    Y     | 实验特性 | 实验特性 | 实验特性 |
+| [`SHOW CONFIG`](/sql-statements/sql-statement-show-config.md)             | Y  | Y | Y| Y | Y | Y | Y | Y | Y | Y | Y |
+| [`SET CONFIG`](/dynamic-config.md)                                        | Y  | Y | Y | Y | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
+| [DM WebUI](/dm/dm-webui-guide.md)                                         | 实验特  | 实验特性 | 实验特性 | 实验特性 | 实验特性 |    N     |    N     |    N     |    N     |    N     | N        |
+| [前台限流](/tikv-configuration-file.md#前台限流)                            | Y | Y | Y | 实验特性 | 实验特性 |    N     |    N     |    N     |    N     |    N     | N        |
 
 [^1]: TiDB 误将 latin1 处理为 utf8 的子集。见 [TiDB #18955](https://github.com/pingcap/tidb/issues/18955)。