diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 77a591babaa8..ffd61d84a4fc 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -25,7 +25,7 @@ ### 翻译中文文档 -TiDB 中文文档的日常更新特别活跃，相应地，[TiDB 英文文档](https://pingcap.com/docs/stable/) 也需要进行频繁的更新。这一过程会涉及很多的**中译英**，即将 [pingcap/docs-cn](https://github.com/pingcap/docs) 里已 [merge](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request) 但尚未进行翻译处理的 Pull Request 翻译为英文，并提交 Pull Request 至 [pingcap/docs](https://github.com/pingcap/docs) 中。**具体的认领方式**如下。 +TiDB 中文文档的日常更新特别活跃，相应地，[TiDB 英文文档](https://docs.pingcap.com/tidb/v4.0) 也需要进行频繁的更新。这一过程会涉及很多的**中译英**，即将 [pingcap/docs-cn](https://github.com/pingcap/docs) 里已 [merge](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/merging-a-pull-request) 但尚未进行翻译处理的 Pull Request 翻译为英文，并提交 Pull Request 至 [pingcap/docs](https://github.com/pingcap/docs) 中。**具体的认领方式**如下。 > **注意：** > diff --git a/README.md b/README.md index 367a98bcc8ba..6342061f0c82 100755 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ 欢迎来到 [TiDB](https://github.com/pingcap/tidb) 文档仓库！ -这里存放的是 [PingCAP 官网 TiDB 中文文档](https://pingcap.com/docs-cn/stable/)的源文件。[官网英文文档](https://pingcap.com/docs/stable/)的源文件则存放于 [pingcap/docs](https://github.com/pingcap/docs)。 +这里存放的是 [PingCAP 官网 TiDB 中文文档](https://docs.pingcap.com/zh/tidb/v4.0)的源文件。[官网英文文档](https://docs.pingcap.com/tidb/v4.0)的源文件则存放于 [pingcap/docs](https://github.com/pingcap/docs)。 如果你发现或遇到了 TiDB 的文档问题，可随时[提 Issue](https://github.com/pingcap/docs-cn/issues/new/choose) 来反馈，或者直接[提交 Pull Request](/CONTRIBUTING.md#pull-request-提交流程) 来进行修改。 diff --git a/TOC.md b/TOC.md index 1b79f2df1f7f..223ef61f5f5d 100644 --- a/TOC.md +++ b/TOC.md @@ -55,12 +55,12 @@ + 升级 TiDB 版本 + [使用 TiUP 升级（推荐）](/upgrade-tidb-using-tiup.md) + [使用 TiUP 离线升级（推荐）](/upgrade-tidb-using-tiup-offline.md) - + [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/upgrade-a-tidb-cluster) + + [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/upgrade-a-tidb-cluster) + [使用 TiDB Ansible](/upgrade-tidb-using-ansible.md) + 扩缩容 + [使用 TiUP（推荐）](/scale-tidb-using-tiup.md) + [使用 TiDB Ansible](/scale-tidb-using-ansible.md) - + [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable/scale-a-tidb-cluster) + + [使用 TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/scale-a-tidb-cluster) + 备份与恢复 + [使用 Mydumper 和 TiDB Lightning 进行备份与恢复](/backup-and-restore-using-mydumper-lightning.md) + [使用 Dumpling 导出或备份 TiDB 数据](/export-or-backup-using-dumpling.md) diff --git a/_index.md b/_index.md index 4a78ca397ea3..95b2ea84b444 100755 --- a/_index.md +++ b/_index.md @@ -37,7 +37,7 @@ TiDB 是 PingCAP 公司自主设计、研发的开源分布式关系型数据库 - [环境与系统配置检查](/check-before-deployment.md) - [使用 TiUP 部署（推荐）](/production-deployment-using-tiup.md) - [使用 TiFlash](/tiflash/use-tiflash.md) -- [在 Kubernetes 上部署](https://docs.pingcap.com/zh/tidb-in-kubernetes/stable) +- [在 Kubernetes 上部署](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1) diff --git a/architecture.md b/architecture.md index ecfee2f3ea93..36872f7b38f1 100644 --- a/architecture.md +++ b/architecture.md @@ -5,7 +5,7 @@ category: introduction # TiDB 整体架构 -要深入了解 TiDB 的水平扩展和高可用特点，首先需要了解 TiDB 的整体架构。TiDB 集群主要包括三个核心组件：TiDB Server，PD Server 和 TiKV Server。此外，还有用于解决用户复杂 OLAP 需求的 [TiSpark](https://github.com/pingcap/tispark/) 组件和简化云上部署管理的 [TiDB Operator](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/tidb-operator-overview/) 组件。 +要深入了解 TiDB 的水平扩展和高可用特点，首先需要了解 TiDB 的整体架构。TiDB 集群主要包括三个核心组件：TiDB Server，PD Server 和 TiKV Server。此外，还有用于解决用户复杂 OLAP 需求的 [TiSpark](https://github.com/pingcap/tispark/) 组件和简化云上部署管理的 [TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/tidb-operator-overview) 组件。 ![TiDB Architecture](/media/tidb-architecture.png) diff --git a/dashboard/dashboard-ops-deploy.md b/dashboard/dashboard-ops-deploy.md index 10238254195d..00b6cfb19ae2 100644 --- a/dashboard/dashboard-ops-deploy.md +++ b/dashboard/dashboard-ops-deploy.md @@ -11,7 +11,7 @@ TiDB Dashboard 界面内置于 TiDB 4.0 或更高版本的 PD 组件中，无需 + [快速试用 TiDB 集群](/quick-start-with-tidb.md#第二种使用-tiup-playground-快速部署本地测试环境) + [生产环境部署](/production-deployment-using-tiup.md) -+ [Kubernetes 环境部署](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/access-dashboard/) ++ [Kubernetes 环境部署](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/access-dashboard/) > **注意：** > diff --git a/download-ecosystem-tools.md b/download-ecosystem-tools.md index 959e48ed28ac..ca826f691128 100644 --- a/download-ecosystem-tools.md +++ b/download-ecosystem-tools.md @@ -49,7 +49,7 @@ aliases: ['/docs-cn/stable/reference/tools/download/'] ## TiDB DM (Data Migration) -使用下表中的链接下载 [DM](https://pingcap.com/docs-cn/tidb-data-migration/stable/overview/)： +使用下表中的链接下载 [DM](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/overview)： | 安装包 | 操作系统 | 架构 | SHA256 校验和 | |:---|:---|:---|:---| diff --git a/ecosystem-tool-user-case.md b/ecosystem-tool-user-case.md index 02da680343fc..2e2a1ed4d0c8 100644 --- a/ecosystem-tool-user-case.md +++ b/ecosystem-tool-user-case.md @@ -18,7 +18,7 @@ summary: 本文档介绍 TiDB 生态工具的常见适用场景与工具选择 ## 从 MySQL/Aurora 迁移数据 -当既需要从 MySQL/Aurora 导入全量数据，又需要迁移增量数据时，可使用 [TiDB Data Migration (DM)](https://pingcap.com/docs-cn/tidb-data-migration/stable/overview/) 完成全量数据和增量数据的迁移。 +当既需要从 MySQL/Aurora 导入全量数据，又需要迁移增量数据时，可使用 [TiDB Data Migration (DM)](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/overview) 完成全量数据和增量数据的迁移。 如果全量数据量较大（TB 级别），则可先使用 [Dumpling](/export-or-backup-using-dumpling.md) 与 [TiDB Lightning](/tidb-lightning/tidb-lightning-overview.md) 完成全量数据的迁移，再使用 DM 完成增量数据的迁移。 diff --git a/ecosystem-tool-user-guide.md b/ecosystem-tool-user-guide.md index f7a04f1d5f1f..f55fef65c55b 100644 --- a/ecosystem-tool-user-guide.md +++ b/ecosystem-tool-user-guide.md @@ -34,7 +34,7 @@ aliases: ['/docs-cn/stable/reference/tools/user-guide/'] - Dumpling 输出文件 - 其他格式兼容的 CSV 文件 - 适用 TiDB 版本：v2.1 及以上 -- Kubernetes 支持：[使用 TiDB Lightning 快速恢复 Kubernetes 上的 TiDB 集群数据](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/restore-data-using-tidb-lightning/) +- Kubernetes 支持：[使用 TiDB Lightning 快速恢复 Kubernetes 上的 TiDB 集群数据](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/restore-data-using-tidb-lightning) > **注意：** > @@ -48,7 +48,7 @@ aliases: ['/docs-cn/stable/reference/tools/user-guide/'] - [备份输出和恢复输入的文件类型](/br/backup-and-restore-tool.md#备份文件类型)：SST + `backupmeta` 文件 - 适用 TiDB 版本：v3.1 及 v4.0 -- Kubernetes 支持：[使用 BR 工具备份 TiDB 集群数据到兼容 S3 的存储](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/backup-to-aws-s3-using-br/), [使用 BR 工具恢复 S3 兼容存储上的备份数据](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/restore-from-aws-s3-using-br/) +- Kubernetes 支持：[使用 BR 工具备份 TiDB 集群数据到兼容 S3 的存储](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/backup-to-aws-s3-using-br), [使用 BR 工具恢复 S3 兼容存储上的备份数据](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/restore-from-aws-s3-using-br) ## TiDB 增量日志同步 @@ -59,11 +59,11 @@ aliases: ['/docs-cn/stable/reference/tools/user-guide/'] - TiDB Binlog 的输入：TiDB 集群 - TiDB Binlog 的输出：TiDB 集群、MySQL、Kafka 或者增量备份文件 - 适用 TiDB 版本：v2.1 及以上 -- Kubernetes 支持：[TiDB Binlog 运维文档](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/deploy-tidb-binlog/)，[Kubernetes 上的 TiDB Binlog Drainer 配置](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/configure-tidb-binlog-drainer/) +- Kubernetes 支持：[TiDB Binlog 运维文档](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/deploy-tidb-binlog)，[Kubernetes 上的 TiDB Binlog Drainer 配置](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/configure-tidb-binlog-drainer) ## 数据迁入 -[TiDB Data Migration (DM)](https://pingcap.com/docs-cn/tidb-data-migration/stable/overview/) 是将 MySQL/MariaDB 数据迁移到 TiDB 的工具，支持全量数据和增量数据的迁移。 +[TiDB Data Migration (DM)](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/overview) 是将 MySQL/MariaDB 数据迁移到 TiDB 的工具，支持全量数据和增量数据的迁移。 基本信息： diff --git a/faq/tidb-faq.md b/faq/tidb-faq.md index d378c671841b..1d18345ca2d2 100644 --- a/faq/tidb-faq.md +++ b/faq/tidb-faq.md @@ -92,11 +92,11 @@ MySQL 是单机数据库，只能通过 XA 来满足跨数据库事务，而 TiD ### 2.1 公有云 -#### 2.1.1 目前 Cloud TiDB 都支持哪些云厂商？ +#### 2.1.1 目前 TiDB Cloud 都支持哪些云厂商？ -Cloud TiDB 目前已经在京东云、UCloud 上线，都是数据库一级入口，欢迎大家使用。 +TiDB Cloud 目前已经在京东云、UCloud 上线，都是数据库一级入口，欢迎大家使用。 -另外，Cloud TiDB 还支持在 [Google GKE](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/deploy-on-gcp-gke/)，[AWS EKS](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/deploy-on-aws-eks/) 和 [阿里云 ACK](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/deploy-on-alibaba-cloud/) 上部署使用。 +另外，TiDB Cloud 还支持在 [Google GKE](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/deploy-on-gcp-gke)，[AWS EKS](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/deploy-on-aws-eks) 和 [阿里云 ACK](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/deploy-on-alibaba-cloud) 上部署使用。 ## 三、故障排除 diff --git a/migrate-from-aurora-mysql-database.md b/migrate-from-aurora-mysql-database.md index 36fa404e0012..4f327c2611a1 100644 --- a/migrate-from-aurora-mysql-database.md +++ b/migrate-from-aurora-mysql-database.md @@ -19,7 +19,7 @@ aliases: ['/docs-cn/stable/how-to/migrate/from-mysql-aurora/'] | Aurora-1 | pingcap-1-us-east-2a.h8emfqdptyc4.us-east-2.rds.amazonaws.com | 3306 | 读取器 | | Aurora-2 | pingcap-2.h8emfqdptyc4.us-east-2.rds.amazonaws.com | 3306 | 写入器 | -DM 在增量同步阶段依赖 `ROW` 格式的 binlog，如果未启用 binlog 及设置正确的 binlog 格式，则不能正常使用 DM 进行数据同步，具体可参见[检查内容](https://pingcap.com/docs-cn/tidb-data-migration/stable/precheck/#检查内容)。 +DM 在增量同步阶段依赖 `ROW` 格式的 binlog，如果未启用 binlog 及设置正确的 binlog 格式，则不能正常使用 DM 进行数据同步，具体可参见[检查内容](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/precheck#检查内容)。 > **注意：** > @@ -43,11 +43,11 @@ DM 在增量同步阶段依赖 `ROW` 格式的 binlog，如果未启用 binlog ## 第 2 步：部署 DM 集群 -目前推荐使用 DM-Ansible 部署 DM 集群，具体部署方法参照[使用 DM-Ansible 部署 DM 集群](https://pingcap.com/docs-cn/tidb-data-migration/stable/deploy-a-dm-cluster-using-ansible/)。 +目前推荐使用 DM-Ansible 部署 DM 集群，具体部署方法参照[使用 DM-Ansible 部署 DM 集群](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/deploy-a-dm-cluster-using-ansible)。 > **注意：** > -> - 在 DM 所有的配置文件中，数据库的密码要使用 dmctl 加密后的密文。如果数据库密码为空，则不需要加密。关于如何使用 dmctl 加密明文密码，参考[使用 dmctl 加密上游 MySQL 用户密码](https://pingcap.com/docs-cn/tidb-data-migration/stable/deploy-a-dm-cluster-using-ansible/#使用-dmctl-加密上游-mysql-用户密码)。 +> - 在 DM 所有的配置文件中，数据库的密码要使用 dmctl 加密后的密文。如果数据库密码为空，则不需要加密。关于如何使用 dmctl 加密明文密码，参考[使用 dmctl 加密上游 MySQL 用户密码](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/deploy-a-dm-cluster-using-ansible#使用-dmctl-加密上游-mysql-用户密码)。 > - 上下游数据库用户必须拥有相应的读写权限。 ## 第 3 步：检查集群信息 diff --git a/overview.md b/overview.md index 8a69af543b9f..6dbcd47d4c33 100644 --- a/overview.md +++ b/overview.md @@ -24,7 +24,7 @@ TiDB 是 PingCAP 公司自主设计、研发的开源分布式关系型数据库 - 云原生的分布式数据库 - 专为云而设计的分布式数据库，通过 [TiDB Operator](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/tidb-operator-overview/) 可在公有云、私有云、混合云中实现部署工具化、自动化。 + 专为云而设计的分布式数据库，通过 [TiDB Operator](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1/tidb-operator-overview) 可在公有云、私有云、混合云中实现部署工具化、自动化。 - 兼容 MySQL 5.7 协议和 MySQL 生态 diff --git a/quick-start-with-tidb.md b/quick-start-with-tidb.md index 845f1cdb72f1..2507e9bc8b1f 100644 --- a/quick-start-with-tidb.md +++ b/quick-start-with-tidb.md @@ -306,4 +306,4 @@ TiDB-Wasm 是运行在浏览器中的 TiDB 数据库，打开网页即可使用 - 如果你准备好在生产环境部署 TiDB 了： - 在线部署：[使用 TiUP 部署 TiDB 集群](/production-deployment-using-tiup.md) - 离线部署：[使用 TiUP 离线部署 TiDB 集群](/production-offline-deployment-using-tiup.md) - - [使用 TiDB Operator 在云上部署 TiDB](https://pingcap.com/docs-cn/tidb-in-kubernetes/stable/) + - [使用 TiDB Operator 在云上部署 TiDB](https://docs.pingcap.com/zh/tidb-in-kubernetes/v1.1) diff --git a/syncer-overview.md b/syncer-overview.md index bf5271436a8a..73de57d0b8d9 100644 --- a/syncer-overview.md +++ b/syncer-overview.md @@ -8,7 +8,7 @@ aliases: ['/docs-cn/stable/reference/tools/syncer/'] > **警告：** > -> Syncer 目前已经不再维护，其功能已经完全被 [TiDB Data Migration](https://pingcap.com/docs-cn/tidb-data-migration/stable/overview/)取代，强烈建议切换到 TiDB DM。 +> Syncer 目前已经不再维护，其功能已经完全被 [TiDB Data Migration](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/overview)取代，强烈建议切换到 TiDB DM。 ## Syncer 简介 diff --git a/tidb-troubleshooting-map.md b/tidb-troubleshooting-map.md index 7140d825c24a..d5616dd41f62 100644 --- a/tidb-troubleshooting-map.md +++ b/tidb-troubleshooting-map.md @@ -416,7 +416,7 @@ aliases: ['/docs-cn/stable/how-to/troubleshoot/diagnose-map/'] - 在所有 DM 配置文件中，数据库相关的密码都必须使用经 dmctl 加密后的密文（若数据库密码为空，则无需加密）。 - - 在 DM 运行过程中，上下游数据库的用户必须具备相应的读写权限。在启动同步任务过程中，DM 会自动进行[相应权限的检查](https://pingcap.com/docs-cn/tidb-data-migration/stable/precheck/)。 + - 在 DM 运行过程中，上下游数据库的用户必须具备相应的读写权限。在启动同步任务过程中，DM 会自动进行[相应权限的检查](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/precheck)。 - 同一套 DM 集群，混合部署不同版本的 DM-worker/DM-master/dmctl，见案例 [AskTUG-1049](https://asktug.com/t/dm1-0-0-ga-access-denied-for-user/1049/5)。 @@ -440,9 +440,9 @@ aliases: ['/docs-cn/stable/how-to/troubleshoot/diagnose-map/'] - 在 DM 进行 relay log 拉取与增量同步过程中，如果遇到了上游超过 4 GB 的 binlog 文件，就可能出现这两个错误。原因是 DM 在写 relay log 时需要依据 binlog position 及文件大小对 event 进行验证，且需要保存同步的 binlog position 信息作为 checkpoint。但是 MySQL binlog position 官方定义使用 uint32 存储，所以超过 4 GB 部分的 binlog position 的 offset 值会溢出，进而出现上面的错误。 - - 对于 relay 处理单元， 可通过官网步骤进行[手动处理](https://pingcap.com/docs-cn/tidb-data-migration/stable/error-handling/)。 + - 对于 relay 处理单元，可通过官网步骤进行[手动处理](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/error-handling)。 - - 对于 binlog replication 处理单元，可通过官网步骤进行[手动处理](https://pingcap.com/docs-cn/tidb-data-migration/stable/error-handling/)。 + - 对于 binlog replication 处理单元，可通过官网步骤进行[手动处理](https://docs.pingcap.com/zh/tidb-data-migration/v1.0/error-handling)。 - 6.2.6 DM 同步中断，日志报错 `ERROR 1236 (HY000) The slave is connecting using CHANGE MASTER TO MASTER_AUTO_POSITION = 1, but the master has purged binary logs containing GTIDs that the slave requires.`。