Merge remote-tracking branch 'upstream/master' into update-descriptio…

…n-for-analyze-version

.github/pull_request_template.md

@@ -19,6 +19,7 @@ By default, **CHOOSE MASTER ONLY** so your changes will be applied to the next T
 For details, see [tips for choosing the affected versions (in Chinese)](https://github.com/pingcap/docs-cn/blob/master/CONTRIBUTING.md#版本选择指南).
 
 - [ ] master (the latest development version)
+- [ ] v6.0 (TiDB 6.0 versions)
 - [ ] v5.4 (TiDB 5.4 versions)
 - [ ] v5.3 (TiDB 5.3 versions)
 - [ ] v5.2 (TiDB 5.2 versions)

TOC.md

@@ -56,10 +56,10 @@
 - 运维操作
   - 升级 TiDB 版本
     - [使用 TiUP 升级（推荐）](/upgrade-tidb-using-tiup.md)
-    - [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/upgrade-a-tidb-cluster)
+    - [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/upgrade-a-tidb-cluster)
   - 扩缩容
     - [使用 TiUP（推荐）](/scale-tidb-using-tiup.md)
-    - [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/scale-a-tidb-cluster)
+    - [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/scale-a-tidb-cluster)
   - 备份与恢复
     - 使用 BR 工具（推荐）
       - [BR 工具简介](/br/backup-and-restore-tool.md)
@@ -196,7 +196,7 @@
     - [概述](/tidb-lightning/tidb-lightning-overview.md)
     - 前置需求
       - [前置检查](/tidb-lightning/tidb-lightning-prechecks.md)
-      - [权限要求](/tidb-lightning/tidb-lightning-requirements.md#下游数据库权限要求)
+      - [权限要求](/tidb-lightning/tidb-lightning-requirements.md)
       - [空间估算](/tidb-lightning/tidb-lightning-requirements.md#下游数据库所需空间)
     - 主要功能
       - [断点续传](/tidb-lightning/tidb-lightning-checkpoints.md)
@@ -213,83 +213,82 @@
     - [FAQ](/tidb-lightning/tidb-lightning-faq.md)
     - [术语表](/tidb-lightning/tidb-lightning-glossary.md)
   - TiDB Data Migration
-    - 关于 TiDB Data Migration
-      - [TiDB Data Migration 简介](/dm/dm-overview.md)
-      - 基本功能
+    - [关于 Data Migration](/dm/dm-overview.md)
+    - [快速开始](/dm/quick-start-with-dm.md)
+    - 部署 DM 集群
+      - [软硬件要求](/dm/dm-hardware-and-software-requirements.md)
+      - [使用 TiUP 联网部署（推荐）](/dm/deploy-a-dm-cluster-using-tiup.md)
+      - [使用 TiUP 离线部署](/dm/deploy-a-dm-cluster-using-tiup-offline.md)
+      - [使用 Binary 部署](/dm/deploy-a-dm-cluster-using-binary.md)
+      - [在 Kubernetes 环境中部署](https://docs.pingcap.com/zh/tidb-in-kubernetes/dev/deploy-tidb-dm)
+    - 入门指南
+        - [数据源操作](/dm/dm-manage-source.md)
+        - [任务配置向导](/dm/dm-task-configuration-guide.md)
         - [Table routing](/dm/dm-key-features.md#table-routing)
         - [Block & Allow Lists](/dm/dm-key-features.md#block--allow-table-lists)
-        - [Binlog Event Filter](/dm/dm-key-features.md#binlog-event-filter)
-      - 高级功能
-        - 分库分表合并迁移
-          - [概述](/dm/feature-shard-merge.md)
-          - [悲观模式](/dm/feature-shard-merge-pessimistic.md)
-          - [乐观模式](/dm/feature-shard-merge-optimistic.md)
-        - [迁移使用 GH-ost/PT-osc 的源数据库](/dm/feature-online-ddl.md)
+        - [过滤 binlog 事件](/dm/dm-key-features.md#binlog-event-filter)
         - [通过 SQL 表达式过滤 DML](/dm/feature-expression-filter.md)
-      - [DM 架构](/dm/dm-arch.md)
-      - [性能数据](/dm/dm-benchmark-v5.4.0.md)
-    - 快速上手
-      - [快速上手试用](/dm/quick-start-with-dm.md)
-      - [使用 TiUP 部署 DM 集群](/dm/deploy-a-dm-cluster-using-tiup.md)
-      - [创建数据源](/dm/quick-start-create-source.md)
-    - [使用场景](/dm/quick-create-migration-task.md)
-    - 部署使用
-      - [软硬件要求](/dm/dm-hardware-and-software-requirements.md)
-      - 部署 DM 集群
-        - [使用 TiUP（推荐）](/dm/deploy-a-dm-cluster-using-tiup.md)
-        - [使用 TiUP 离线镜像](/dm/deploy-a-dm-cluster-using-tiup-offline.md)
-        - [使用 Binary](/dm/deploy-a-dm-cluster-using-binary.md)
-        - [使用 Kubernetes](https://docs.pingcap.com/zh/tidb-in-kubernetes/dev/deploy-tidb-dm)
-      - [使用 DM 迁移数据](/dm/migrate-data-using-dm.md)
-      - [测试 DM 性能](/dm/dm-performance-test.md)
-    - 运维操作
-      - 集群运维工具
+        - 迁移任务操作
+            - [任务前置检查](/dm/dm-precheck.md)
+            - [创建任务](/dm/dm-create-task.md)
+            - [查询状态](/dm/dm-query-status.md)
+            - [暂停任务](/dm/dm-pause-task.md)
+            - [恢复任务](/dm/dm-resume-task.md)
+            - [停止任务](/dm/dm-stop-task.md)
+    - 进阶教程
+      - 分库分表合并迁移
+        - [概述](/dm/feature-shard-merge.md)
+        - [悲观模式](/dm/feature-shard-merge-pessimistic.md)
+        - [乐观模式](/dm/feature-shard-merge-optimistic.md)
+        - [手动处理 Sharding DDL Lock](/dm/manually-handling-sharding-ddl-locks.md)
+      - [迁移使用 GH-ost/PT-osc 的数据源](/dm/feature-online-ddl.md)
+      - [上下游列数量不一致的迁移](/migrate-with-more-columns-downstream.md)
+    - 运维管理
+      - 集群版本升级
         - [使用 TiUP 运维集群（推荐）](/dm/maintain-dm-using-tiup.md)
-        - [使用 dmctl 运维集群](/dm/dmctl-introduction.md)
-        - [使用 OpenAPI 运维集群](/dm/dm-open-api.md)
-      - 升级版本
         - [1.0.x 到 2.0+ 手动升级](/dm/manually-upgrade-dm-1.0-to-2.0.md)
-      - [管理数据源](/dm/dm-manage-source.md)
-      - 管理迁移任务
-        - [任务配置向导](/dm/dm-task-configuration-guide.md)
-        - [任务前置检查](/dm/dm-precheck.md)
-        - [创建任务](/dm/dm-create-task.md)
-        - [查询状态](/dm/dm-query-status.md)
-        - [暂停任务](/dm/dm-pause-task.md)
-        - [恢复任务](/dm/dm-resume-task.md)
-        - [停止任务](/dm/dm-stop-task.md)
-        - [导出和导入集群的数据源和任务配置](/dm/dm-export-import-config.md)
+      - 集群运维工具
+        - [使用 dmctl 管理迁移任务](/dm/dmctl-introduction.md)
+      - 性能调优
+        - [性能数据](/dm/dm-benchmark-v5.4.0.md)
+        - [配置调优](/dm/dm-tune-configuration.md)
+        - [如何进行压力测试](/dm/dm-performance-test.md)
+        - [性能问题及处理方法](/dm/dm-handle-performance-issues.md)
+      - 数据源管理
+        - [变更同步的数据源地址](/dm/usage-scenario-master-slave-switch.md)
+      - 任务管理
         - [处理出错的 DDL 语句](/dm/handle-failed-ddl-statements.md)
-      - [手动处理 Sharding DDL Lock](/dm/manually-handling-sharding-ddl-locks.md)
-      - [变更同步的 MySQL 实例](/dm/usage-scenario-master-slave-switch.md)
-      - [管理迁移表的表结构](/dm/dm-manage-schema.md)
+        - [管理迁移表的表结构](/dm/dm-manage-schema.md)
+      - [导出和导入集群的数据源和任务配置](/dm/dm-export-import-config.md)
       - [处理告警](/dm/dm-handle-alerts.md)
       - [日常巡检](/dm/dm-daily-check.md)
-    - 故障处理
-      - [故障及处理方法](/dm/dm-error-handling.md)
-      - [性能问题及处理方法](/dm/dm-handle-performance-issues.md)
-    - 性能调优
-      - [配置调优](/dm/dm-tune-configuration.md)
-    - 参考指南
-      - 架构
-        - [DM 架构简介](/dm/dm-arch.md)
-        - [DM-worker 简介](/dm/dm-worker-intro.md)
-      - [DM 命令行参数](/dm/dm-command-line-flags.md)
-      - 配置
-        - [概述](/dm/dm-config-overview.md)
-        - [DM-master 配置](/dm/dm-master-configuration-file.md)
-        - [DM-worker 配置](/dm/dm-worker-configuration-file.md)
-        - [上游数据库配置](/dm/dm-source-configuration-file.md)
-        - [数据迁移任务配置向导](/dm/dm-task-configuration-guide.md)
-      - 安全
-        - [为 DM 的连接开启加密传输](/dm/dm-enable-tls.md)
-        - [生成自签名证书](/dm/dm-generate-self-signed-certificates.md)
-      - [监控指标](/dm/monitor-a-dm-cluster.md)
-      - [告警信息](/dm/dm-alert-rules.md)
-      - [错误码](/dm/dm-error-handling.md#常见故障处理方法)
-    - [常见问题](/dm/dm-faq.md)
-    - [术语表](/dm/dm-glossary.md)
-    - [版本发布历史](/dm/dm-release-notes.md)
+     - 参考手册
+        - 架构
+          - [DM 架构简介](/dm/dm-arch.md)
+          - [DM-worker 说明](/dm/dm-worker-intro.md)
+        - 命令行
+          - [DM-master & DM-worker](/dm/dm-command-line-flags.md)
+        - 配置文件
+          - [概述](/dm/dm-config-overview.md)
+          - [数据源配置](/dm/dm-source-configuration-file.md)
+          - [迁移任务配置](/dm/task-configuration-file-full.md)
+          - [DM-master 配置](/dm/dm-master-configuration-file.md)
+          - [DM-worker 配置](/dm/dm-worker-configuration-file.md)
+        - [OpenAPI](/dm/dm-open-api.md)
+        - 安全
+          - [为 DM 的连接开启加密传输](/dm/dm-enable-tls.md)
+          - [生成自签名证书](/dm/dm-generate-self-signed-certificates.md)
+        - 监控告警 
+          - [监控指标](/dm/monitor-a-dm-cluster.md)
+          - [告警信息](/dm/dm-alert-rules.md)
+        - [错误码](/dm/dm-error-handling.md#常见故障处理方法)
+        - [术语表](/dm/dm-glossary.md)
+      - 使用示例
+        - [使用 DM 迁移数据](/dm/migrate-data-using-dm.md)
+      - 异常解决
+        - [常见问题](/dm/dm-faq.md)
+        - [错误处理及恢复](/dm/dm-error-handling.md)
+      - [版本发布历史](/dm/dm-release-notes.md)
   - Backup & Restore (BR)
     - [BR 工具简介](/br/backup-and-restore-tool.md)
     - [使用 BR 命令行备份恢复](/br/use-br-command-line-tool.md)
@@ -685,6 +684,7 @@
     - [5.2.1](/releases/release-5.2.1.md)
     - [5.2.0](/releases/release-5.2.0.md)
   - v5.1
+    - [5.1.4](/releases/release-5.1.4.md)
     - [5.1.3](/releases/release-5.1.3.md)
     - [5.1.2](/releases/release-5.1.2.md)
     - [5.1.1](/releases/release-5.1.1.md)

basic-features.md

@@ -76,7 +76,7 @@ aliases: ['/docs-cn/dev/basic-features/']
 | [通过系统变量 tidb_snapshot 读取历史数据](/read-historical-data.md)                                         | Y           | Y            | Y            | Y            | Y            | Y            |
 | [Optimizer hints](/optimizer-hints.md)                                                                   | Y           | Y            | Y            | Y            | Y            | Y            |
 | [MPP 执行引擎](/explain-mpp.md)                                                                   | Y           | Y            | Y            | Y            | Y            | N            |
-| [Index Merge Join](/explain-index-merge.md)                                                              | Y | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
+| [索引合并](/explain-index-merge.md)                                                              | Y | 实验特性 | 实验特性 | 实验特性 | 实验特性 | 实验特性 |
 | [Placement Rules in SQL](/placement-rules-in-sql.md) | 实验特性 | 实验特性 | N | N | N | N |
 
 ## 数据定义语言 (DDL)

best-practices/java-app-best-practices.md

@@ -58,8 +58,8 @@ Java 应用尽管可以选择在不同的框架中封装，但在最底层一般
 - 设置 [`FetchSize` 为 `Integer.MIN_VALUE`](https://dev.mysql.com/doc/connector-j/5.1/en/connector-j-reference-implementation-notes.html#ResultSet) 让客户端不缓存，客户端通过 StreamingResult 的方式从网络连接上流式读取执行结果。
 
     使用流式读取数据时，需要将 `resultset` 读取完成或 close 后，才能继续使用该语句进行下次查询，否则会报错 `No statements may be issued when any streaming result sets are open and in use on a given connection. Ensure that you have called .close() on any active streaming result sets before attempting more queries.`。
-    
-    如果需要在 `resultset` 读取完成或 close 前进行查询避免上述报错，可在 URL 中添加配置参数 `clobberStreamingResults=true`，这样会自动 close `resultset`，但之前流式查询未被读取的结果集会丢失。 
+
+    如果需要在 `resultset` 读取完成或 close 前进行查询避免上述报错，可在 URL 中添加配置参数 `clobberStreamingResults=true`，这样会自动 close `resultset`，但之前流式查询未被读取的结果集会丢失。
 
 - 使用 Cursor Fetch，首先需[设置 `FetchSize`](http://makejavafaster.blogspot.com/2015/06/jdbc-fetch-size-performance.html) 为正整数，且在 JDBC URL 中配置 `useCursorFetch = true`。
 
@@ -197,7 +197,7 @@ TiDB 提供两个与 MySQL 兼容的超时控制参数，`wait_timeout` 和 `max
 
 TiDB (MySQL) 连接建立是比较昂贵的操作（至少对于 OLTP），除了建立 TCP 连接外还需要进行连接鉴权操作，所以客户端通常会把 TiDB (MySQL) 连接保存到连接池中进行复用。
 
-Java 的连接池实现很多 ([HikariCP](https://github.com/brettwooldridge/HikariCP), [tomcat-jdbc](https://tomcat.apache.org/tomcat-7.0-doc/jdbc-pool.html), [durid](https://github.com/alibaba/druid), [c3p0](https://www.mchange.com/projects/c3p0/), [dbcp](https://commons.apache.org/proper/commons-dbcp/))，TiDB 不会限定使用的连接池，应用可以根据业务特点自行选择连接池实现。
+Java 的连接池实现很多 ([HikariCP](https://github.com/brettwooldridge/HikariCP), [tomcat-jdbc](https://tomcat.apache.org/tomcat-7.0-doc/jdbc-pool.html), [druid](https://github.com/alibaba/druid), [c3p0](https://www.mchange.com/projects/c3p0/), [dbcp](https://commons.apache.org/proper/commons-dbcp/))，TiDB 不会限定使用的连接池，应用可以根据业务特点自行选择连接池实现。
 
 ### 连接数配置
 

br/use-br-command-line-tool.md

@@ -440,12 +440,12 @@ br restore full -f 'mysql.usertable' -s $external_storage_url --ratelimit 128
 
 > **警告：**
 >
-> 虽然系统表（例如 `mysql.tidb` 等）可以通过 BR 进行备份和恢复，但是部分系统表在恢复之后可能会出现非预期的状况，已知的异常如下：
+> 系统表（例如 `mysql.tidb`）可以通过 BR 进行备份。但恢复系统表存在限制。即便是使用了 `-filter` 设置，也不能通过 BR 恢复以下系统表：
 >
-> - 统计信息表（`mysql.stat_*`）无法被恢复。
-> - 系统变量表（`mysql.tidb`，`mysql.global_variables`）无法被恢复。
-> - 用户信息表（`mysql.user`，`mysql.columns_priv`，等等）无法被恢复。
-> - GC 数据无法被恢复。
+> - 统计信息表（`mysql.stat_*`）
+> - 系统变量表（`mysql.tidb`，`mysql.global_variables`）
+> - 用户信息表（`mysql.user`，`mysql.columns_priv`，等等）
+> - [其他系统表](https://github.com/pingcap/tidb/blob/v5.4.0/br/pkg/restore/systable_restore.go#L31)
 > 
 > 恢复系统表可能还存在更多兼容性问题。为了防止意外发生，请避免在生产环境中恢复系统表。