diff --git a/develop/dev-guide-sample-application-java-hibernate.md b/develop/dev-guide-sample-application-java-hibernate.md index db0c7aef883fe..fe7f379fd7c2f 100644 --- a/develop/dev-guide-sample-application-java-hibernate.md +++ b/develop/dev-guide-sample-application-java-hibernate.md @@ -5,19 +5,19 @@ summary: 学习如何使用 Hibernate 连接 TiDB。本教程提供了可与 TiD # 使用 Hibernate 连接 TiDB -TiDB 是一个兼容 MySQL 的数据库，[Hibernate](https://hibernate.org/orm/) 是一个流行的开源 Java ORM。从 `6.0.0.Beta2` 版本开始，Hibernate 支持 TiDB 方言，能够很好地适配 TiDB 的特性。 +TiDB 是一个 MySQL 兼容的数据库，[Hibernate](https://hibernate.org/orm/) 是流行的开源 Java ORM。由于 TiDB 与 MySQL 高度兼容，推荐你将 `org.hibernate.dialect.MySQLDialect` 作为 Hibernate 的 dialect，以获得长期兼容性。或者，你也可以选择 [Hibernate community dialects](https://github.com/hibernate/hibernate-orm/tree/main/hibernate-community-dialects) 中的 TiDB 专用 dialect（`org.hibernate.community.dialect.TiDBDialect`），但该 dialect 并非由 PingCAP 维护。如果你在使用 `MySQLDialect` 时遇到任何兼容性问题，可以在 GitHub 上提交 [issue](https://github.com/pingcap/tidb/issues)。 在本教程中，你可以学习如何使用 TiDB 和 Hibernate 完成以下任务： - 搭建你的环境。 - 使用 Hibernate 连接到你的 TiDB 集群。 -- 构建并运行你的应用程序。你还可以在 [示例代码片段](#sample-code-snippets) 中找到基本 CRUD 操作的示例代码。 +- 构建并运行你的应用程序。你还可以在 [示例代码片段](#sample-code-snippets) 中找到基本 CRUD 操作的代码示例。 -> **Note:** +> **注意：** > -> 本教程适用于 {{{ .starter }}}, {{{ .essential }}}, TiDB Cloud Dedicated 和 TiDB 自建版。 +> 本教程适用于 TiDB Cloud Starter、TiDB Cloud Essential、TiDB Cloud Dedicated 以及自建 TiDB。 -## 前置条件 +## 前提条件 完成本教程，你需要： @@ -30,22 +30,22 @@ TiDB 是一个兼容 MySQL 的数据库，[Hibernate](https://hibernate.org/orm/ **如果你还没有 TiDB 集群，可以按如下方式创建：** -- （推荐）参考[创建 {{{ .starter }}} 集群](/develop/dev-guide-build-cluster-in-cloud.md) 创建你自己的 TiDB Cloud 集群。 -- 参考[部署本地测试 TiDB 集群](/quick-start-with-tidb.md#deploy-a-local-test-cluster) 或[部署生产环境 TiDB 集群](/production-deployment-using-tiup.md) 创建本地集群。 +- （推荐）参照 [创建 TiDB Cloud Starter 集群](/develop/dev-guide-build-cluster-in-cloud.md) 创建属于你自己的 TiDB Cloud 集群。 +- 参照 [部署本地测试 TiDB 集群](/quick-start-with-tidb.md#deploy-a-local-test-cluster) 或 [部署生产环境 TiDB 集群](/production-deployment-using-tiup.md) 创建本地集群。 **如果你还没有 TiDB 集群，可以按如下方式创建：** -- （推荐）参考[创建 {{{ .starter }}} 集群](/develop/dev-guide-build-cluster-in-cloud.md) 创建你自己的 TiDB Cloud 集群。 -- 参考[部署本地测试 TiDB 集群](https://docs.pingcap.com/tidb/stable/quick-start-with-tidb#deploy-a-local-test-cluster) 或[部署生产环境 TiDB 集群](https://docs.pingcap.com/tidb/stable/production-deployment-using-tiup) 创建本地集群。 +- （推荐）参照 [创建 TiDB Cloud Starter 集群](/develop/dev-guide-build-cluster-in-cloud.md) 创建属于你自己的 TiDB Cloud 集群。 +- 参照 [部署本地测试 TiDB 集群](https://docs.pingcap.com/tidb/stable/quick-start-with-tidb#deploy-a-local-test-cluster) 或 [部署生产环境 TiDB 集群](https://docs.pingcap.com/tidb/stable/production-deployment-using-tiup) 创建本地集群。 ## 运行示例应用连接 TiDB -本节演示如何运行示例应用代码并连接到 TiDB。 +本节演示如何运行示例应用代码并连接 TiDB。 ### 第 1 步：克隆示例应用仓库 @@ -61,28 +61,28 @@ cd tidb-java-hibernate-quickstart 根据你选择的 TiDB 部署方式，连接到你的 TiDB 集群。 -
+
-1. 进入 [**Clusters**](https://tidbcloud.com/console/clusters) 页面，然后点击目标集群名称进入其概览页面。 +1. 进入 [**Clusters**](https://tidbcloud.com/console/clusters) 页面，点击目标集群名称，进入其概览页面。 2. 点击右上角的 **Connect**，弹出连接对话框。 -3. 确保连接对话框中的配置与你的操作环境一致。 +3. 确保连接对话框中的配置与你的运行环境一致。 - **Connection Type** 设置为 `Public` - **Branch** 设置为 `main` - **Connect With** 设置为 `General` - - **Operating System** 与你的环境一致 + - **Operating System** 与你的环境匹配 - > **Tip:** + > **提示：** > > 如果你的程序运行在 Windows Subsystem for Linux (WSL) 中，请切换到对应的 Linux 发行版。 -4. 点击 **Generate Password** 生成一个随机密码。 +4. 点击 **Generate Password** 生成随机密码。 - > **Tip:** + > **提示：** > - > 如果你之前已经创建过密码，可以继续使用原密码，或者点击 **Reset Password** 生成新密码。 + > 如果你之前已创建过密码，可以继续使用原密码，或点击 **Reset Password** 生成新密码。 5. 运行以下命令，复制 `env.sh.example` 并重命名为 `env.sh`： @@ -101,24 +101,24 @@ cd tidb-java-hibernate-quickstart export USE_SSL='true' ``` - 请务必将 `{}` 占位符替换为连接对话框中获取的连接参数。 + 请务必将 `{}` 占位符替换为连接对话框中获得的连接参数。 - {{{ .starter }}} 需要安全连接，因此你需要将 `USE_SSL` 的值设置为 `true`。 + TiDB Cloud Starter 需要安全连接，因此你需要将 `USE_SSL` 的值设置为 `true`。 7. 保存 `env.sh` 文件。
-1. 进入 [**Clusters**](https://tidbcloud.com/console/clusters) 页面，然后点击目标集群名称进入其概览页面。 +1. 进入 [**Clusters**](https://tidbcloud.com/console/clusters) 页面，点击目标集群名称，进入其概览页面。 2. 点击右上角的 **Connect**，弹出连接对话框。 3. 在连接对话框中，从 **Connection Type** 下拉列表选择 **Public**，然后点击 **CA cert** 下载 CA 证书。 - 如果你还没有配置 IP 访问列表，请点击 **Configure IP Access List**，或参考 [Configure an IP Access List](https://docs.pingcap.com/tidbcloud/configure-ip-access-list) 进行配置后再首次连接。 + 如果你还未配置 IP 访问列表，请点击 **Configure IP Access List**，或参照 [配置 IP 访问列表](https://docs.pingcap.com/tidbcloud/configure-ip-access-list) 进行首次连接前的配置。 - 除了 **Public** 连接类型，TiDB Cloud Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。更多信息请参见 [Connect to Your TiDB Cloud Dedicated Cluster](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 + 除了 **Public** 连接类型，TiDB Cloud Dedicated 还支持 **Private Endpoint** 和 **VPC Peering** 连接类型。更多信息参见 [连接到你的 TiDB Cloud Dedicated 集群](https://docs.pingcap.com/tidbcloud/connect-to-tidb-cluster)。 4. 运行以下命令，复制 `env.sh.example` 并重命名为 `env.sh`： @@ -137,7 +137,7 @@ cd tidb-java-hibernate-quickstart export USE_SSL='false' ``` - 请务必将 `{}` 占位符替换为连接对话框中获取的连接参数。 + 请务必将 `{}` 占位符替换为连接对话框中获得的连接参数。 6. 保存 `env.sh` 文件。 @@ -176,13 +176,13 @@ cd tidb-java-hibernate-quickstart make ``` -2. 检查 [Expected-Output.txt](https://github.com/tidb-samples/tidb-java-hibernate-quickstart/blob/main/Expected-Output.txt) 以确认输出是否一致。 +2. 检查 [Expected-Output.txt](https://github.com/tidb-samples/tidb-java-hibernate-quickstart/blob/main/Expected-Output.txt) 文件，确认输出是否一致。 ## 示例代码片段 你可以参考以下示例代码片段，完成你自己的应用开发。 -完整示例代码及运行方法请参考 [tidb-samples/tidb-java-hibernate-quickstart](https://github.com/tidb-samples/tidb-java-hibernate-quickstart) 仓库。 +完整示例代码及运行方法请参见 [tidb-samples/tidb-java-hibernate-quickstart](https://github.com/tidb-samples/tidb-java-hibernate-quickstart) 仓库。 ### 连接 TiDB @@ -198,7 +198,7 @@ cd tidb-java-hibernate-quickstart com.mysql.cj.jdbc.Driver - org.hibernate.dialect.TiDBDialect + org.hibernate.dialect.MySQLDialect ${tidb_jdbc_url} ${tidb_user} ${tidb_password} @@ -225,7 +225,7 @@ public SessionFactory getSessionFactory() { } ``` -使用该函数时，需要将 `${your_entity_class}` 替换为你自己的数据实体类。如果有多个实体类，需要为每个实体类添加一条 `.addAnnotatedClass(${your_entity_class})` 语句。上述函数只是配置 Hibernate 的一种方式。如果你在配置过程中遇到问题，或想了解更多 Hibernate 相关内容，请参考 [Hibernate 官方文档](https://hibernate.org/orm/documentation)。 +使用该函数时，你需要将 `${your_entity_class}` 替换为你自己的数据实体类。若有多个实体类，需要为每个类添加一条 `.addAnnotatedClass(${your_entity_class})` 语句。上述函数只是配置 Hibernate 的一种方式。如果你在配置过程中遇到问题，或想了解更多 Hibernate 相关内容，请参考 [Hibernate 官方文档](https://hibernate.org/orm/documentation)。 ### 插入或更新数据 @@ -235,7 +235,7 @@ try (Session session = sessionFactory.openSession()) { } ``` -更多信息请参考 [插入数据](/develop/dev-guide-insert-data.md) 和 [更新数据](/develop/dev-guide-update-data.md)。 +更多信息参见 [插入数据](/develop/dev-guide-insert-data.md) 和 [修改数据](/develop/dev-guide-update-data.md)。 ### 查询数据 @@ -246,7 +246,7 @@ try (Session session = sessionFactory.openSession()) { } ``` -更多信息请参考 [查询数据](/develop/dev-guide-get-data-from-single-table.md)。 +更多信息参见 [查询数据](/develop/dev-guide-get-data-from-single-table.md)。 ### 删除数据 @@ -256,25 +256,61 @@ try (Session session = sessionFactory.openSession()) { } ``` -更多信息请参考 [删除数据](/develop/dev-guide-delete-data.md)。 +更多信息参见 [删除数据](/develop/dev-guide-delete-data.md)。 + +## 与 `MySQLDialect` 的兼容性 + +当你在 TiDB 中使用 `MySQLDialect` 时，请注意以下行为： + +### `SERIALIZABLE` 隔离级别 + +应用程序如果尝试设置 `SERIALIZABLE` 事务隔离级别，在 TiDB 中会遇到如下错误： + +``` +The isolation level 'SERIALIZABLE' is not supported. Set tidb_skip_isolation_level_check=1 to skip this error +``` + +为避免该错误，请在服务器端设置如下 TiDB 系统变量： + +```sql +SET GLOBAL tidb_skip_isolation_level_check=1; +``` + +启用该变量后，TiDB 会接受指定 `SERIALIZABLE` 的请求而不返回错误。内部实际仍采用 `REPEATABLE-READ`，这是 TiDB 的最强隔离级别。更多信息参见 [`tidb_skip_isolation_level_check`](/system-variables.md#tidb_skip_isolation_level_check)。 + +> **注意：** +> +> 社区维护的 `TiDBDialect` 会自动处理该行为，跳过需要 `SERIALIZABLE` 隔离级别的特性。 + +### `CHECK` 约束 + +Hibernate 的 [`@Check`](https://docs.hibernate.org/orm/6.5/javadocs/org/hibernate/annotations/Check.html) 注解会生成 DDL `CHECK` 约束。[MySQL 8.0.16 及以上版本](https://dev.mysql.com/doc/refman/8.0/en/create-table-check-constraints.html) 默认会强制执行这些约束，但 TiDB 默认不会强制执行，除非你显式开启。 + +如需在 TiDB 中启用 `CHECK` 约束强制执行，请设置如下系统变量： + +```sql +SET GLOBAL tidb_enable_check_constraint=ON; +``` + +如果未设置该变量，TiDB 会接受 `CHECK` 约束语法但不强制执行，可能导致数据完整性问题。更多信息参见 [`CHECK` 约束](/constraints.md#check)。 ## 后续步骤 -- 通过 [Hibernate 文档](https://hibernate.org/orm/documentation) 学习更多 Hibernate 的用法。 -- 通过 [开发者指南](/develop/dev-guide-overview.md) 各章节学习 TiDB 应用开发最佳实践，例如 [插入数据](/develop/dev-guide-insert-data.md)、[更新数据](/develop/dev-guide-update-data.md)、[删除数据](/develop/dev-guide-delete-data.md)、[单表读取](/develop/dev-guide-get-data-from-single-table.md)、[事务](/develop/dev-guide-transaction-overview.md) 和 [SQL 性能优化](/develop/dev-guide-optimize-sql-overview.md)。 -- 通过专业的 [TiDB 开发者课程](https://www.pingcap.com/education/) 学习，并在通过考试后获得 [TiDB 认证](https://www.pingcap.com/education/certification/)。 +- 通过 [Hibernate 文档](https://hibernate.org/orm/documentation) 学习更多 Hibernate 用法。 +- 通过 [开发者指南](/develop/dev-guide-overview.md) 各章节，学习 TiDB 应用开发最佳实践，例如 [插入数据](/develop/dev-guide-insert-data.md)、[修改数据](/develop/dev-guide-update-data.md)、[删除数据](/develop/dev-guide-delete-data.md)、[单表读取](/develop/dev-guide-get-data-from-single-table.md)、[事务](/develop/dev-guide-transaction-overview.md) 以及 [SQL 性能优化](/develop/dev-guide-optimize-sql-overview.md)。 +- 通过专业的 [TiDB 开发者课程](https://www.pingcap.com/education/)，考试通过后获得 [TiDB 认证](https://www.pingcap.com/education/certification/)。 - 通过 Java 开发者课程学习：[Working with TiDB from Java](https://eng.edu.pingcap.com/catalog/info/id:212)。 ## 需要帮助？ -在 [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc) 或 [Slack](https://slack.tidb.io/invite?team=tidb-community&channel=everyone&ref=pingcap-docs) 社区提问，或[提交支持工单](/support.md)。 +在 [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc) 或 [Slack](https://slack.tidb.io/invite?team=tidb-community&channel=everyone&ref=pingcap-docs) 社区提问，或 [提交支持工单](/support.md)。 -在 [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc) 或 [Slack](https://slack.tidb.io/invite?team=tidb-community&channel=everyone&ref=pingcap-docs) 社区提问，或[提交支持工单](https://tidb.support.pingcap.com/)。 +在 [Discord](https://discord.gg/DQZ2dy3cuc?utm_source=doc) 或 [Slack](https://slack.tidb.io/invite?team=tidb-community&channel=everyone&ref=pingcap-docs) 社区提问，或 [提交支持工单](https://tidb.support.pingcap.com/)。 diff --git a/latest_translation_commit.json b/latest_translation_commit.json index bdcc3f5b1cc50..4c7ce71f19599 100644 --- a/latest_translation_commit.json +++ b/latest_translation_commit.json @@ -1 +1,4 @@ -{"target":"release-8.5","sha":"4b35531be680642691b5fe69a8cfb8a2ef4ccae6"} \ No newline at end of file +{ + "target": "release-8.5", + "sha": "a7da86224f4c2bdb19c23f599fcc67e0bbdf67fe" +} \ No newline at end of file diff --git a/tidb-cloud/architecture-concepts.md b/tidb-cloud/architecture-concepts.md index a1875606e5b00..a582a77ed313e 100644 --- a/tidb-cloud/architecture-concepts.md +++ b/tidb-cloud/architecture-concepts.md @@ -7,7 +7,7 @@ summary: 了解 TiDB Cloud 的架构概念。 -TiDB Cloud 是一款全托管的数据库即服务（DBaaS），将 [TiDB](https://docs.pingcap.com/tidb/stable/overview)（一款开源 HTAP（混合事务与分析处理）数据库）的灵活性与强大功能带到 Amazon Web Services (AWS)、Google Cloud、Microsoft Azure 和阿里云。 +TiDB Cloud 是一款全托管的数据库即服务（DBaaS），将 [TiDB](https://docs.pingcap.com/tidb/stable/overview) 的灵活性与强大功能带到 Amazon Web Services (AWS)、Google Cloud、Microsoft Azure 和阿里云。TiDB 是一款开源 HTAP（混合事务与分析处理）数据库。 @@ -17,15 +17,15 @@ TiDB Cloud is a fully-managed Database-as-a-Service (DBaaS) that brings the flex -TiDB 兼容 MySQL，使得迁移和对接现有应用变得简单，同时提供无缝扩展能力，能够从小型负载到大规模高性能集群轻松应对。它在同一系统中同时支持事务型（OLTP）和分析型（OLAP）负载，简化运维并实现实时洞察。 +TiDB 兼容 MySQL，使得迁移和对接现有应用变得简单，同时具备无缝扩展性，能够应对从小型负载到大规模高性能集群的各种需求。它在一个系统中同时支持事务型（OLTP）和分析型（OLAP）负载，简化运维并实现实时洞察。 TiDB Cloud 让你轻松扩展数据库，处理复杂的管理任务，专注于开发可靠且高性能的应用。 -- 对于 AWS，TiDB Cloud 提供 **TiDB Cloud Starter**，适用于自动扩缩、成本高效的负载，**TiDB Cloud Essential**，适用于具备预配置容量的生产级负载，以及 **TiDB Cloud Dedicated**，适用于企业级应用，拥有专属资源和高级能力。 -- 对于 Google Cloud 和 Azure，TiDB Cloud 提供 **TiDB Cloud Dedicated**，适用于企业级应用，拥有专属资源和高级能力。 -- 对于阿里云，TiDB Cloud 提供 **TiDB Cloud Starter**，适用于自动扩缩、成本高效的负载，以及 **TiDB Cloud Essential**，适用于具备预配置容量的生产级负载。 +- 对于 AWS，TiDB Cloud 提供 **TiDB Cloud Starter**，适用于自动扩展、成本高效的负载；**TiDB Cloud Essential**，适用于具备预配置容量的生产级负载；以及 **TiDB Cloud Dedicated**，为企业级应用提供专属资源和高级功能。 +- 对于 Google Cloud 和 Azure，TiDB Cloud 提供 **TiDB Cloud Dedicated**，为企业级应用提供专属资源和高级功能。 +- 对于阿里云，TiDB Cloud 提供 **TiDB Cloud Starter**，适用于自动扩展、成本高效的负载，以及 **TiDB Cloud Essential**，适用于具备预配置容量的生产级负载。 @@ -38,35 +38,35 @@ TiDB Cloud 让你轻松扩展数据库，处理复杂的管理任务，专注于 ## TiDB Cloud Starter -TiDB Cloud Starter 是一款全托管的多租户 TiDB 服务，提供即开即用、自动扩缩的 MySQL 兼容数据库。 +TiDB Cloud Starter 是一款全托管的多租户 TiDB 产品，提供即开即用、自动扩展的 MySQL 兼容数据库。 Starter 集群方案非常适合刚开始使用 TiDB Cloud 的用户。它为开发者和小型团队提供以下特性： - **免费**：该方案完全免费，无需信用卡即可开始使用。 - **存储**：提供初始 5 GiB 的行存储和 5 GiB 的列存储。 -- **请求单元**：包含 5000 万 [请求单元（RUs）](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) 用于数据库操作。 +- **Request Units**：包含 5000 万 [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) 用于数据库操作。 ## TiDB Cloud Essential 对于负载持续增长、需要实时扩展的应用，Essential 集群方案提供灵活性和性能，助力你的业务增长，具备以下特性： -- **增强能力**：包含 Starter 方案的全部能力，并具备处理更大、更复杂负载的能力，以及高级安全特性。 -- **自动扩缩**：自动调整存储和计算资源，高效应对不断变化的负载需求。 -- **高可用性**：内置容错和冗余机制，确保你的应用即使在基础设施故障时也能保持可用和弹性。 -- **可预测的定价**：根据存储和计算资源的请求容量单元（RCUs）计费，提供透明、按用量计费的定价模式，随需扩展，让你只为实际使用的资源付费，无额外意外支出。 +- **增强能力**：包含 Starter 方案的全部功能，并具备处理更大、更复杂负载的能力，以及高级安全特性。 +- **自动扩展**：自动调整存储和计算资源，高效应对不断变化的负载需求。 +- **高可用性**：内置容错和冗余机制，确保你的应用在基础设施故障时依然可用且具备弹性。 +- **可预测的定价**：根据存储和计算资源的 Request Capacity Units (RCUs) 计费，提供透明、按用量计费的定价模式，随需扩展，按实际使用付费，无隐藏费用。 -TiDB Cloud Essential 提供两种高可用性选项，以满足不同的运维需求。 +TiDB Cloud Essential 提供两种高可用类型，以满足不同的运维需求。 -- 默认情况下，采用区域可用性（Zonal High Availability）选项的集群，其所有组件都位于同一可用区，带来更低的网络延迟。 -- 对于需要最大基础设施隔离和冗余的应用，可以选择区域级高可用性（Regional High Availability）选项，将节点分布在多个可用区。 +- 默认情况下，采用 Zonal High Availability 选项的集群，其所有组件都位于同一可用区，从而降低网络延时。 +- 对于需要最大基础设施隔离和冗余的应用，Regional High Availability 选项会将节点分布在多个可用区。 -更多信息，参见 [TiDB Cloud Starter 和 Essential 的高可用性](/tidb-cloud/serverless-high-availability.md)。 +更多信息，参见 [TiDB Cloud 的高可用性](/tidb-cloud/serverless-high-availability.md)。 ## TiDB Cloud Dedicated -TiDB Cloud Dedicated 专为关键业务设计，提供跨多个可用区的高可用性、水平扩展能力和完整的 HTAP 能力。 +TiDB Cloud Dedicated 专为关键业务设计，提供跨多个可用区的高可用性、横向扩展能力和完整的 HTAP 能力。 -该方案基于隔离的云资源（如 VPC、VM、托管 Kubernetes 服务和云存储）构建，充分利用主流云服务商的基础设施。TiDB Cloud Dedicated 集群支持完整的 TiDB 功能集，实现快速扩展、可靠备份、在指定 VPC 内部署以及地理级别的灾备能力。 +该方案基于隔离的云资源（如 VPC、VM、托管 Kubernetes 服务和云存储）构建，充分利用主流云厂商的基础设施。TiDB Cloud Dedicated 集群支持完整的 TiDB 功能集，实现快速扩展、可靠备份、在指定 VPC 内部署以及地域级容灾。 ![TiDB Cloud Dedicated 架构](/media/tidb-cloud/tidb-cloud-dedicated-architecture.png) @@ -94,18 +94,18 @@ TiDB Cloud API 是基于 REST 的接口，提供对 TiDB Cloud Starter 和 TiDB 在 TiDB Cloud 中，每个集群由 TiDB、TiKV 和 TiFlash 节点组成。 -- 在 TiDB Cloud Dedicated 集群中，你可以根据性能需求完全管理专属 TiDB、TiKV 和 TiFlash 节点的数量和规格。更多信息，参见 [可扩展性](/tidb-cloud/scalability-concepts.md)。 -- 在 TiDB Cloud Starter 或 TiDB Cloud Essential 集群中，TiDB、TiKV 和 TiFlash 节点的数量和规格由系统自动管理。这确保了无缝扩展，无需用户手动配置或管理节点。 +- 在 TiDB Cloud Dedicated 集群中，你可以根据性能需求完全管理专属 TiDB、TiKV 和 TiFlash 节点的数量和规格。更多信息，参见 [扩展性](/tidb-cloud/scalability-concepts.md)。 +- 在 TiDB Cloud Starter 或 TiDB Cloud Essential 集群中，TiDB、TiKV 和 TiFlash 节点的数量和规格由系统自动管理，确保无缝扩展，无需用户手动配置或管理节点。 ### TiDB 节点 -[TiDB 节点](/tidb-computing.md) 是无状态的 SQL 层，通过 MySQL 兼容的端点与应用连接。它负责解析、优化 SQL 查询，并生成分布式执行计划。 +[TiDB 节点](/tidb-computing.md) 是无状态的 SQL 层，通过 MySQL 兼容端口与应用连接。它负责解析、优化 SQL 查询，并生成分布式执行计划。 -你可以部署多个 TiDB 节点以实现水平扩展，处理更高的负载。这些节点通常与负载均衡器（如 TiProxy 或 HAProxy）配合使用，提供无缝接口。TiDB 节点本身不存储数据——它们会将数据请求转发给 TiKV 节点（用于行存储）或 TiFlash 节点（用于列存储）。 +你可以部署多个 TiDB 节点以实现横向扩展，处理更高负载。这些节点与负载均衡器（如 TiProxy 或 HAProxy）协同工作，提供无缝接口。TiDB 节点本身不存储数据——它们会将数据请求转发给 TiKV 节点（用于行存储）或 TiFlash 节点（用于列存储）。 ### TiKV 节点 -[TiKV 节点](/tikv-overview.md) 是 TiDB 架构中数据存储的核心，作为分布式事务型键值存储引擎，具备高可靠性、可扩展性和高可用性。 +[TiKV 节点](/tikv-overview.md) 是 TiDB 架构中数据存储的核心，作为分布式事务型键值存储引擎，具备可靠性、扩展性和高可用性。 **主要特性：** @@ -116,27 +116,27 @@ TiDB Cloud API 是基于 REST 的接口，提供对 TiDB Cloud Starter 和 TiDB - **事务支持** - - TiKV 节点在键值层面原生支持分布式事务，默认隔离级别为快照隔离（Snapshot Isolation）。 - - TiDB 节点将 SQL 执行计划转化为对 TiKV 节点 API 的调用，实现无缝的 SQL 级事务支持。 + - TiKV 节点在键值层面原生支持分布式事务，默认隔离级别为 Snapshot Isolation。 + - TiDB 节点将 SQL 执行计划转换为对 TiKV 节点 API 的调用，从而实现无缝的 SQL 级事务支持。 - **高可用性** - - TiKV 节点中的所有数据都会被复制（默认：三副本），以保证数据持久性。 - - TiKV 原生支持高可用和自动故障转移，防止节点故障带来的影响。 + - TiKV 节点中的所有数据都会被复制（默认 3 副本），以保证持久性。 + - TiKV 原生支持高可用和自动故障转移，防止节点故障带来影响。 -- **可扩展性与可靠性** +- **扩展性与可靠性** - TiKV 节点设计用于处理不断扩展的数据集，同时保持分布式一致性和容错能力。 ### TiFlash 节点 -[TiFlash 节点](/tiflash/tiflash-overview.md) 是 TiDB 架构中的一种专用存储节点。与普通 TiKV 节点不同，TiFlash 采用列式存储模型，专为分析加速设计。 +[TiFlash 节点](/tiflash/tiflash-overview.md) 是 TiDB 架构中的一种专用存储节点。与普通 TiKV 节点不同，TiFlash 采用列存储模型，专为分析加速设计。 **主要特性：** -- **列式存储** +- **列存储** - TiFlash 节点以列存格式存储数据，针对分析型查询进行了优化，显著提升了读密集型负载的性能。 + TiFlash 节点以列式格式存储数据，针对分析型查询进行了优化，大幅提升读密集型负载的性能。 - **向量检索索引支持** diff --git a/tidb-cloud/built-in-monitoring.md b/tidb-cloud/built-in-monitoring.md index ff2c278bce472..f71957bcbc083 100644 --- a/tidb-cloud/built-in-monitoring.md +++ b/tidb-cloud/built-in-monitoring.md @@ -13,7 +13,7 @@ TiDB Cloud 会在 **统计/指标（信息）** 页面收集并展示你的集 1. 在你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，点击目标集群的名称，进入其概览页面。 - > **提示：** + > **Tip:** > > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 @@ -31,56 +31,60 @@ TiDB Cloud 会在 **统计/指标（信息）** 页面收集并展示你的集 | 统计/指标（信息）名称 | 标签 | 描述 | | :------------| :------| :-------------------------------------------- | -| Database Time by SQL types | database time, {SQL type} | database time：每秒的总数据库时间。
{SQL type}：每秒由不同 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE` 等）语句消耗的数据库时间。 | -| Query Per Second | {SQL type} | 所有 TiDB 实例每秒执行的 SQL 语句数量，按 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE` 等）统计。 | -| Query Duration | avg-{SQL type}, 99-{SQL type} | 从客户端发送请求到 TiDB，直到 TiDB 执行请求并将结果返回给客户端的持续时间。通常，客户端请求以 SQL 语句形式发送；但该持续时间也可能包含如 `COM_PING`、`COM_SLEEP`、`COM_STMT_FETCH`、`COM_SEND_LONG_DATA` 等命令的执行时间。TiDB 支持 Multi-Query，即客户端可一次发送多个 SQL 语句，如 `select 1; select 1; select 1;`。此时，该查询的总执行时间包含所有 SQL 语句的执行时间。 | -| Failed Queries | All, {Error type} @ {instance} | 按每个 TiDB 实例每分钟 SQL 语句执行错误的错误类型（如语法错误、主键冲突等）进行统计。包含发生错误的模块和错误码。 | -| Command Per Second | Query, StmtExecute, and StmtPrepare | 所有 TiDB 实例每秒按命令类型处理的命令数量。 | -| Queries Using Plan Cache OPS | hit, miss | hit：所有 TiDB 实例每秒使用计划缓存的查询数量。
miss：所有 TiDB 实例每秒未命中计划缓存的查询数量。 | -| Transaction Per Second | {types}-{transaction model} | 每秒执行的事务数量。 | -| Transaction Duration | avg-{transaction model}, 99-{transaction model} | 事务的平均或第 99 百分位持续时间。 | -| Connection Count | All, active connection | All：所有 TiDB 实例的连接数。
Active connections：所有 TiDB 实例的活跃连接数。 | -| Disconnection Count | {instance}-{result} | 每个 TiDB 实例断开连接的客户端数量。 | +| Database Time by SQL types | database time, {SQL type} | database time：每秒的数据库总耗时。
{SQL type}：每秒按 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE`）统计的 SQL 语句消耗的数据库时间。| +| Query Per Second | {SQL type} | 所有 TiDB 实例每秒执行的 SQL 语句数量，按 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE`）统计。| +| Query Duration | avg-{SQL type}, 99-{SQL type} | 从客户端发送请求到 TiDB，直到 TiDB 执行请求并将结果返回给客户端的持续时间。通常，客户端请求以 SQL 语句形式发送；但该持续时间也可能包含如 `COM_PING`、`COM_SLEEP`、`COM_STMT_FETCH`、`COM_SEND_LONG_DATA` 等命令的执行时间。TiDB 支持 Multi-Query，即客户端可一次发送多条 SQL 语句，如 `select 1; select 1; select 1;`。此时，该查询的总执行时间包含所有 SQL 语句的执行时间。| +| Failed Queries | All, {Error type} @ {instance} | 每分钟统计每个 TiDB 实例上 SQL 语句执行错误的错误类型（如语法错误、主键冲突），包含出错模块和错误码。| +| Command Per Second | Query, StmtExecute, and StmtPrepare | 所有 TiDB 实例每秒按命令类型处理的命令数量。| +| Queries Using Plan Cache OPS | hit, miss | hit：所有 TiDB 实例每秒命中执行计划缓存的查询数量。
miss：所有 TiDB 实例每秒未命中执行计划缓存的查询数量。| +| Transaction Per Second | {types}-{transaction model} | 每秒执行的事务数量。| +| Transaction Duration | avg-{transaction model}, 99-{transaction model} | 事务的平均或第 99 百分位持续时间。| +| Connection Count | All, active connection | All：所有 TiDB 实例的连接数。
Active connections：所有 TiDB 实例的活跃连接数。| +| Disconnection Count | {instance}-{result} | 每个 TiDB 实例断开连接的客户端数量。| ### 高级 | 统计/指标（信息）名称 | 标签 | 描述 | | :------------| :------| :-------------------------------------------- | -| Average Idle Connection Duration | avg-in-txn, avg-not-in-txn | 连接空闲持续时间表示连接处于空闲状态的时长。
avg-in-txn：连接处于事务中时的平均空闲持续时间。
avg-not-in-txn：连接不在事务中时的平均空闲持续时间。 | -| Get Token Duration | avg, 99 | 获取 SQL 语句 token 的平均或第 99 百分位耗时。 | -| Parse Duration | avg, 99 | 解析 SQL 语句的平均或第 99 百分位耗时。 | -| Compile Duration | avg, 99 | 将解析后的 SQL AST 编译为执行计划的平均或第 99 百分位耗时。 | -| Execute Duration | avg, 99 | 执行 SQL 语句执行计划的平均或第 99 百分位耗时。 | -| Average TiDB KV Request Duration | {Request Type} | 所有 TiDB 实例按请求类型（如 `Get`、`Prewrite`、`Commit` 等）执行 KV 请求的平均耗时。 | -| Average TiKV gRPC Duration | {Request Type} | 所有 TiKV 实例按请求类型（如 `kv_get`、`kv_prewrite`、`kv_commit` 等）执行 gRPC 请求的平均耗时。 | -| Average / P99 PD TSO Wait/RPC Duration | wait-avg/99, rpc-avg/99 | Wait：所有 TiDB 实例等待 PD 返回 TSO 的平均或第 99 百分位耗时。
RPC：所有 TiDB 实例从发送 TSO 请求到 PD 到收到 TSO 的平均或第 99 百分位耗时。 | -| Average / P99 Storage Async Write Duration | avg, 99 | 异步写入的平均或第 99 百分位耗时。平均存储异步写入耗时 = 平均 store 耗时 + 平均 apply 耗时。 | -| Average / P99 Store Duration | avg, 99 | 异步写入过程中存储循环的平均或第 99 百分位耗时。 | -| Average / P99 Apply Duration | avg, 99 | 异步写入过程中 apply 循环的平均或第 99 百分位耗时。 | -| Average / P99 Append Log Duration | avg, 99 | Raft 追加日志的平均或第 99 百分位耗时。 | -| Average / P99 Commit Log Duration | avg, 99 | Raft 提交日志的平均或第 99 百分位耗时。 | -| Average / P99 Apply Log Duration | avg, 99 | Raft 应用日志的平均或第 99 百分位耗时。 | -| Affected Rows | {SQL type} | 按 SQL 类型每秒处理的行数。 | -| Leader Count | {instance} | TiKV 节点上承载的 Raft Leader Region 数量。 | -| Region Count | {instance} | TiKV 节点管理的总数据 Region 数量。 | +| Average Idle Connection Duration | avg-in-txn, avg-not-in-txn | 连接空闲持续时间表示连接处于空闲状态的时长。
avg-in-txn：连接处于事务中时的平均空闲持续时间。
avg-not-in-txn：连接不在事务中时的平均空闲持续时间。| +| Get Token Duration | avg, 99 | 获取 SQL 语句 token 的平均或第 99 百分位耗时。| +| Parse Duration | avg, 99 | 解析 SQL 语句的平均或第 99 百分位耗时。| +| Compile Duration | avg, 99 | 将解析后的 SQL AST 编译为执行计划的平均或第 99 百分位耗时。| +| Execute Duration | avg, 99 | 执行 SQL 语句执行计划的平均或第 99 百分位耗时。| +| Average TiDB KV Request Duration | {Request Type} | 所有 TiDB 实例按请求类型（如 `Get`、`Prewrite`、`Commit`）统计的 KV 请求平均耗时。| +| Average TiKV gRPC Duration | {Request Type} | 所有 TiKV 实例按请求类型（如 `kv_get`、`kv_prewrite`、`kv_commit`）统计的 gRPC 请求平均耗时。| +| Average / P99 PD TSO Wait/RPC Duration | wait-avg/99, rpc-avg/99 | Wait：所有 TiDB 实例等待 PD 返回 TSO 的平均或第 99 百分位耗时。
RPC：所有 TiDB 实例从发送 TSO 请求到 PD 到收到 TSO 的平均或第 99 百分位耗时。| +| Average / P99 Storage Async Write Duration | avg, 99 | 异步写入的平均或第 99 百分位耗时。平均存储异步写入耗时 = 平均 store 耗时 + 平均 apply 耗时。| +| Average / P99 Store Duration | avg, 99 | 异步写入过程中存储循环的平均或第 99 百分位耗时。| +| Average / P99 Apply Duration | avg, 99 | 异步写入过程中 apply 循环的平均或第 99 百分位耗时。| +| Average / P99 Append Log Duration | avg, 99 | Raft 追加日志的平均或第 99 百分位耗时。| +| Average / P99 Commit Log Duration | avg, 99 | Raft 提交日志的平均或第 99 百分位耗时。| +| Average / P99 Apply Log Duration | avg, 99 | Raft 应用日志的平均或第 99 百分位耗时。| +| Affected Rows | {SQL type} | 按 SQL 类型每秒处理的行数。| +| Leader Count | {instance} | TiKV 节点承载的 Raft Leader Region 数量。| +| Region Count | {instance} | TiKV 节点管理的总数据 Region 数量。| ### 服务器 | 统计/指标（信息）名称 | 标签 | 描述 | | :------------| :------| :-------------------------------------------- | -| TiDB Uptime | node | 每个 TiDB 节点自上次重启以来的运行时长。 | -| TiDB CPU Usage | node, limit | 每个 TiDB 节点的 CPU 使用率统计或上限。 | -| TiDB Memory Usage | node, limit | 每个 TiDB 节点的内存使用率统计或上限。 | -| TiKV Uptime | node | 每个 TiKV 节点自上次重启以来的运行时长。 | -| TiKV CPU Usage | node, limit | 每个 TiKV 节点的 CPU 使用率统计或上限。 | -| TiKV Memory Usage | node, limit | 每个 TiKV 节点的内存使用率统计或上限。 | -| TiKV IO Bps | node-write, node-read | 每个 TiKV 节点每秒读写的总输入/输出字节数。 | -| TiKV Storage Usage | node, limit | 每个 TiKV 节点的存储使用率统计或上限。 | -| TiFlash Uptime | node | 每个 TiFlash 节点自上次重启以来的运行时长。 | -| TiFlash CPU Usage | node, limit | 每个 TiFlash 节点的 CPU 使用率统计或上限。 | -| TiFlash Memory Usage | node, limit | 每个 TiFlash 节点的内存使用率统计或上限。 | -| TiFlash IO MBps | node-write, node-read | 每个 TiFlash 节点的读写总字节数。 | -| TiFlash Storage Usage | node, limit | 每个 TiFlash 节点的存储使用率统计或上限。 | +| TiDB Uptime | node | 每个 TiDB 节点自上次重启以来的运行时长。| +| TiDB CPU Usage | node, limit | 每个 TiDB 节点的 CPU 使用率统计或上限。| +| TiDB Memory Usage | node, limit | 每个 TiDB 节点的内存使用率统计或上限。| +| TiKV Uptime | node | 每个 TiKV 节点自上次重启以来的运行时长。| +| TiKV CPU Usage | node, limit | 每个 TiKV 节点的 CPU 使用率统计或上限。| +| TiKV Memory Usage | node, limit | 每个 TiKV 节点的内存使用率统计或上限。| +| TiKV IO Bps | node-write, node-read | 每个 TiKV 节点每秒读写的总输入/输出字节数。| +| TiKV Storage Usage | node, limit | 每个 TiKV 节点的存储使用率统计或上限。| +| TiFlash Uptime | node | 每个 TiFlash 节点自上次重启以来的运行时长。| +| TiFlash CPU Usage | node, limit | 每个 TiFlash 节点的 CPU 使用率统计或上限。| +| TiFlash Memory Usage | node, limit | 每个 TiFlash 节点的内存使用率统计或上限。| +| TiFlash IO MBps | node-write, node-read | 每个 TiFlash 节点的读写总字节数。| +| TiFlash Storage Usage | node, limit | 每个 TiFlash 节点的存储使用率统计或上限。| +| TiProxy CPU Usage | node | 每个 TiProxy 节点的 CPU 使用率统计。上限为 100%。| +| TiProxy Connections | node | 每个 TiProxy 节点的连接数。| +| TiProxy Throughput | node | 每个 TiProxy 节点每秒传输的字节数。| +| TiProxy Sessions Migration Reasons | reason | 每分钟发生的会话迁移次数及其原因。| ## TiDB Cloud Starter 和 TiDB Cloud Essential 集群的统计/指标（信息） @@ -95,17 +99,17 @@ TiDB Cloud 会在 **统计/指标（信息）** 页面收集并展示你的集 | 统计/指标（信息）名称 | 标签 | 描述 | | :------------| :------| :-------------------------------------------- | -| Request Units | RU per second | Request Unit（RU）是用于衡量 TiDB Cloud Starter 集群中查询或事务资源消耗的单位。除了用户查询，后台活动也会消耗 RU，因此即使 QPS 为 0，每秒 RU 使用量也可能大于 0。| -| Capacity vs Usage (RU/s) | Provisioned capacity (RCU), Consumed RU/s | TiDB Cloud Essential 集群中配置的 Request Capacity Units（RCU）和每秒消耗的 Request Units（RU）。 | -| Used Storage Size | Row-based storage, Columnar storage | 行存储和列存储的大小。仅当每种存储类型达到 50 MiB 或更大时才显示该统计/指标（信息）。 | -| Query Per Second | All, {SQL type} | 每秒执行的 SQL 语句数量，按 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE` 等）统计。 | -| Query Duration | Avg, P99, P99-{SQL type} | 从客户端发送请求到 TiDB Cloud Starter 或 TiDB Cloud Essential 集群，直到集群执行请求并将结果返回给客户端的持续时间。 | -| Failed Query | All | 每秒 SQL 语句执行错误的数量。 | -| Transaction Per Second | All | 每秒执行的事务数量。 | -| Transaction Duration | Avg, P99 | 事务的执行持续时间。 | -| Lock-wait | P95, P99 | 事务等待获取悲观锁所花费的时间。高值通常表示对同一行或键存在竞争。 | -| Total Connection | All | 连接到 TiDB Cloud Starter 或 TiDB Cloud Essential 集群的连接数。 | -| Idle Connection Duration | P99, P99(in-txn), P99(not-in-txn) | 连接在开启事务时保持空闲的时间。较长的持续时间通常表示应用逻辑较慢或存在长事务。 | +| Request Units | RU per second | Request Unit（RU）是用于跟踪 TiDB Cloud Starter 集群中查询或事务资源消耗的度量单位。除用户查询外，后台活动也会消耗 RU，因此即使 QPS 为 0，每秒 RU 使用量也可能不为零。| +| Capacity vs Usage (RU/s) | Provisioned capacity (RCU), Consumed RU/s | TiDB Cloud Essential 集群中每秒的 Request Capacity Units（RCU）和已消耗的 Request Units（RU）。| +| Used Storage Size | Row-based storage, Columnar storage | 行存储和列存储的大小。仅当每种存储类型大于等于 50 MiB 时才显示该统计/指标（信息）。| +| Query Per Second | All, {SQL type} | 每秒执行的 SQL 语句数量，按 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE`）统计。| +| Query Duration | Avg, P99, P99-{SQL type} | 从客户端发送请求到 TiDB Cloud Starter 或 TiDB Cloud Essential 集群，直到集群执行请求并将结果返回给客户端的持续时间。| +| Failed Query | All | 每秒 SQL 语句执行错误的数量。| +| Transaction Per Second | All | 每秒执行的事务数量。| +| Transaction Duration | Avg, P99 | 事务的执行持续时间。| +| Lock-wait | P95, P99 | 事务等待获取悲观锁所花费的时间。高值通常表示对同一行或键存在竞争。| +| Total Connection | All | 连接到 TiDB Cloud Starter 或 TiDB Cloud Essential 集群的连接数。| +| Idle Connection Duration | P99, P99(in-txn), P99(not-in-txn) | 连接在开启事务期间保持空闲的时间。较长的持续时间通常表示应用逻辑较慢或存在长事务。| ### Database Status @@ -113,20 +117,20 @@ TiDB Cloud 会在 **统计/指标（信息）** 页面收集并展示你的集 | 统计/指标（信息）名称 | 标签 | 描述 | | :------------| :------| :-------------------------------------------- | -| QPS Per DB | All, {Database name} | 每个数据库每秒执行的 SQL 语句数量，按 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE` 等）统计。 | -| Average Query Duration Per DB | All, {Database name} | 从客户端发送请求到某个数据库，直到该数据库执行请求并将结果返回给客户端的持续时间。| +| QPS Per DB | All, {Database name} | 每个数据库每秒执行的 SQL 语句数量，按 SQL 类型（如 `SELECT`、`INSERT`、`UPDATE`）统计。| +| Average Query Duration Per DB | All, {Database name} | 从客户端发送请求到数据库，直到数据库执行请求并将结果返回给客户端的持续时间。| | Failed Query Per DB | All, {Database name} | 每个数据库每秒 SQL 语句执行错误的错误类型统计。| -## 常见问题 +## FAQ -**1. 为什么本页面有些面板为空？** +**1. 为什么本页面部分面板为空？** 如果某个面板没有提供任何统计/指标（信息），可能原因如下： - 对应集群的负载未触发该统计/指标（信息）。例如，如果没有失败查询，则失败查询统计/指标（信息）始终为空。 - 集群版本较低。你需要将其升级到最新的 TiDB 版本以查看这些统计/指标（信息）。 -如果排除了上述原因，你可以联系 [PingCAP 支持团队](/tidb-cloud/tidb-cloud-support.md) 进行排查。 +如果排除了上述原因，你可以联系 [PingCAP support team](/tidb-cloud/tidb-cloud-support.md) 进行排查。 **2. 为什么在极少数情况下统计/指标（信息）会出现不连续？** diff --git a/tidb-cloud/delete-tidb-cluster.md b/tidb-cloud/delete-tidb-cluster.md index 52a3b98e84614..e3746730b948c 100644 --- a/tidb-cloud/delete-tidb-cluster.md +++ b/tidb-cloud/delete-tidb-cluster.md @@ -7,10 +7,10 @@ summary: 了解如何删除 TiDB 集群。 本文档介绍如何在 TiDB Cloud 上删除 TiDB 集群。 -你可以随时通过以下步骤删除集群： +你可以随时按照以下步骤删除集群： 1. 进入你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。 -2. 在你想要删除的目标集群所在行，点击 **...**。 +2. 在你要删除的目标集群所在行，点击 **...**。 > **提示：** > @@ -19,21 +19,21 @@ summary: 了解如何删除 TiDB 集群。 3. 在下拉菜单中点击 **Delete**。 4. 在集群删除窗口中，确认删除操作： - - 如果你至少有一次手动或自动备份，你可以看到备份的数量以及备份的计费策略。点击 **Continue** 并输入 `//`。 + - 如果你至少有一个手动或自动备份，你可以看到备份的数量以及备份的计费策略。点击 **Continue** 并输入 `//`。 - 如果你没有任何备份，只需输入 `//`。 - 如果你希望将来恢复该集群，请确保你已经对集群进行了备份。否则，将无法再恢复。关于如何备份 TiDB Cloud Dedicated 集群的更多信息，请参见 [Back Up and Restore TiDB Cloud Dedicated Data](/tidb-cloud/backup-and-restore.md)。 + 如果你希望将来恢复该集群，请确保你已经对集群进行了备份。否则，你将无法再恢复它。关于如何备份 TiDB Cloud Dedicated 集群的更多信息，请参见 [Back Up and Restore TiDB Cloud Dedicated Data](/tidb-cloud/backup-and-restore.md)。 > **注意：** > - > [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 和 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群在删除后不支持数据恢复。如果你希望删除 TiDB Cloud Starter 或 TiDB Cloud Essential 集群并在未来恢复其数据，请参见 [Export Data from TiDB Cloud Starter or Essential](/tidb-cloud/serverless-export.md) 将你的数据导出作为备份。 + > [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 和 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群在删除后不支持数据恢复。如果你希望删除 TiDB Cloud Starter 或 TiDB Cloud Essential 集群并在将来恢复其数据，请参见 [Export Data from TiDB Cloud Starter or Essential](/tidb-cloud/serverless-export.md) 将你的数据导出作为备份。 5. 点击 **I understand, delete it**。 一旦已备份的 TiDB Cloud Dedicated 集群被删除，该集群现有的备份文件会被移动到回收站。 - - 自动备份将在保留期结束后过期并自动删除。如果你未修改，默认保留期为 7 天。 - - 手动备份会一直保留在回收站，直到被手动删除。 + - 自动备份将在保留时间结束后过期并被自动删除，最新的一份除外。如果你没有修改，默认保留时间为 7 天。除非你明确删除，最新的自动备份不会被删除。 + - 手动备份会一直保留在回收站中，直到被手动删除。 > **注意：** > diff --git a/tidb-cloud/features.md b/tidb-cloud/features.md index 258db1d50b57f..044a96eec0200 100644 --- a/tidb-cloud/features.md +++ b/tidb-cloud/features.md @@ -11,7 +11,7 @@ summary: 了解不同 TiDB Cloud 方案的功能支持状态。 > > [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 是开始体验 TiDB Cloud 的最佳方式。此外，你还可以在 [TiDB Playground](https://play.tidbcloud.com/?utm_source=docs&utm_medium=tidb_cloud_quick_start) 上试用 TiDB Cloud 的功能。 -- ✅：该功能已普遍可用，除非另有说明为预览版。 +- ✅：该功能已普遍可用，除非另有标注为 “Private preview” 或 “Public preview”。 - ❌：该功能当前不可用。 @@ -38,9 +38,9 @@ summary: 了解不同 TiDB Cloud 方案的功能支持状态。 - - - + + + @@ -71,20 +71,20 @@ summary: 了解不同 TiDB Cloud 方案的功能支持状态。 - + - - + + - + @@ -204,7 +204,7 @@ summary: 了解不同 TiDB Cloud 方案的功能支持状态。 - + @@ -234,9 +234,9 @@ summary: 了解不同 TiDB Cloud 方案的功能支持状态。 - - - + + + @@ -279,4 +279,4 @@ summary: 了解不同 TiDB Cloud 方案的功能支持状态。 > **提示：** > -> 如需申请私有预览功能，请点击 [TiDB Cloud 控制台](https://tidbcloud.com) 右下角的 **?**，然后点击 **Request Support**。接着，在 **Description** 字段中填写功能名称，并点击 **Submit**。 \ No newline at end of file +> 如需申请私测功能，请点击 [TiDB Cloud 控制台](https://tidbcloud.com) 右下角的 **?**，然后点击 **Request Support**。在 **Description** 字段中填写功能名称，并点击 **Submit**。 \ No newline at end of file diff --git a/tidb-cloud/key-concepts.md b/tidb-cloud/key-concepts.md index bf5adda77d7f1..41883cbcd0018 100644 --- a/tidb-cloud/key-concepts.md +++ b/tidb-cloud/key-concepts.md @@ -9,51 +9,51 @@ summary: 了解 TiDB Cloud 的关键概念。 ## 架构 -TiDB Cloud 基于云原生分布式架构构建，实现了计算与存储分离，支持弹性扩展和高可用性。[了解更多 TiDB Cloud 架构相关内容](/tidb-cloud/architecture-concepts.md)。 +TiDB Cloud 基于云原生分布式架构构建，实现了计算与存储分离，支持弹性扩展和高可用。[了解更多 TiDB Cloud 架构](/tidb-cloud/architecture-concepts.md)。 -## 数据库模式 +## 数据库 schema -TiDB Cloud 允许你通过数据库、数据表、列、索引和约束等对象来组织和结构化你的数据。同时还支持临时表、向量索引和缓存表等高级特性。[了解更多数据库模式相关内容](/tidb-cloud/database-schema-concepts.md)。 +TiDB Cloud 允许你通过数据库、表、列、索引和约束等对象来组织和结构化你的数据。同时还支持临时表、向量索引和缓存表等高级功能。[了解更多数据库 schema](/tidb-cloud/database-schema-concepts.md)。 ## 事务 -TiDB 提供完整的分布式事务，并在 [Google Percolator](https://research.google.com/pubs/pub36726.html) 的基础上进行了部分优化。[了解更多事务相关内容](/tidb-cloud/transaction-concepts.md)。 +TiDB 提供完整的分布式事务，并在 [Google Percolator](https://research.google.com/pubs/pub36726.html) 的基础上进行了部分优化。[了解更多事务](/tidb-cloud/transaction-concepts.md)。 ## SQL -TiDB 高度兼容 MySQL 协议，以及 MySQL 5.7 和 MySQL 8.0 的常用特性和语法。[了解更多 TiDB Cloud 中的 SQL 相关内容](/tidb-cloud/sql-concepts.md)。 +TiDB 高度兼容 MySQL 协议，以及 MySQL 5.7 和 MySQL 8.0 的常用功能和语法。[了解更多 TiDB Cloud 中的 SQL](/tidb-cloud/sql-concepts.md)。 -## AI 特性 +## AI 功能 -TiDB Cloud 的 AI 特性使你能够充分利用先进技术进行数据探索、检索和集成。[了解更多 AI 特性相关内容](/tidb-cloud/ai-feature-concepts.md)。 +TiDB Cloud 的 AI 功能使你能够充分利用先进技术进行数据探索、搜索和集成。[了解更多 AI 功能](/tidb-cloud/ai-feature-concepts.md)。 -## 数据服务（Beta） +## Data Service（Beta） -数据服务允许你通过自定义 API 端点，以 HTTPS 请求方式访问 TiDB Cloud 数据。[了解更多数据服务相关内容](/tidb-cloud/data-service-concepts.md)。 +Data Service 允许你通过自定义 API 端点，使用 HTTPS 请求访问 TiDB Cloud 数据。[了解更多 Data Service](/tidb-cloud/data-service-concepts.md)。 -## 可扩展性 +## 扩展性 -TiDB Cloud Dedicated 允许你分别调整计算和存储资源，以适应数据量或工作负载的变化。[了解更多可扩展性相关内容](/tidb-cloud/scalability-concepts.md)。 +TiDB Cloud Dedicated 支持你分别调整计算和存储资源，以适应数据量或负载的变化。[了解更多扩展性](/tidb-cloud/scalability-concepts.md)。 -## 高可用性 +## 高可用 -TiDB Cloud 在 TiDB Cloud Serverless 和 TiDB Cloud Dedicated 集群中都能确保高可用性： +TiDB Cloud 在所有支持的方案中都保证高可用： -- [TiDB Cloud Serverless 的高可用性](/tidb-cloud/serverless-high-availability.md) -- [TiDB Cloud Dedicated 的高可用性](/tidb-cloud/high-availability-with-multi-az.md) +- 对于 TiDB Cloud Starter 和 TiDB Cloud EssentialTiDB Cloud Starter、TiDB Cloud Essential 和 TiDB Cloud Premium，参见 [TiDB Cloud 的高可用](/tidb-cloud/serverless-high-availability.md)。 +- 对于 TiDB Cloud Dedicated，参见 [TiDB Cloud Dedicated 的高可用](/tidb-cloud/high-availability-with-multi-az.md)。 ## 监控 -TiDB Cloud 提供了全面的集群性能和健康状况监控能力。[了解更多监控相关内容](/tidb-cloud/monitoring-concepts.md)。 +TiDB Cloud 提供全面的集群性能与健康监控能力。[了解更多监控](/tidb-cloud/monitoring-concepts.md)。 ## 数据流 -TiDB Cloud 允许你将 TiDB 集群中的数据变更流式传输到其他系统，如 Kafka、MySQL 和对象存储。[了解更多数据流相关内容](/tidb-cloud/data-streaming-concepts.md)。 +TiDB Cloud 支持将 TiDB 集群中的数据变更流式传输到其他系统，如 Kafka、MySQL 和对象存储。[了解更多数据流](/tidb-cloud/data-streaming-concepts.md)。 ## 备份与恢复 -TiDB Cloud 提供自动化备份方案和时间点恢复（PITR）能力。[了解更多备份与恢复相关内容](/tidb-cloud/backup-and-restore-concepts.md)。 +TiDB Cloud 提供自动化备份方案和时间点恢复（PITR）能力。[了解更多备份与恢复](/tidb-cloud/backup-and-restore-concepts.md)。 ## 安全 -TiDB Cloud 提供强大且灵活的安全框架，旨在保护数据、实施访问控制，并满足现代合规标准。[了解更多安全相关内容](/tidb-cloud/security-concepts.md)。 \ No newline at end of file +TiDB Cloud 提供强大且灵活的安全框架，用于保护数据、实施访问控制，并满足现代合规标准。[了解更多安全](/tidb-cloud/security-concepts.md)。 \ No newline at end of file diff --git a/tidb-cloud/limitations-and-quotas.md b/tidb-cloud/limitations-and-quotas.md index 8f73d279d54df..41bde1d20aafd 100644 --- a/tidb-cloud/limitations-and-quotas.md +++ b/tidb-cloud/limitations-and-quotas.md @@ -1,35 +1,36 @@ --- -title: TiDB Cloud Dedicated 限制和配额 -summary: 了解 TiDB Cloud 中的限制和配额。 +title: TiDB Cloud Dedicated 限制与配额 +summary: 了解 TiDB Cloud 中的限制与配额。 --- -# TiDB Cloud Dedicated 限制和配额 +# TiDB Cloud Dedicated 限制与配额 -TiDB Cloud 限制了你在 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群中可以创建的每种组件的数量，以及 TiDB 的常见使用限制。此外，还有一些组织级别的配额来限制用户创建的资源数量，以防创建超出实际需要的资源。这些表格概述了限制和配额。 +TiDB Cloud 会限制你在一个 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群中可以创建的各类组件数量，以及 TiDB 的常见使用限制。此外，还存在一些组织级别的配额，用于限制用户创建的资源总量，以防止你创建超过实际需求的资源。下表列出了相关的限制与配额。 > **注意：** > -> 如果这些限制或配额中的任何一个对你的组织造成问题，请联系 [TiDB Cloud 支持团队](/tidb-cloud/tidb-cloud-support.md)。 +> 如果这些限制或配额对你的组织造成困扰，请联系 [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md)。 ## 集群限制 | 组件 | 限制 | |:-|:-| -| 每个[数据 region](/tidb-cloud/tidb-cloud-glossary.md#region) 的副本数量 | 3 | +| 每个 [数据 region](/tidb-cloud/tidb-cloud-glossary.md#region) 的副本数 | 3 | | 跨可用区部署的可用区数量 | 3 | > **注意：** > -> 如果你想了解更多关于 TiDB 的常见使用限制，请参考 [TiDB 限制](https://docs.pingcap.com/tidb/stable/tidb-limitations)。 +> 如果你想了解 TiDB 的常见使用限制，请参考 [TiDB Limitations](https://docs.pingcap.com/tidb/stable/tidb-limitations)。 ## 集群配额 | 组件 | 配额（默认） | |:-|:-| -| 组织中所有集群的 TiDB 节点总数上限 | 10 | -| 组织中所有集群的 TiKV 节点总数上限 | 15 | -| 组织中所有集群的 TiFlash 节点总数上限 | 5 | +| 你所在组织所有集群的 TiDB 节点总数上限 | 10 | +| 你所在组织所有集群的 TiKV 节点总数上限 | 15 | +| 你所在组织所有集群的 TiFlash 节点总数上限 | 5 | +| 你所在组织所有集群的 TiProxy 节点总数上限 | 10 | > **注意：** > -> 如果这些限制或配额中的任何一个对你的组织造成问题，请联系 [TiDB Cloud 支持团队](/tidb-cloud/tidb-cloud-support.md)。 +> 如果这些限制或配额对你的组织造成困扰，请联系 [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md)。 \ No newline at end of file diff --git a/tidb-cloud/monitor-tidb-cluster.md b/tidb-cloud/monitor-tidb-cluster.md index 86abc3d3fda0d..1bf1efb9130c3 100644 --- a/tidb-cloud/monitor-tidb-cluster.md +++ b/tidb-cloud/monitor-tidb-cluster.md @@ -1,30 +1,30 @@ --- title: 监控 TiDB 集群 -summary: 了解如何监控 TiDB 集群。 +summary: 了解如何监控你的 TiDB 集群。 --- # 监控 TiDB 集群 本文档介绍如何在 TiDB Cloud 上监控 TiDB 集群。 -## 集群状态和节点状态 +## 集群状态与节点状态 -你可以在集群页面上查看每个运行中集群的当前状态。 +你可以在集群页面查看每个正在运行的集群的当前状态。 ### 集群状态 | 集群状态 | 描述 | |:--|:--| -| **Available** | 集群运行正常且可用。 | -| **Creating** | 集群正在创建中。在创建过程中集群不可访问。 | +| **Available** | 集群健康且可用。 | +| **Creating** | 集群正在创建中。创建期间集群不可访问。 | | **Importing** | 正在向集群导入数据。 | -| **Maintaining** | 集群正在维护中。 | -| **Modifying** | 集群正在修改中。 | +| **Maintaining** | 集群处于维护中。 | +| **Modifying** | 集群正在被修改。 | | **Unavailable** | 集群发生故障且 TiDB 无法恢复。 | | **Pausing** | 集群正在暂停中。 | | **Paused** | 集群已暂停。 | | **Resuming** | 集群正在从暂停状态恢复。 | -| **Restoring** | 集群当前正在从备份中恢复。 | +| **Restoring** | 集群正在从备份恢复。 | ### TiDB 节点状态 @@ -32,12 +32,14 @@ summary: 了解如何监控 TiDB 集群。 > > TiDB 节点状态仅适用于 TiDB Cloud Dedicated 集群。 +以 `tidb` 开头的节点名称为 TiDB 节点，以 `tiproxy` 开头的为 TiProxy 节点。 + | TiDB 节点状态 | 描述 | |:--|:--| -| **Available** | TiDB 节点运行正常且可用。 | +| **Available** | TiDB 节点健康且可用。 | | **Creating** | TiDB 节点正在创建中。 | | **Unavailable** | TiDB 节点不可用。 | -| **Deleting** | TiDB 节点正在删除中。 | +| **Deleting** | TiDB 节点正在被删除。 | ### TiKV 节点状态 @@ -47,44 +49,44 @@ summary: 了解如何监控 TiDB 集群。 | TiKV 节点状态 | 描述 | |:--|:--| -| **Available** | TiKV 节点运行正常且可用。 | +| **Available** | TiKV 节点健康且可用。 | | **Creating** | TiKV 节点正在创建中。 | | **Unavailable** | TiKV 节点不可用。 | -| **Deleting** | TiKV 节点正在删除中。 | +| **Deleting** | TiKV 节点正在被删除。 | -## 监控指标 +## 监控统计/指标（信息） -在 TiDB Cloud 中，你可以从以下页面查看集群的常用指标： +在 TiDB Cloud 中，你可以通过以下页面查看集群的常用统计/指标（信息）： -- **概览**页面 -- **指标**页面 +- **Overview** 页面 +- **Metrics** 页面 -### 概览页面 +### Overview 页面 -**概览**页面提供集群的常规指标。 +**Overview** 页面提供集群的常规统计/指标（信息）。 -要在集群概览页面查看指标，请执行以下步骤： +要在集群 Overview 页面查看统计/指标（信息），请按照以下步骤操作： -1. 在项目的[**集群**](https://tidbcloud.com/project/clusters)页面，点击目标集群的名称以进入其概览页面。 +1. 在项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，点击目标集群名称，进入其 Overview 页面。 > **提示：** > > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 -2. 查看**核心指标**部分。 +2. 查看 **Core Metrics** 部分。 -### 指标页面 +### Metrics 页面 -**指标**页面提供集群的完整指标集。通过查看这些指标，你可以轻松识别性能问题并确定当前的数据库部署是否满足你的需求。 +**Metrics** 页面提供集群的全量统计/指标（信息）。通过查看这些统计/指标（信息），你可以轻松识别性能问题，并判断当前数据库部署是否满足你的需求。 -要在**指标**页面查看指标，请执行以下步骤： +要在 **Metrics** 页面查看统计/指标（信息），请按照以下步骤操作： -1. 在项目的[**集群**](https://tidbcloud.com/project/clusters)页面，点击目标集群的名称以进入其概览页面。 +1. 在项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，点击目标集群名称，进入其 Overview 页面。 > **提示：** > > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 -2. 在左侧导航栏中，点击**监控** > **指标**。 +2. 在左侧导航栏，点击 **Monitoring** > **Metrics**。 -更多信息，请参见 [TiDB Cloud 内置指标](/tidb-cloud/built-in-monitoring.md)。 +更多信息，参见 [TiDB Cloud Built-in Metrics](/tidb-cloud/built-in-monitoring.md)。 \ No newline at end of file diff --git a/tidb-cloud/serverless-high-availability.md b/tidb-cloud/serverless-high-availability.md index f3580bc3f1fbe..d524297069389 100644 --- a/tidb-cloud/serverless-high-availability.md +++ b/tidb-cloud/serverless-high-availability.md @@ -1,38 +1,57 @@ --- -title: TiDB Cloud Starter 和 Essential 的高可用性 -summary: 了解 TiDB Cloud Starter 和 Essential 的高可用性架构。探索可用区级和区域级高可用性选项、自动备份、故障转移流程，以及 TiDB 如何确保数据持久性和业务连续性。 +title: TiDB Cloud 的高可用 +summary: 了解 TiDB Cloud 的高可用架构。探索分区高可用和区域高可用选项、自动备份、故障转移流程，以及 TiDB 如何确保数据持久性和业务可持续性。 --- -# TiDB Cloud Starter 和 Essential 的高可用性 +# TiDB Cloud 的高可用 -TiDB Cloud 通过强大的机制默认实现高可用性和数据持久性，防止单点故障，并确保即使在发生中断时也能持续提供服务。作为基于经过实战考验的 TiDB 开源产品的全托管服务，TiDB Cloud 继承了 TiDB 的核心高可用（HA）特性，并结合了额外的云原生能力。 +TiDB Cloud 通过强大的机制，默认保持高可用和数据持久性，防止单点故障，并确保即使在发生中断时也能持续提供服务。作为基于经过实战检验的 TiDB 开源产品的全托管服务，TiDB Cloud 继承了 TiDB 的核心高可用（HA）特性，并结合了额外的云原生能力。 + +> **注意：** +> +> - 本文档仅适用于 TiDB Cloud Starter 和 TiDB Cloud EssentialTiDB Cloud Starter、TiDB Cloud Essential 和 TiDB Cloud Premium。 +> - 关于 TiDB Cloud Dedicated 的高可用，请参见 [TiDB Cloud Dedicated 的高可用](/tidb-cloud/high-availability-with-multi-az.md)。 ## 概述 -TiDB 通过 Raft 一致性算法实现高可用性和数据持久性。该算法能够在多个节点间一致地复制数据变更，使 TiDB 即使在节点故障或网络分区的情况下也能处理读写请求。这种方式同时提供了高数据持久性和容错能力。 +TiDB 通过 Raft 一致性算法确保高可用和数据持久性。该算法会持续地在多个节点间复制数据变更，使 TiDB 即使在节点故障或网络分区时也能处理读写请求。这种方式同时提供了高数据持久性和容错能力。 + +TiDB Cloud 进一步扩展了这些能力，提供分区高可用和区域高可用，以满足不同的运维需求。 -TiDB Cloud 通过可用区级高可用性和区域级高可用性扩展了这些能力，以满足不同的运维需求。 + > **注意：** > -> - 对于 TiDB Cloud Starter 集群，仅启用可用区级高可用性，且不可配置。 -> - 对于部署在 AWS 东京（ap-northeast-1）区域或任意阿里云区域的 TiDB Cloud Essential 集群，默认启用区域级高可用性。你可以在集群创建时根据需要切换为可用区级高可用性。对于部署在其他区域的 TiDB Cloud Essential 集群，仅启用可用区级高可用性，且不可配置。 +> - 对于 TiDB Cloud Starter 集群，仅启用分区高可用，且不可配置。 +> - 对于部署在 AWS 东京（ap-northeast-1）Region 或任意阿里云 Region 的 TiDB Cloud Essential 集群，默认启用区域高可用。你可以在集群创建时根据需要切换为分区高可用。对于部署在其他 Region 的 TiDB Cloud Essential 集群，仅启用分区高可用，且不可配置。 -- **可用区级高可用性**：该选项将所有节点部署在同一个可用区内，从而降低网络延迟。它无需应用层跨区冗余即可实现高可用性，适用于优先考虑单区低延迟的应用。详细信息参见 [可用区级高可用性架构](#zonal-high-availability-architecture)。 + -- **区域级高可用性（测试版）**：该选项将节点分布在多个可用区，实现最大程度的基础设施隔离和冗余。它提供最高级别的可用性，但需要应用层实现跨区冗余。如果你需要最大程度防护可用区级基础设施故障，建议选择该选项。需要注意的是，该选项会增加延迟，并可能产生跨区数据传输费用。此功能仅在拥有三个以上可用区的区域可用，且只能在集群创建时启用。详细信息参见 [区域级高可用性架构](#regional-high-availability-architecture)。 + -## 可用区级高可用性架构 +> **注意：** +> +> - 对于 TiDB Cloud Starter 集群，仅启用分区高可用，且不可配置。 +> - 对于 TiDB Cloud Premium 集群，仅启用区域高可用，且不可配置。 +> - 对于部署在 AWS 东京（ap-northeast-1）Region 或任意阿里云 Region 的 TiDB Cloud Essential 集群，默认启用区域高可用。你可以在集群创建时根据需要切换为分区高可用。对于部署在其他 Region 的 TiDB Cloud Essential 集群，仅启用分区高可用，且不可配置。 -当你以默认的可用区级高可用性创建集群时，所有组件，包括 Gateway、TiDB、TiKV 和 TiFlash 计算/写入节点，均运行在同一个可用区内。这些组件在数据平面上的部署通过虚拟机池实现基础设施冗余，从而最大程度减少故障转移时间和由于同区部署带来的网络延迟。 + + +- **分区高可用**：该选项将所有节点部署在同一个可用区内，降低网络延时。它无需应用层跨区冗余即可实现高可用，适用于优先考虑单区低延时的应用。详细信息参见 [分区高可用架构](#zonal-high-availability-architecture)。 + +- **区域高可用（beta）**：该选项将节点分布在多个可用区，实现最大程度的基础设施隔离和冗余。它提供最高级别的可用性，但需要应用层实现跨区冗余。如果你需要最大程度防护单区基础设施故障，建议选择该选项。需要注意的是，该选项会增加延时，并可能产生跨区数据传输费用。此功能仅在拥有三个以上可用区的 Region 可用，且只能在集群创建时启用。详细信息参见 [区域高可用架构](#regional-high-availability-architecture)。 + +## 分区高可用架构 + +当你以默认的分区高可用创建集群时，所有组件（包括 Gateway、TiDB、TiKV 和 TiFlash 计算/写入节点）均运行在同一个可用区内。数据面组件的部署通过虚拟机池提供基础设施冗余，从而最大程度减少故障转移时间和因同地部署带来的网络延时。 -- 下图展示了 AWS 上的可用区级高可用性架构： +- 下图展示了 AWS 上分区高可用的架构： ![zonal high availability on AWS](/media/tidb-cloud/zonal-high-avaliability-aws.png) -- 下图展示了阿里云上的可用区级高可用性架构： +- 下图展示了阿里云上分区高可用的架构： ![zonal high availability on Alibaba Cloud](/media/tidb-cloud/zonal-high-avaliability-alibaba-cloud.png) @@ -40,17 +59,17 @@ TiDB Cloud 通过可用区级高可用性和区域级高可用性扩展了这些 -The following diagram shows the architecture of zonal high availability on AWS: +下图展示了 AWS 上分区高可用的架构： ![zonal high availability on AWS](/media/tidb-cloud/zonal-high-avaliability-aws.png) -在可用区级高可用性架构中： +在分区高可用架构下： -- Placement Driver（PD）跨多个可用区部署，通过跨区冗余复制数据以确保高可用性。 -- 数据在本地可用区内的 TiKV 服务器和 TiFlash 写入节点之间进行复制。 -- TiDB 服务器和 TiFlash 计算节点从 TiKV 和 TiFlash 写入节点进行读写，这些节点通过存储级别的复制机制得到保护。 +- Placement Driver（PD）跨多个可用区部署，通过跨区冗余复制数据以确保高可用。 +- 数据在本地可用区内的 TiKV 服务器和 TiFlash 写入节点间复制。 +- TiDB 服务器和 TiFlash 计算节点从 TiKV 和 TiFlash 写入节点读写数据，这些节点通过存储级别复制机制保障数据安全。 ### 故障转移流程 @@ -58,41 +77,41 @@ TiDB Cloud 为你的应用确保透明的故障转移流程。在故障转移期 -- 会创建一个新的副本来替换故障副本。 +- 会创建一个新的副本以替换故障副本。 - 提供存储服务的服务器会从 Amazon S3 或阿里云 OSS（取决于你的云服务商）持久化的数据中恢复本地缓存，将系统恢复到与副本一致的状态。 -在存储层，持久化数据会定期推送到 Amazon S3 或阿里云 OSS（取决于你的云服务商），以实现高持久性。此外，最新的数据变更不仅会在多个 TiKV 服务器间复制，还会存储在每台服务器的 EBS 上，EBS 进一步复制数据以增强持久性。TiDB 会自动在毫秒级别进行退避和重试，从而确保故障转移过程对客户端应用无缝。 +在存储层，持久化数据会定期推送到 Amazon S3 或阿里云 OSS（取决于你的云服务商），以实现高持久性。此外，最新的修改不仅会在多个 TiKV 服务器间复制，还会存储在每台服务器的 EBS 上，EBS 进一步复制数据以增强持久性。TiDB 会自动在毫秒级别进行退避和重试，确保故障转移过程对客户端应用无感知。 -- A new replica is created to replace the failed one. +- 会创建一个新的副本以替换故障副本。 -- Servers providing storage services recover local caches from persisted data on Amazon S3 (depending on your cloud provider), restoring the system to a consistent state with the replicas. +- 提供存储服务的服务器会从 Amazon S3（取决于你的云服务商）持久化的数据中恢复本地缓存，将系统恢复到与副本一致的状态。 -In the storage layer, persisted data is regularly pushed to Amazon S3 for high durability. Moreover, immediate updates are not only replicated across multiple TiKV servers but also stored on the EBS of each server, which further replicates the data for additional durability. TiDB automatically resolves issues by backing off and retrying in milliseconds, ensuring the failover process remains seamless for client applications. +在存储层，持久化数据会定期推送到 Amazon S3，以实现高持久性。此外，最新的修改不仅会在多个 TiKV 服务器间复制，还会存储在每台服务器的 EBS 上，EBS 进一步复制数据以增强持久性。TiDB 会自动在毫秒级别进行退避和重试，确保故障转移过程对客户端应用无感知。 -Gateway 和计算层为无状态组件，因此故障转移时会立即在其他位置重启。应用应实现连接重试逻辑。虽然可用区级架构提供了高可用性，但无法应对整个可用区的故障。如果可用区不可用，将会发生停机，直到该区及其依赖服务恢复。 +Gateway 和计算层为无状态，因此故障转移时会立即在其他位置重启。应用应实现连接的重试逻辑。虽然分区部署提供了高可用，但无法应对整个可用区的故障。如果可用区不可用，将会发生停机，直到该区及其依赖服务恢复。 -## 区域级高可用性架构 +## 区域高可用架构 -当你以区域级高可用性创建集群时，关键的 OLTP（联机事务处理）工作负载组件，如 PD 和 TiKV，会跨多个可用区部署，以确保冗余复制并最大化可用性。在正常运行期间，Gateway、TiDB 和 TiFlash 计算/写入节点等组件会部署在主可用区。这些数据平面组件通过虚拟机池实现基础设施冗余，从而最大程度减少故障转移时间和由于同区部署带来的网络延迟。 +当你以区域高可用创建集群时，关键 OLTP（联机事务处理）工作负载组件（如 PD 和 TiKV）会跨多个可用区部署，以确保冗余复制并最大化可用性。在正常运行期间，Gateway、TiDB 和 TiFlash 计算/写入节点等组件部署在主可用区。数据面组件通过虚拟机池提供基础设施冗余，从而最大程度减少故障转移时间和因同地部署带来的网络延时。 > **注意：** > -> 区域级高可用性目前为测试版。 +> 区域高可用目前为 beta 版本。 -- 下图展示了 AWS 上的区域级高可用性架构： +- 下图展示了 AWS 上区域高可用的架构： ![regional high availability on AWS](/media/tidb-cloud/regional-high-avaliability-aws.png) -- 下图展示了阿里云上的区域级高可用性架构： +- 下图展示了阿里云上区域高可用的架构： ![regional high availability on Alibaba Cloud](/media/tidb-cloud/regional-high-avaliability-alibaba-cloud.png) @@ -100,77 +119,77 @@ Gateway 和计算层为无状态组件，因此故障转移时会立即在其他 -The following diagram shows the architecture of regional high availability on AWS: +下图展示了 AWS 上区域高可用的架构： ![regional high availability](/media/tidb-cloud/regional-high-avaliability-aws.png) -在区域级高可用性架构中： +在区域高可用架构下： - Placement Driver（PD）和 TiKV 跨多个可用区部署，数据始终在各区间冗余复制，以确保最高级别的可用性。 -- 数据在主可用区内的 TiFlash 写入节点之间进行复制。 -- TiDB 服务器和 TiFlash 计算节点从这些 TiKV 和 TiFlash 写入节点进行读写，这些节点通过存储级别的复制机制得到保护。 +- 数据在主可用区内的 TiFlash 写入节点间复制。 +- TiDB 服务器和 TiFlash 计算节点从这些 TiKV 和 TiFlash 写入节点读写数据，这些节点通过存储级别复制机制保障数据安全。 ### 故障转移流程 -在极少数情况下，主可用区发生故障（如自然灾害、配置变更、软件问题或硬件故障），关键的 OLTP 工作负载组件（包括 Gateway 和 TiDB）会自动在备用可用区启动。流量会自动重定向到备用区，以确保快速恢复并保持业务连续性。 +在极少数主可用区故障的场景下（可能由自然灾害、配置变更、软件问题或硬件故障引起），关键 OLTP 工作负载组件（包括 Gateway 和 TiDB）会自动在备用可用区启动。流量会自动重定向到备用区，以确保快速恢复并保持业务可持续性。 -TiDB Cloud 通过以下措施最大程度减少主可用区故障期间的服务中断，并确保业务连续性： +TiDB Cloud 通过以下措施，最大程度减少主可用区故障期间的服务中断并保障业务可持续性： -- 在备用可用区自动创建 Gateway 和 TiDB 的新副本。 +- 自动在备用可用区创建新的 Gateway 和 TiDB 副本。 - 通过弹性负载均衡器检测备用可用区的活跃 Gateway 副本，并将 OLTP 流量从故障主区重定向到备用区。 -除了通过 TiKV 复制实现高可用性外，TiKV 实例还会部署并配置为将每个数据副本放置在不同的可用区。只要有两个可用区正常运行，系统就能保持可用性。为实现高持久性，数据会定期备份到 S3。即使两个可用区同时故障，存储在 S3 上的数据依然可访问和恢复。 +除了通过 TiKV 复制提供高可用外，TiKV 实例还会部署并配置为将每个数据副本放置在不同的可用区。只要有两个可用区正常运行，系统就能保持可用。为实现高持久性，数据会定期备份到 S3。即使两个可用区同时故障，存储在 S3 上的数据依然可访问和恢复。 应用不会受到非主可用区故障的影响，也不会感知到此类事件。在主可用区故障期间，Gateway 和 TiDB 会在备用可用区启动以处理工作负载。请确保你的应用实现重试逻辑，将新请求重定向到备用可用区的活跃服务器。 ## 自动备份与持久性 -数据库备份对于业务连续性和灾难恢复至关重要，有助于防止数据损坏或意外删除。通过备份，你可以在保留期内将数据库恢复到某一时间点，最大程度减少数据丢失和停机时间。 +数据库备份对于业务可持续性和容灾至关重要，有助于防止数据损坏或误删。通过备份，你可以在保留时间内将数据库恢复到指定时间点，最大程度减少数据丢失和停机时间。 -TiDB Cloud 提供了强大的自动化备份机制，确保持续的数据保护： +TiDB Cloud 提供了强大的自动备份机制，确保持续的数据保护： -- **每日全量备份**：每天对数据库进行一次全量备份，捕获整个数据库的状态。 -- **持续事务日志备份**：事务日志会持续备份，大约每 5 分钟一次，具体频率取决于数据库活动量。 +- **每日全量备份**：每天对数据库进行一次全量备份，捕获整个数据库状态。 +- **持续事务日志备份**：事务日志会持续备份，约每 5 分钟一次，具体频率取决于数据库活动量。 -这些自动化备份使你可以通过全量备份或结合全量备份与持续事务日志，将数据库恢复到某一特定时间点。这种灵活性确保你能够将数据库恢复到事故发生前的精确时间点。 +这些自动备份使你可以通过全量备份或结合全量备份与持续事务日志，将数据库恢复到任意指定时间点。这种灵活性确保你能将数据库恢复到事故发生前的精确时刻。 > **注意：** > -> 自动备份（包括基于快照的备份和用于时间点恢复（PITR）的持续备份）会在 Amazon S3 或阿里云 OSS（取决于你的云服务商）上执行，具备区域级高持久性。 +> 自动备份（包括基于快照的备份和用于时间点恢复（PITR）的持续备份）会在 Amazon S3 或阿里云 OSS（取决于你的云服务商）上执行，具备区域级别的高持久性。 -> **Note:** +> **注意：** > -> Automatic backups, including snapshot-based and continuous backups for Point-in-Time Recovery (PITR), are performed on Amazon S3, which provides regional-level high durability. +> 自动备份（包括基于快照的备份和用于时间点恢复（PITR）的持续备份）会在 Amazon S3 上执行，具备区域级别的高持久性。 ## 故障期间对会话的影响 -在发生故障时，故障服务器上的进行中事务可能会被中断。虽然故障转移对应用是透明的，但你必须实现逻辑以处理活动事务中的可恢复故障。不同故障场景的处理方式如下： +在故障发生时，正在故障服务器上运行的事务可能会被中断。虽然故障转移对应用是透明的，但你必须实现逻辑以处理活跃事务期间的可恢复故障。不同故障场景的处理方式如下： -- **TiDB 故障**：如果某个 TiDB 实例故障，客户端连接不会受到影响，因为 TiDB Cloud 会自动通过 Gateway 重路由流量。虽然故障 TiDB 实例上的事务可能会被中断，但系统会确保已提交的数据被保留，新事务会由其他可用的 TiDB 实例处理。 -- **Gateway 故障**：如果 Gateway 故障，客户端连接会被中断。但 TiDB Cloud 的 Gateway 是无状态的，可以立即在新的可用区或服务器上重启。流量会自动重定向到新的 Gateway，最大程度减少停机时间。 +- **TiDB 故障**：如果 TiDB 实例故障，客户端连接不会受影响，因为 TiDB Cloud 会自动通过 Gateway 重定向流量。虽然在故障 TiDB 实例上的事务可能会中断，但系统会确保已提交的数据被保留，新事务会由其他可用 TiDB 实例处理。 +- **Gateway 故障**：如果 Gateway 故障，客户端连接会被中断。但 TiDB Cloud 的 Gateway 为无状态，可以立即在新的可用区或服务器上重启。流量会自动重定向到新的 Gateway，最大程度减少停机时间。 -建议你的应用实现重试逻辑以处理可恢复故障。具体实现细节请参考你的驱动或 ORM 文档（例如 [JDBC](https://dev.mysql.com/doc/connector-j/en/connector-j-config-failover.html)）。 +建议你在应用中实现重试逻辑以处理可恢复故障。具体实现细节请参考你的驱动或 ORM 文档（例如 [JDBC](https://dev.mysql.com/doc/connector-j/en/connector-j-config-failover.html)）。 ## RTO 和 RPO -在制定业务连续性计划时，请考虑以下两个关键指标： +在制定业务可持续性计划时，请考虑以下两个关键指标： - 恢复时间目标（RTO）：应用在发生中断事件后完全恢复所能接受的最长时间。 -- 恢复点目标（RPO）：在从非计划中断事件中恢复时，应用可容忍丢失的最近数据更新的最长时间间隔。 +- 恢复点目标（RPO）：应用在从非计划中断事件恢复时，所能容忍的最近数据更新的最长时间间隔。 -下表对比了每种高可用性选项的 RTO 和 RPO： +下表对比了每种高可用选项的 RTO 和 RPO： -| 高可用性架构 | RTO（停机时间） | RPO（数据丢失） | -|------------------------|--------------------------|-----------------| -| 可用区级高可用性 | 近 0 秒 | 0 | -| 区域级高可用性 | 通常小于 600 秒 | 0 | \ No newline at end of file +| 高可用架构 | RTO（停机时间） | RPO（数据丢失） | +|--------------------------------|-------------------------------|-----------------| +| 分区高可用 | 近 0 秒 | 0 | +| 区域高可用 | 通常小于 600 秒 | 0 | \ No newline at end of file diff --git a/tidb-cloud/serverless-private-link-connection-to-aws-confluent.md b/tidb-cloud/serverless-private-link-connection-to-aws-confluent.md new file mode 100644 index 0000000000000..dbaa2742e9e99 --- /dev/null +++ b/tidb-cloud/serverless-private-link-connection-to-aws-confluent.md @@ -0,0 +1,74 @@ +--- +title: 通过 Private Link 连接在 AWS 上连接 Confluent Cloud +summary: 了解如何使用 AWS Endpoint Service private link 连接，在 AWS 上连接到 Confluent Cloud Dedicated 集群。 +--- + +# 通过 Private Link 连接在 AWS 上连接 Confluent Cloud + +本文档介绍如何通过 [AWS Endpoint Service private link 连接](/tidb-cloud/serverless-private-link-connection.md)，将 TiDB Cloud Essential 集群连接到 [Confluent Cloud Dedicated 集群](https://docs.confluent.io/cloud/current/clusters/cluster-types.html)（部署在 AWS 上）。 + +> **注意** +> +> 在 AWS 上的所有 Confluent Cloud 集群类型中，只有 Confluent Cloud Dedicated 集群支持 private link 连接。 + +## 前提条件 + +- 你拥有一个 [Confluent Cloud](https://confluent.cloud/) 账户。 + +- 你的 TiDB Cloud Essential 托管在 AWS 上，并且处于活跃状态。请提前获取并保存以下信息： + + - AWS 账户 ID + - 可用区（AZ） + +要查看 AWS 账户 ID 和可用区，请执行以下操作： + +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com)中，进入 TiDB 集群的集群总览页面，然后点击左侧导航栏的 **Settings** > **Networking**。 +2. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection**。 +3. 在弹出的对话框中，你可以找到 AWS 账户 ID 和可用区信息。 + +## 步骤 1. 设置 Confluent Cloud 网络 + +确定你要使用的 Confluent Cloud 网络，或[在 AWS 上创建新的 Confluent Cloud 网络](https://docs.confluent.io/cloud/current/networking/ccloud-network/aws.html#create-ccloud-network-aws)。 + +Confluent Cloud 网络需满足以下要求： + +- 类型：网络必须为 **PrivateLink** 网络。 +- Region 匹配：网络必须与 TiDB Cloud Essential 集群位于同一 AWS Region。 +- 可用区（AZ）可用性：网络的可用区需与 TiDB Cloud Essential 集群的可用区有重叠。 + +要获取 Confluent Cloud 网络的唯一名称，请执行以下步骤： + +1. 在 [Confluent Cloud 控制台](https://confluent.cloud/)中，进入 [**Environments**](https://confluent.cloud/environments) 页面，然后点击你的 Confluent Cloud 网络所在的 environment。 +2. 点击 **Network management** 并选择 **For dedicated clusters**，找到你创建的网络。 +3. 进入 **Network overview** 页面，获取 Confluent Cloud 网络的 DNS 子域名。 +4. 从 DNS 子域名中提取 Confluent Cloud 网络的唯一名称。例如，如果 DNS 子域名为 `use1-az1.domnprzqrog.us-east-1.aws.confluent.cloud`，则唯一名称为 `domnprzqrog.us-east-1`。 +5. 保存该唯一名称，后续步骤会用到。 + +## 步骤 2. 为网络添加 PrivateLink Access + +为你在 [步骤 1](#step-1-set-up-a-confluent-cloud-network) 中确定或设置的网络添加 PrivateLink Access。详细信息可参考 [在 Confluent Cloud 中添加 PrivateLink Access](https://docs.confluent.io/cloud/current/networking/private-links/aws-privatelink.html#add-a-privatelink-access-in-ccloud)。 + +在此过程中，你需要： + +- 提供在 [前提条件](#prerequisites) 中获取的 TiDB Cloud AWS 账户 ID。 +- 保存 Confluent Cloud 提供的 `VPC Service Endpoint`，以备后续使用，通常格式为 `com.amazonaws.vpce..vpce-svc-xxxxxxxxxxxxxxxxx`。 + +## 步骤 3. 在该网络下创建 Confluent Cloud Dedicated 集群 + +在你于 [步骤 1](#step-1-set-up-a-confluent-cloud-network) 设置的现有网络下，创建 Confluent Cloud Dedicated 集群。详细信息可参考 [在 Confluent Cloud 中创建 dedicated 集群](https://docs.confluent.io/cloud/current/clusters/create-cluster.html#create-ak-clusters)。 + +## 步骤 4. 在 TiDB Cloud 中创建 private link 连接 + +要在 TiDB Cloud 中创建 private link 连接，请执行以下操作： + +1. 使用 Confluent Cloud 提供的 `VPC Service Endpoint`，在 TiDB Cloud 中创建 private link 连接。 + + 详细信息可参考 [创建 AWS Endpoint Service private link 连接](/tidb-cloud/serverless-private-link-connection.md#create-an-aws-endpoint-service-private-link-connection)。 + + > **注意：** + > + > 对于部署在 AWS 上的 Confluent Cloud Dedicated 集群，你无需在 AWS 控制台的 endpoint service 详情页手动接受来自 TiDB Cloud 的 endpoint 连接请求。Confluent Cloud 会自动处理该请求。 + +2. 将 Confluent Cloud 的服务域名附加到 private link 连接，以便 TiDB Cloud 的数据流服务可以访问 Confluent 集群。 + + 详细信息可参考 [将域名附加到 private link 连接](/tidb-cloud/serverless-private-link-connection.md#attach-domains-to-a-private-link-connection)。 \ No newline at end of file diff --git a/tidb-cloud/serverless-private-link-connection.md b/tidb-cloud/serverless-private-link-connection.md new file mode 100644 index 0000000000000..dc19b88ec49d4 --- /dev/null +++ b/tidb-cloud/serverless-private-link-connection.md @@ -0,0 +1,289 @@ +--- +title: Dataflow 的私有链路连接 +summary: 了解如何为 Dataflow 设置私有链路连接。 +--- + +# Dataflow 的私有链路连接 + +TiDB Cloud 中的数据流服务（如 Changefeed 和 Data Migration (DM)）需要与外部资源（如 RDS 实例和 Kafka 集群）建立可靠的连接。虽然支持公网端点，但私有链路连接提供了更优的选择，具有效率更高、延时更低和安全性更强的优势。 + +私有链路连接能够在 TiDB Cloud Essential 与你的目标资源之间建立直接连接。这确保了从 TiDB Cloud 到你在其他云平台上的数据库的数据始终在私有网络边界内传输，大幅降低了网络攻击面，并为关键数据流工作负载提供了稳定的吞吐。 + +## 私有链路连接类型 + +Dataflow 的私有链路连接有多种类型，具体取决于云服务商和你要访问的服务。每种类型都能在你的 TiDB Cloud 集群与同一云环境中的外部资源（如 RDS 或 Kafka）之间实现安全、私有的网络访问。 + +### AWS Endpoint Service + +此类型的私有链路连接允许部署在 **AWS** 上的 TiDB Cloud 集群连接到你基于 AWS PrivateLink 的 [AWS endpoint service](https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html)。 + +通过将 AWS 各类服务（如 RDS 实例和 Kafka 服务）与 endpoint service 关联，私有链路连接即可访问这些服务。 + +### 阿里云 Endpoint Service + +此类型的私有链路连接允许部署在 **阿里云** 上的 TiDB Cloud 集群连接到你基于阿里云 PrivateLink 的 [阿里云 endpoint service](https://www.alibabacloud.com/help/en/privatelink/share-your-service/#51976edba8no7)。 + +通过将阿里云各类服务（如 RDS 实例和 Kafka 服务）与 endpoint service 关联，私有链路连接即可访问这些服务。 + +## 创建 AWS Endpoint Service 私有链路连接 + +你可以通过 TiDB Cloud 控制台或 TiDB Cloud CLI 创建 AWS Endpoint Service 私有链路连接。 + +请确保 AWS endpoint service： + +- 与你的 TiDB Cloud 集群处于同一区域。 +- 将 TiDB Cloud 账户 ID 添加到 **Allowed principals** 列表。 +- 拥有与你的 TiDB Cloud 集群重叠的可用区。 + +你可以在 **Create Private Link Connection** 对话框底部获取账户 ID 和可用区信息，或通过以下命令获取： + +```shell +ticloud serverless private-link-connection zones --cluster-id +``` + + +
+ +1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，进入你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。 + + > **提示：** + > + > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 + +2. 点击目标集群名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 + +3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection**。 + +4. 在 **Create Private Link Connection** 对话框中，填写所需信息： + + - **Private Link Connection Name**：输入私有链路连接的名称。 + - **Connection Type**：选择 **AWS Endpoint Service**。如果未显示该选项，请确保你的集群部署在 AWS 上。 + - **Endpoint Service Name**：输入你的 AWS endpoint service 名称，例如 `com.amazonaws.vpce..vpce-svc-xxxxxxxxxxxxxxxxx`。 + +5. 点击 **Create**。 + +6. 前往 [AWS 控制台](https://console.aws.amazon.com) 的 endpoint service 详情页，在 **Endpoint Connections** 标签页中，接受来自 TiDB Cloud 的 endpoint connection 请求。 + +
+ +
+ +通过 TiDB Cloud CLI 创建私有链路连接： + +1. 执行以下命令： + + ```shell + ticloud serverless private-link-connection create -c --display-name --type AWS_ENDPOINT_SERVICE --aws.endpoint-service-name + ``` + +2. 前往 [AWS 控制台](https://console.aws.amazon.com) 的 endpoint service 详情页，在 **Endpoint Connections** 标签页中，接受来自 TiDB Cloud 的 endpoint connection 请求。 + +
+ + +## 创建阿里云 Endpoint Service 私有链路连接 + +你可以通过 TiDB Cloud 控制台或 TiDB Cloud CLI 创建阿里云 Endpoint Service 私有链路连接。 + +请确保阿里云 endpoint service： + +- 与你的 TiDB Cloud 集群处于同一区域。 +- 将 TiDB Cloud 账户 ID 添加到 **Service Whitelist**。 +- 拥有与你的 TiDB Cloud 集群重叠的可用区。 + +你可以在 **Create Private Link Connection** 对话框底部获取账户 ID 和可用区信息，或通过以下命令获取： + +```shell +ticloud serverless private-link-connection zones --cluster-id +``` + + +
+ +1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，进入你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。 + + > **提示：** + > + > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 + +2. 点击目标集群名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 + +3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection**。 + +4. 在 **Create Private Link Connection** 对话框中，填写所需信息： + + - **Private Link Connection Name**：输入私有链路连接的名称。 + - **Connection Type**：选择 **Alibaba Cloud Endpoint Service**。如果未显示该选项，请确保你的集群部署在阿里云上。 + - **Endpoint Service Name**：输入阿里云 endpoint service 名称，例如 `com.aliyuncs.privatelink..epsrv-xxxxxxxxxxxxxxxxx`。 + +5. 点击 **Create**。 + +6. 前往 [阿里云控制台](https://console.alibabacloud.com) 的 endpoint service 详情页，在 **Endpoint Connections** 标签页中，允许来自 TiDB Cloud 的 endpoint connection 请求。 + +
+ +
+ +通过 TiDB Cloud CLI 创建私有链路连接： + +1. 执行以下命令： + + ```shell + ticloud serverless private-link-connection create -c --display-name --type ALICLOUD_ENDPOINT_SERVICE --alicloud.endpoint-service-name + ``` + +2. 前往 [阿里云控制台](https://console.alibabacloud.com) 的 endpoint service 详情页，在 **Endpoint Connections** 标签页中，允许来自 TiDB Cloud 的 endpoint connection 请求。 + +
+ + +## 绑定域名到私有链路连接 + +你可以将域名绑定到私有链路连接。当域名被绑定到私有链路连接后，所有来自 TiDB Cloud 数据流服务到该域名的流量都将通过该私有链路连接路由。当你的服务在运行时为 client 提供自定义域名（如 Kafka advertised listeners）时，这一功能非常有用。 + +不同类型的私有链路连接支持绑定不同类型的域名。下表展示了每种私有链路连接类型支持的域名类型。 + +| 私有链路连接类型 | 支持的域名类型 | +|----------------------------------|--------------------------------------------------------| +| AWS Endpoint Service |
  • TiDB Cloud managed (`aws.tidbcloud.com`)
  • Confluent Dedicated (`aws.confluent.cloud`)
| +| 阿里云 Endpoint Service | TiDB Cloud managed (`alicloud.tidbcloud.com`) | + +如果你的域名未包含在此表中，请联系 [TiDB Cloud Support](/tidb-cloud/tidb-cloud-support.md) 申请支持。 + +你可以通过 TiDB Cloud 控制台或 TiDB Cloud CLI 将域名绑定到私有链路连接。 + + +
+ +通过 TiDB Cloud 控制台将域名绑定到私有链路连接，操作如下： + +1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，进入你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。 + + > **提示：** + > + > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 + +2. 点击目标集群名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 + +3. 在 **Private Link Connection For Dataflow** 区域，选择目标私有链路连接，然后点击 **...**。 + +4. 点击 **Attach Domains**。 + +5. 在 **Attach Domains** 对话框中，选择域名类型： + + - **TiDB Cloud Managed**：域名将由 TiDB Cloud 自动生成。点击 **Attach Domains** 确认。 + - **Confluent Cloud**：输入 Confluent Cloud Dedicated 集群提供的唯一名称以生成域名，然后点击 **Attach Domains** 确认。关于如何获取唯一名称，参见 [通过私有链路连接接入 Confluent Cloud](/tidb-cloud/serverless-private-link-connection-to-aws-confluent.md#step-1-set-up-a-confluent-cloud-network)。 + +
+ +
+ +通过 TiDB Cloud CLI 绑定 TiDB Cloud managed 域名，操作如下： + +1. 使用 `dry run` 预览将要绑定的域名。该命令会输出下一步所需的唯一名称。 + + ```shell + ticloud serverless private-link-connection attach-domains -c --private-link-connection-id --type TIDBCLOUD_MANAGED --dry-run + ``` + +2. 使用上一步获得的唯一名称绑定域名。 + + ```shell + ticloud serverless private-link-connection attach-domains -c --private-link-connection-id --type TIDBCLOUD_MANAGED --unique-name + ``` + +如需绑定 Confluent Cloud 域名，执行以下命令： + +```shell +ticloud serverless private-link-connection attach-domains -c --private-link-connection-id --type CONFLUENT --unique-name +``` + +
+ + +## 从私有链路连接解绑域名 + +你可以通过 TiDB Cloud 控制台或 TiDB Cloud CLI 从私有链路连接解绑域名。 + + +
+ +通过 TiDB Cloud 控制台从私有链路连接解绑域名，操作如下： + +1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，进入你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。 + + > **提示：** + > + > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 + +2. 点击目标集群名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 + +3. 在 **Private Link Connection For Dataflow** 区域，选择目标私有链路连接，然后点击 **...**。 + +4. 点击 **Detach Domains**，并确认解绑。 + +
+ +
+ +通过 TiDB Cloud CLI 从私有链路连接解绑域名，操作如下： + +1. 获取私有链路连接详情，查找 `attach-domain-id`： + + ```shell + ticloud serverless private-link-connection get -c --private-link-connection-id + ``` + +2. 根据 `attach-domain-id` 解绑域名： + + ```shell + ticloud serverless private-link-connection detach-domains -c --private-link-connection-id --attach-domain-id + ``` + +
+ + +## 删除私有链路连接 + +你可以通过 TiDB Cloud 控制台或 TiDB Cloud CLI 删除私有链路连接。 + + +
+ +通过 TiDB Cloud 控制台删除私有链路连接，操作如下： + +1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，进入你的项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面。 + + > **提示：** + > + > 你可以使用左上角的下拉框在组织、项目和集群之间切换。 + +2. 点击目标集群名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 + +3. 在 **Private Link Connection For Dataflow** 区域，选择目标私有链路连接，然后点击 **...**。 + +4. 点击 **Delete**，并确认删除。 + +
+ +
+ +如需删除私有链路连接，执行以下命令： + +```shell +ticloud serverless private-link-connection delete -c --private-link-connection-id +``` + +
+ + +## 参见 + +- [通过私有链路连接接入 Confluent Cloud](/tidb-cloud/serverless-private-link-connection-to-aws-confluent.md) + + \ No newline at end of file diff --git a/tidb-cloud/tidb-cloud-clinic.md b/tidb-cloud/tidb-cloud-clinic.md index 9720a9c8b4978..c3bfd65da931b 100644 --- a/tidb-cloud/tidb-cloud-clinic.md +++ b/tidb-cloud/tidb-cloud-clinic.md @@ -1,50 +1,50 @@ --- -title: TiDB Cloud 诊所 -summary: 了解如何使用 TiDB Cloud 诊所进行高级监控和诊断。 +title: TiDB Cloud Clinic +summary: 学习如何使用 TiDB Cloud Clinic 进行高级监控与诊断。 --- -# TiDB Cloud 诊所 +# TiDB Cloud Clinic -TiDB Cloud 诊所在 TiDB Cloud 上提供高级监控和诊断功能，旨在帮助你通过详细分析和可操作的见解，快速识别性能问题、优化数据库并提升整体性能。 +TiDB Cloud Clinic 在 TiDB Cloud 上提供了高级监控和诊断能力，旨在帮助你快速定位性能问题，优化数据库，并通过详细分析和可操作的洞察提升整体性能。 ![tidb-cloud-clinic](/media/tidb-cloud/tidb-cloud-clinic.png) > **注意：** > -> 目前，TiDB Cloud 诊所仅适用于 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群。 +> 目前，TiDB Cloud Clinic 仅适用于 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群。 ## 前提条件 -TiDB Cloud 诊所仅适用于订阅了**企业版**或**高级版**支持计划的组织。 +TiDB Cloud Clinic 仅对订阅了 **Enterprise** 或 **Premium** 支持计划的组织开放。 -## 查看集群页面 +## 查看 Cluster 页面 -要查看**集群**页面，请按照以下步骤操作： +要查看 **Cluster** 页面，请按照以下步骤操作： -1. 登录 [TiDB Cloud 诊所控制台](https://clinic.pingcap.com/)，选择**使用 TiDB 账号继续**进入 TiDB Cloud 登录页面。 +1. 登录 [TiDB Cloud Clinic 控制台](https://clinic.pingcap.com/)，选择 **Continue with TiDB Account** 进入 TiDB Cloud 登录页面。 -2. 从组织列表中选择目标组织。将显示所选项目中的集群。 +2. 在组织列表中，选择你的目标组织。所选项目下的集群会被展示出来。 -3. 点击目标集群的名称。将显示集群概览页面，你可以在此查看集群的详细信息，包括： +3. 点击目标集群的名称。会显示集群概览页面，你可以在此查看集群的详细信息，包括： - - 高级指标 - - 慢查询排行（仅支持 TiDB 版本为 v8.1.1 或更高版本，v7.5.4 或更高版本的集群） - - TopSQL（仅支持 TiDB 版本为 v8.1.1 或更高版本，v7.5.4 或更高版本的集群） - - 基准测试报告 + - 高级统计/指标（信息） + - Top 慢查询（仅当集群的 TiDB 版本为 v8.1.1 或更高，v7.5.4 或更高时支持） + - TopSQL（仅当集群的 TiDB 版本为 v8.1.1 或更高，v7.5.4 或更高时支持） + - Benchmark Report -## 监控高级指标 +## 监控高级统计/指标（信息） -TiDB Cloud 诊所使用 Grafana 为 TiDB 集群提供全面的指标集。高级指标的保留策略为 90 天。 +TiDB Cloud Clinic 使用 Grafana 为 TiDB 集群提供全面的统计/指标（信息）集。高级统计/指标（信息）的保留策略为 90 天。 -要查看指标仪表板，请按照以下步骤操作： +要查看统计/指标（信息）面板，请按照以下步骤操作： -1. 在 [TiDB Cloud 诊所控制台](https://clinic.pingcap.com/)中，导航到集群的**集群**页面。 +1. 在 [TiDB Cloud Clinic 控制台](https://clinic.pingcap.com/)中，进入某个集群的 **Cluster** 页面。 -2. 点击**指标**。 +2. 点击 **Metrics**。 -3. 点击你想要查看的仪表板名称。将显示该仪表板。 +3. 点击你想要查看的面板名称，即可显示该面板。 -仪表板及其内容可能会发生变化。目前提供以下仪表板： +面板及其内容可能会发生变化。目前，支持以下面板： - Backup & Import - DM-Professional @@ -56,68 +56,69 @@ TiDB Cloud 诊所使用 Grafana 为 TiDB 集群提供全面的指标集。高级 - TiDB-Resource-Control - TiFlash-Summary - TiKV-Details +- TiProxy-Summary - User-Node-Info -## 分析慢查询排行 +## 分析 Top 慢查询 -默认情况下，执行时间超过 300 毫秒的 SQL 查询被视为慢查询。 +默认情况下，执行时间超过 300 毫秒的 SQL 查询会被视为慢查询。 -在 TiDB Cloud 控制台的默认[**慢查询**](/tidb-cloud/tune-performance.md#slow-query)页面上，特别是在具有大量慢查询的集群中，识别影响性能的查询可能比较困难。TiDB Cloud 诊所中的**慢查询排行**功能基于慢查询日志提供聚合分析。通过此功能，你可以轻松定位存在性能问题的查询，将整体性能调优时间至少减少一半。 +在 TiDB Cloud 控制台默认的 [**Slow Queries**](/tidb-cloud/tune-performance.md#slow-query) 页面中，识别影响性能的查询可能较为困难，尤其是在慢查询数量较多的集群中。TiDB Cloud Clinic 的 **Top 慢查询** 功能基于慢查询日志提供聚合分析。通过该功能，你可以轻松定位存在性能问题的查询，将整体性能调优时间至少缩短一半。 -慢查询排行按 SQL 指纹聚合显示前 10 个查询，并按以下维度排序： +Top 慢查询会按 SQL digest 聚合显示排名前 10 的查询，并按以下维度排序： -- 总延迟 -- 最大延迟 -- 平均延迟 +- 总延时 +- 最大延时 +- 平均延时 - 总内存 - 最大内存 - 平均内存 - 总次数 -要查看集群中的慢查询，请按照以下步骤操作： +要在集群中查看慢查询，请按照以下步骤操作： -1. 在 [TiDB Cloud 诊所控制台](https://clinic.pingcap.com/)中，导航到集群的**集群**页面。 +1. 在 [TiDB Cloud Clinic 控制台](https://clinic.pingcap.com/)中，进入某个集群的 **Cluster** 页面。 -2. 点击**慢查询**。 +2. 点击 **Slow Query**。 -3. 慢查询排行将以表格形式显示。你可以按不同列进行排序。 +3. Top 慢查询会以表格形式展示。你可以按不同列进行排序。 -4. （可选）点击列表中的任何慢查询以查看其详细执行信息。 +4. （可选）点击列表中的任意慢查询，查看其详细执行信息。 -5. （可选）按时间范围、数据库或语句类型筛选慢查询。 +5. （可选）可按时间范围、数据库或语句类型筛选慢查询。 慢查询的保留策略为 7 天。 -更多信息，请参阅 [TiDB Dashboard 中的慢查询](https://docs.pingcap.com/tidb/stable/dashboard-slow-query)。 +更多信息，参见 [TiDB Dashboard 中的 Slow Queries](https://docs.pingcap.com/tidb/stable/dashboard-slow-query)。 ## 监控 TopSQL -TiDB Cloud 诊所提供 TopSQL 信息，使你能够实时监控和可视化探索数据库中每个 SQL 语句的 CPU 开销。这有助于你优化和解决数据库性能问题。 +TiDB Cloud Clinic 提供 TopSQL 信息，使你能够实时监控并可视化分析数据库中每条 SQL 语句的 CPU 开销。这有助于你优化并解决数据库性能问题。 要查看 TopSQL，请按照以下步骤操作： -1. 在 [TiDB Cloud 诊所控制台](https://clinic.pingcap.com/)中，导航到集群的**集群**页面。 +1. 在 [TiDB Cloud Clinic 控制台](https://clinic.pingcap.com/)中，进入某个集群的 **Cluster** 页面。 2. 点击 **TopSQL**。 -3. 选择特定的 TiDB 或 TiKV 实例以观察其负载。你可以使用时间选择器或在图表中选择时间范围来细化分析。 +3. 选择具体的 TiDB 或 TiKV 实例以观察其负载。你可以使用时间选择器或在图表中选择时间范围以细化分析。 -4. 分析 TopSQL 显示的图表和表格。 +4. 分析 TopSQL 展示的图表和表格。 -更多信息，请参阅 [TiDB Dashboard 中的 TopSQL](https://docs.pingcap.com/tidb/stable/top-sql)。 +更多信息，参见 [TiDB Dashboard 中的 TopSQL](https://docs.pingcap.com/tidb/stable/top-sql)。 -## 生成基准测试报告 +## 生成 Benchmark Report -**基准测试报告**功能帮助你在性能测试期间识别 TiDB 集群中的性能问题。完成压力测试后，你可以生成基准测试报告来分析集群的性能。该报告突出显示已识别的瓶颈并提供优化建议。应用这些建议后，你可以运行另一轮压力测试并生成新的基准测试报告以比较性能改进。 +**Benchmark Report** 功能可帮助你在性能测试期间识别 TiDB 集群中的性能问题。完成压力测试后，你可以生成 Benchmark Report 以分析集群性能。报告会突出显示检测到的瓶颈并给出优化建议。应用这些建议后，你可以再次进行压力测试并生成新的 Benchmark Report，以对比性能提升。 -要生成基准测试报告，请按照以下步骤操作： +要生成 Benchmark Report，请按照以下步骤操作： -1. 在 [TiDB Cloud 诊所控制台](https://clinic.pingcap.com/)中，导航到集群的**集群**页面。 +1. 在 [TiDB Cloud Clinic 控制台](https://clinic.pingcap.com/)中，进入某个集群的 **Cluster** 页面。 -2. 点击**基准测试报告**。 +2. 点击 **Benchmark Report**。 -3. 选择要在基准测试报告中分析的时间范围。 +3. 选择要在 Benchmark Report 中分析的时间范围。 -4. 点击**创建报告**以生成基准测试报告。 +4. 点击 **Create Report** 生成 Benchmark Report。 -5. 等待报告生成完成。报告准备就绪后，点击**查看**以打开报告。 +5. 等待报告生成完成。报告准备好后，点击 **View** 打开报告。 \ No newline at end of file diff --git a/tidb-cloud/tidb-cloud-glossary.md b/tidb-cloud/tidb-cloud-glossary.md index 5d7efcd195ab3..1628332be9681 100644 --- a/tidb-cloud/tidb-cloud-glossary.md +++ b/tidb-cloud/tidb-cloud-glossary.md @@ -11,79 +11,79 @@ aliases: ['/tidbcloud/glossary'] ### ACID -ACID 指的是事务的四个关键特性：原子性（atomicity）、一致性（consistency）、隔离性（isolation）和持久性（durability）。每个特性如下所述。 +ACID 指的是事务的四个关键属性：原子性（atomicity）、一致性（consistency）、隔离性（isolation）和持久性（durability）。每个属性的说明如下： -- **Atomicity** 表示一个操作的所有更改要么全部执行，要么全部不执行。TiDB 通过保证存储主键的 [TiDB Region](#region) 的原子性来实现事务的原子性。 +- **原子性** 意味着一个操作的所有更改要么全部执行，要么全部不执行。TiDB 通过保证存储主键的 [TiDB Region](#region) 的原子性来实现事务的原子性。 -- **Consistency** 表示事务总是将数据库从一个一致的状态转变为另一个一致的状态。在 TiDB 中，数据在写入内存前会确保一致性。 +- **一致性** 意味着事务总是将数据库从一个一致的状态带到另一个一致的状态。在 TiDB 中，数据在写入内存前会保证一致性。 -- **Isolation** 表示正在进行的事务对其他事务是不可见的，直到其完成。这允许并发事务在不牺牲一致性的情况下读写数据。TiDB 目前支持 `REPEATABLE READ` 隔离级别。 +- **隔离性** 意味着正在进行的事务对其他事务是不可见的，直到其完成。这允许并发事务在不牺牲一致性的情况下读写数据。TiDB 当前支持 `REPEATABLE READ` 隔离级别。 -- **Durability** 表示一旦事务提交，即使系统发生故障也会保持已提交状态。TiKV 使用持久化存储来保证持久性。 +- **持久性** 意味着一旦事务提交，即使系统发生故障，事务也会保持提交状态。TiKV 使用持久化存储来保证持久性。 ## C ### Chat2Query -Chat2Query 是集成在 SQL 编辑器中的一项 AI 驱动功能，能够帮助用户通过自然语言指令生成、调试或重写 SQL 查询。更多信息，参见 [使用 AI 辅助 SQL 编辑器探索数据](/tidb-cloud/explore-data-with-chat2query.md)。 +Chat2Query 是集成在 SQL Editor 中的 AI 驱动功能，帮助用户通过自然语言指令生成、调试或重写 SQL 查询。更多信息，参见 [Explore your data with AI-assisted SQL Editor](/tidb-cloud/explore-data-with-chat2query.md)。 -此外，TiDB Cloud 为托管在 AWS 上的 TiDB Cloud Starter 集群提供了 Chat2Query API。启用后，TiDB Cloud 会自动创建一个名为 **Chat2Query** 的系统 Data App，并在 Data Service 中创建一个 Chat2Data 端点。你可以调用该端点，通过指令让 AI 生成并执行 SQL 语句。更多信息，参见 [开始使用 Chat2Query API](/tidb-cloud/use-chat2query-api.md)。 +此外，TiDB Cloud 为托管在 AWS 上的 TiDB Cloud Starter 集群提供 Chat2Query API。启用后，TiDB Cloud 会自动创建一个名为 **Chat2Query** 的系统 Data App，并在 Data Service 中创建一个 Chat2Data endpoint。你可以调用该 endpoint，通过指令让 AI 生成并执行 SQL 语句。更多信息，参见 [Get started with Chat2Query API](/tidb-cloud/use-chat2query-api.md)。 ### Credit -TiDB Cloud 为概念验证（PoC）用户提供一定数量的 Credit。一个 Credit 等同于一美元。你可以在 Credit 过期前使用它们支付 TiDB 集群费用。 +TiDB Cloud 为 PoC（概念验证）用户提供一定数量的 credit。1 credit 等同于 1 美元。你可以在 credit 过期前，用 credit 支付 TiDB 集群费用。 ## D ### Data App -[Data Service（测试版）](#data-service) 中的 Data App 是一组端点的集合，你可以用来访问特定应用的数据。你可以通过 API 密钥配置授权设置，以限制对 Data App 中端点的访问。 +[Data Service (beta)](#data-service) 中的 Data App 是一组 endpoint 的集合，你可以用来为特定应用访问数据。你可以通过 API key 配置授权设置，限制对 Data App 中 endpoint 的访问。 -更多信息，参见 [管理 Data App](/tidb-cloud/data-service-manage-data-app.md)。 +更多信息，参见 [Manage a Data App](/tidb-cloud/data-service-manage-data-app.md)。 ### Data Service -Data Service（测试版）允许你通过自定义 API [端点](#endpoint) 使用 HTTPS 请求访问 TiDB Cloud 数据。该功能采用无服务器架构来处理计算资源和弹性扩缩容，因此你可以专注于端点中的查询逻辑，而无需担心基础设施或运维成本。 +Data Service (beta) 允许你通过自定义 API [endpoint](#endpoint) 以 HTTPS 请求方式访问 TiDB Cloud 数据。该功能采用无服务器架构，自动处理计算资源和弹性扩缩容，因此你只需关注 endpoint 中的查询逻辑，无需担心基础设施或运维成本。 -更多信息，参见 [Data Service 概述](/tidb-cloud/data-service-overview.md)。 +更多信息，参见 [Data Service Overview](/tidb-cloud/data-service-overview.md)。 ### Direct Customer -Direct Customer（直客）指的是直接从 PingCAP 购买 TiDB Cloud 并直接支付账单的最终客户。这与 [MSP 客户](#msp-customer) 区分开。 +Direct customer 指直接从 PingCAP 购买 TiDB Cloud 并直接支付账单的最终客户。与 [MSP customer](#msp-customer) 区分。 ## E ### Endpoint -Data Service 中的端点是你可以自定义以执行 SQL 语句的 Web API。你可以为 SQL 语句指定参数，例如 `WHERE` 子句中使用的值。当客户端调用端点并在请求 URL 中提供参数值时，端点会使用这些参数执行相应的 SQL 语句，并将结果作为 HTTP 响应的一部分返回。 +Data Service 中的 endpoint 是你可以自定义的 Web API，用于执行 SQL 语句。你可以为 SQL 语句指定参数，例如 `WHERE` 子句中使用的值。当 client 调用 endpoint 并在请求 URL 中提供参数值时，endpoint 会用这些参数执行相应的 SQL 语句，并将结果作为 HTTP 响应的一部分返回。 -更多信息，参见 [管理端点](/tidb-cloud/data-service-manage-endpoint.md)。 +更多信息，参见 [Manage an endpoint](/tidb-cloud/data-service-manage-endpoint.md)。 ## F ### Full-text search -与关注语义相似度的 [向量检索](/vector-search/vector-search-overview.md) 不同，全文检索允许你根据精确关键词检索文档。在 RAG（Retrieval-Augmented Generation）场景中，你可以将全文检索与向量检索结合使用，以提升检索质量。 +与关注语义相似度的 [Vector Search](/vector-search/vector-search-overview.md) 不同，全文检索允许你通过精确关键字检索文档。在 RAG（Retrieval-Augmented Generation）场景中，你可以将全文检索与向量检索结合使用，以提升检索质量。 -更多信息，参见 [使用 SQL 进行全文检索](/tidb-cloud/vector-search-full-text-search-sql.md) 和 [使用 Python 进行全文检索](/tidb-cloud/vector-search-full-text-search-python.md)。 +更多信息，参见 [Full-Text Search with SQL](/tidb-cloud/vector-search-full-text-search-sql.md) 和 [Full-Text Search with Python](/tidb-cloud/vector-search-full-text-search-python.md)。 ## M ### member -被邀请加入某个组织的用户，拥有访问该组织及其集群的权限。 +被邀请加入 organization 的用户，拥有对该 organization 及其集群的访问权限。 ### MPP -从 v5.0 开始，TiDB 通过 TiFlash 节点引入了大规模并行处理（MPP）架构，将大型 Join 查询的执行负载分摊到多个 TiFlash 节点。当启用 MPP 模式时，TiDB 会根据成本判断是否使用 MPP 框架进行计算。在 MPP 模式下，Join 键会在计算过程中通过 Exchange 操作重新分布，将计算压力分散到每个 TiFlash 节点，从而加速计算。更多信息，参见 [使用 TiFlash MPP 模式](/tiflash/use-tiflash-mpp-mode.md)。 +自 v5.0 起，TiDB 通过 TiFlash 节点引入了大规模并行处理（Massively Parallel Processing, MPP）架构，将大型 join 查询的执行负载分摊到多个 TiFlash 节点。当启用 MPP 模式时，TiDB 会根据成本决定是否使用 MPP framework 进行计算。在 MPP 模式下，join key 会在计算过程中通过 Exchange 操作重新分布，将计算压力分散到每个 TiFlash 节点，从而加速计算。更多信息，参见 [Use TiFlash MPP Mode](/tiflash/use-tiflash-mpp-mode.md)。 ### MSP Customer -MSP 客户（Managed Service Provider Customer）指的是通过 MSP 渠道购买 TiDB Cloud 并通过 MSP 支付账单的最终客户。这与 [直客](#direct-customer) 区分开。 +MSP customer（托管服务提供商客户）指通过 MSP 渠道购买 TiDB Cloud 并支付账单的最终客户。与 [direct customer](#direct-customer) 区分。 ### Managed Service Provider (MSP) -MSP（托管服务提供商）是指转售 TiDB Cloud 并提供增值服务的合作伙伴，包括但不限于 TiDB Cloud 组织管理、计费服务和技术支持。 +托管服务提供商（MSP）是指转售 TiDB Cloud 并提供增值服务的合作伙伴，包括但不限于 TiDB Cloud organization 管理、计费服务和技术支持。 ## N @@ -95,69 +95,74 @@ MSP（托管服务提供商）是指转售 TiDB Cloud 并提供增值服务的 ### organization -你创建的用于管理 TiDB Cloud 账户的实体，包括一个管理账户和任意数量的成员账户。 +你创建的实体，用于管理 TiDB Cloud 账户，包括一个管理账户和任意数量的成员账户。 ### organization members -组织成员是由组织所有者或项目所有者邀请加入组织的用户。组织成员可以查看组织成员，并可被邀请加入组织内的项目。 +organization members 是由 organization owner 或 project owner 邀请加入 organization 的用户。organization members 可以查看 organization 的成员，并可被邀请加入 organization 下的项目。 ## P ### policy -定义适用于角色、用户或组织的权限的文档，例如对特定操作或资源的访问权限。 +定义适用于角色、用户或 organization 的权限的文档，例如对特定操作或资源的访问权限。 ### project -基于组织创建的项目，可以按项目分别管理人员、实例、网络等资源，项目之间的资源互不干扰。 +基于 organization 创建的项目，可以按项目分别管理人员、实例、网络等资源，项目间资源互不干扰。 ### project members -项目成员是被邀请加入组织的一个或多个项目的用户。项目成员可以管理集群、网络访问、备份等资源。 +project members 是被邀请加入 organization 一个或多个项目的用户。project members 可以管理集群、网络访问、备份等资源。 ## R ### Recycle Bin -用于存放已删除且有有效备份的集群数据的地方。一旦已备份的 TiDB Cloud 专属集群被删除，该集群现有的备份文件会被移动到回收站。对于自动备份产生的备份文件，回收站会保留指定时间。你可以在 **备份设置** 中配置备份保留时间，默认是 7 天。对于手动备份产生的备份文件，则没有过期时间。为避免数据丢失，请及时将数据恢复到新集群。注意，如果集群 **没有备份**，则不会在此处显示已删除的集群。 +存放已删除且有有效备份的集群数据的地方。当已备份的 TiDB Cloud Dedicated 集群被删除后，该集群现有的备份文件会被移动到回收站。对于自动备份产生的备份文件，回收站会保留指定时间。你可以在 **Backup Setting** 中配置备份保留时间，默认 7 天。手动备份产生的备份文件则没有过期时间。为避免数据丢失，请及时将数据恢复到新集群。注意，如果集群 **没有备份**，则不会在此处显示已删除集群。 ### region - TiDB Cloud region - 部署 TiDB Cloud 集群的地理区域。一个 TiDB Cloud region 至少包含 3 个可用区，集群会跨这些可用区部署。 + TiDB Cloud 集群部署的地理区域。一个 TiDB Cloud region 至少包含 3 个可用区，集群会跨这些可用区部署。 - TiDB Region - TiDB 中数据的基本单元。TiKV 将 Key-Value 空间划分为一系列连续的 Key 段，每个段称为一个 Region。每个 Region 的默认大小限制为 96 MB，可进行配置。 + TiDB 中数据的基本单元。TiKV 将 Key-Value 空间划分为一系列连续的 Key 段，每个段称为 Region。每个 Region 的默认大小上限为 96 MB，可配置。 ### replica -可以位于同一区域或不同区域的独立数据库，包含相同的数据。副本通常用于灾备或提升性能。 +可以位于同一区域或不同区域的独立数据库，包含相同数据。副本通常用于容灾或提升性能。 ### Replication Capacity Unit (RCU) -TiDB Cloud 以 TiCDC 复制容量单位（RCU）来衡量 [changefeed](/tidb-cloud/changefeed-overview.md) 的容量。为集群创建 changefeed 时，你可以选择合适的规格。RCU 越高，复制性能越好。你需要为这些 TiCDC changefeed RCU 支付费用。更多信息，参见 [Changefeed Cost](https://www.pingcap.com/tidb-dedicated-pricing-details/#changefeed-cost)。 +TiDB Cloud 以 TiCDC Replication Capacity Unit（RCU）衡量 [changefeeds](/tidb-cloud/changefeed-overview.md) 的容量。为集群创建 changefeed 时，你可以选择合适的规格。RCU 越高，复制性能越好。你需要为这些 TiCDC changefeed RCU 付费。更多信息，参见 [Changefeed Cost](https://www.pingcap.com/tidb-dedicated-pricing-details/#changefeed-cost)。 ### Request Capacity Unit (RCU) -Request Capacity Unit（RCU）是用于表示 TiDB Cloud Essential 集群预配置计算能力的单位。一个 RCU 提供固定数量的计算资源，可每秒处理一定数量的 RU。你预配置的 RCU 数量决定了集群的基线性能和吞吐能力。更多信息，参见 [TiDB Cloud Essential 价格详情](https://www.pingcap.com/tidb-cloud-essential-pricing-details/)。 +Request Capacity Unit（RCU）是用于表示 TiDB Cloud Essential 集群预配置计算能力的单位。1 个 RCU 提供固定数量的计算资源，可处理一定数量的 RU 每秒。你预配置的 RCU 数量决定了集群的基线性能和吞吐能力。更多信息，参见 [TiDB Cloud Essential Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/)。 ### Request Unit (RU) -Request Unit（RU）是用于表示单个数据库请求消耗资源量的单位。一个请求消耗的 RU 数量取决于多种因素，例如操作类型或检索/修改的数据量。更多信息，参见 [TiDB Cloud Starter 价格详情](https://www.pingcap.com/tidb-cloud-starter-pricing-details/)。 +对于 TiDB Cloud Starter 和 Essential，Request Unit（RU）是用于表示单个请求消耗资源量的单位。请求消耗的 RU 数量取决于多种因素，如操作类型或检索/修改的数据量。但 TiDB Cloud Starter 和 Essential 的计费模型不同： + +- TiDB Cloud Starter 按消耗的 RU 总数计费。更多信息，参见 [TiDB Cloud Starter Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/)。 +- TiDB Cloud Essential 按预配置的 [Request Capacity Unit (RCU)](#request-capacity-unit-rcu) 数量计费。1 个 RCU 提供固定数量的计算资源，可处理一定数量的 RU 每秒。更多信息，参见 [TiDB Cloud Essential Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/)。 + +对于 TiDB Cloud Dedicated 和 TiDB 自建版，Request Unit（RU）是表示系统资源消耗的抽象单位，目前包括 CPU、IOPS 和 IO 带宽等指标。它被资源控制功能用于限制、隔离和管理数据库请求消耗的资源，**不用于计费**。更多信息，参见 [Use Resource Control to Achieve Resource Group Limitation and Flow Control](/tidb-resource-control-ru-groups.md)。 ## S ### Spending limit -[Spending limit](/tidb-cloud/manage-serverless-spend-limit.md) 指的是你每月愿意为某个工作负载支付的最大金额。它是一种成本控制机制，使你可以为 TiDB Cloud Starter 集群设置预算。如果支出上限设置为 0，集群将保持免费。如果支出上限大于 0，则需要添加信用卡。 +[Spending limit](/tidb-cloud/manage-serverless-spend-limit.md) 指你每月愿意为某个工作负载支付的最大金额。它是一种成本控制机制，使你可以为 TiDB Cloud Starter 集群设置预算。如果 spending limit 设置为 0，集群保持免费；如果大于 0，则需要添加信用卡。 ## T ### TiDB cluster -由 [TiDB](https://docs.pingcap.com/tidb/stable/tidb-computing)、[TiKV](https://docs.pingcap.com/tidb/stable/tidb-storage)、[Placement Driver](https://docs.pingcap.com/tidb/stable/tidb-scheduling)（PD）和 [TiFlash](https://docs.pingcap.com/tidb/stable/tiflash-overview) 节点组成的功能性数据库集群。 +由 [TiDB](https://docs.pingcap.com/tidb/stable/tidb-computing)、[TiKV](https://docs.pingcap.com/tidb/stable/tidb-storage)、[the Placement Driver](https://docs.pingcap.com/tidb/stable/tidb-scheduling)（PD）和 [TiFlash](https://docs.pingcap.com/tidb/stable/tiflash-overview) 节点组成的功能性数据库。 ### TiDB node @@ -165,31 +170,31 @@ Request Unit（RU）是用于表示单个数据库请求消耗资源量的单位 ### TiDB X -一种全新的分布式 SQL 架构，使云原生对象存储成为 TiDB 的核心。通过计算与存储分离，TiDB X 使 TiDB 能够智能扩展，实时适应工作负载模式、业务周期和数据特性。 +一种全新的分布式 SQL 架构，将云原生对象存储作为 TiDB 的核心。通过计算与存储解耦，TiDB X 使 TiDB 能够智能扩展，实时适应工作负载模式、业务周期和数据特性。 TiDB X 架构现已在 TiDB Cloud Starter 和 EssentialTiDB Cloud Starter、Essential 和 Premium 中提供。更多信息，参见 [Introducing TiDB X: A New Foundation for Distributed SQL in the Era of AI](https://www.pingcap.com/blog/introducing-tidb-x-a-new-foundation-distributed-sql-ai-era/) 和 [PingCAP Launches TiDB X and New AI Capabilities at SCaiLE Summit 2025](https://www.pingcap.com/press-release/pingcap-launches-tidb-x-new-ai-capabilities/)。 ### TiFlash node -实时从 TiKV 复制数据并支持实时分析型工作负载的分析型存储节点。 +实时从 TiKV 复制数据并支持实时分析型工作负载的分析存储节点。 ### TiKV node -存储在线事务处理（OLTP）数据的存储节点。以 3 的倍数（如 3、6、9）进行扩容以实现高可用，其中两个节点作为副本。增加 TiKV 节点数量可以提升总吞吐量。 +存储在线事务处理（OLTP）数据的存储节点。以 3 的倍数（如 3、6、9）扩展以实现高可用，其中两个节点作为副本。增加 TiKV 节点数量可以提升总吞吐量。 ### traffic filter -允许通过 SQL 客户端访问 TiDB Cloud 集群的 IP 地址和无类域间路由（CIDR）地址列表。默认情况下，流量过滤器为空。 +允许通过 SQL client 访问 TiDB Cloud 集群的 IP 地址和无类域间路由（CIDR）地址列表。traffic filter 默认为空。 ## V ### Vector search -[向量检索](/vector-search/vector-search-overview.md) 是一种以数据语义为核心的检索方式，能够返回更相关的结果。与依赖精确关键词匹配和词频的传统全文检索不同，向量检索会将多种数据类型（如文本、图片或音频）转换为高维向量，并基于这些向量之间的相似度进行查询。这种检索方式能够捕捉数据的语义和上下文信息，更准确地理解用户意图。即使检索词与数据库内容不完全匹配，向量检索也能通过分析数据语义，返回符合用户意图的结果。 +[Vector search](/vector-search/vector-search-overview.md) 是一种以数据语义为核心、提供相关性结果的检索方法。与依赖精确关键字匹配和词频的传统全文检索不同，vector search 会将多种数据类型（如文本、图片或音频）转换为高维向量，并基于这些向量间的相似度进行查询。该方法能够捕捉数据的语义和上下文信息，更准确理解用户意图。即使检索词与数据库内容不完全匹配，vector search 也能通过分析数据语义，返回符合用户意图的结果。 ### Virtual Private Cloud -逻辑隔离的虚拟网络分区，为你的资源提供托管的网络服务。 +逻辑隔离的虚拟网络分区，为你的资源提供托管网络服务。 ### VPC @@ -201,4 +206,4 @@ Virtual Private Cloud 的缩写。 ### VPC peering connection -两个 Virtual Private Cloud（VPC）之间的网络连接，使你能够通过私有 IP 地址在它们之间路由流量，便于数据传输。 \ No newline at end of file +两个 Virtual Private Cloud（VPC）之间的网络连接，使你可以通过私有 IP 地址在它们之间路由流量，便于数据传输。 \ No newline at end of file diff --git a/tidb-cloud/tidb-cloud-release-notes.md b/tidb-cloud/tidb-cloud-release-notes.md index 8df2bc19e8505..4170c78692b2a 100644 --- a/tidb-cloud/tidb-cloud-release-notes.md +++ b/tidb-cloud/tidb-cloud-release-notes.md @@ -8,17 +8,46 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] 本页面列出了 [TiDB Cloud](https://www.pingcap.com/tidb-cloud/) 在 2025 年的发布说明。 +## 2025 年 12 月 30 日 + +**通用变更** + +- **TiDB Cloud Dedicated** + + - 支持 TiProxy（Beta）。 + + TiProxy 是 PingCAP 官方代理组件，现在已作为 Beta 版本在 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群中提供。它提供了增强的连接管理和负载均衡能力，以提升数据库的可靠性和性能。 + + 亮点： + + - 在扩容操作和滚动升级期间，保持持久的 client 连接。 + - 将流量均匀分配到 TiDB 节点，实现更好的资源利用。 + + 了解更多信息，请参见 [TiProxy 概述](/tidb-cloud/tiproxy-overview-for-cloud.md)。 + +- **TiDB Cloud Essential** + + - 支持变更数据流（changefeeds）（Beta）。 + + 变更数据流功能现已在 [TiDB Cloud 控制台](https://tidbcloud.com) 和 [TiDB Cloud CLI](/tidb-cloud/cli-reference.md) 的 Beta 版本中提供，适用于 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential)。该功能允许你将数据从 TiDB Cloud 流式传输到其他数据服务，目前支持 Apache Kafka 和 MySQL 作为目标端。 + + - 支持为下游资源配置私有链路连接。 + + 私有链路连接现已在 [TiDB Cloud 控制台](https://tidbcloud.com) 和 [TiDB Cloud CLI](/tidb-cloud/cli-reference.md) 中提供，适用于 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential)。该功能允许你在 TiDB Cloud 与下游资源（如 MySQL 和 Apache Kafka）之间建立私有且直接的连接。它专为与变更数据流和其他数据流 service 集成而设计，支持从 TiDB Cloud 向你的基础设施发起连接。 + + 了解更多信息，请参见 [数据流的私有链路连接](/tidb-cloud/serverless-private-link-connection.md)。 + ## 2025 年 12 月 16 日 **通用变更** - **TiDB Cloud Dedicated** - - 支持复制 changefeed。 + - 支持复制变更数据流（changefeeds）。 - 你现在可以在保留关键配置和路由信息的同时，复制现有的 changefeed。该功能可以帮助你快速重建失败的 changefeed，或创建具有相似设置的新 changefeed，从而减少配置时间和运维工作量。 + 你现在可以复制现有的变更数据流，同时保留其关键配置和路由信息。该功能可帮助你快速重建失败的变更数据流，或基于相似设置创建新的变更数据流，从而减少配置时间和运维工作量。 - 详情参见 [复制 changefeed](/tidb-cloud/changefeed-overview.md#duplicate-a-changefeed)。 + 了解更多信息，请参见 [复制变更数据流](/tidb-cloud/changefeed-overview.md#duplicate-a-changefeed)。 **控制台变更** @@ -26,9 +55,9 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 集群支持与 Model Context Protocol (MCP) 的无缝 AI 集成。 - TiDB Cloud Starter 现已支持 MCP，提供统一且安全的方式，将你的 TiDB Cloud Starter 集群连接到主流 AI 工具，包括 Cursor、Claude Code、VS Code 和 WindSurf。你只需一次配置，即可在几分钟内通过 AI 工具查询你的数据。 + TiDB Cloud Starter 现已支持 MCP，提供统一且安全的方式，将你的 TiDB Cloud Starter 集群连接到主流 AI 工具，包括 Cursor、Claude Code、VS Code 和 WindSurf。你只需一次性设置连接，即可在几分钟内通过 AI 工具查询你的数据。 - 要访问此功能，请在 [cluster](https://tidbcloud.com/project/clusters) 概览页右上角点击 **Use with AI Tools**。 + 访问该功能，请在 [cluster](https://tidbcloud.com/project/clusters) 概览页右上角点击 **Use with AI Tools**。 ## 2025 年 12 月 9 日 @@ -45,24 +74,24 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - 为 [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 和 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群新增统一的 **Integrations** 页面。 - 在集群的 **Integrations** 页面集中展示所有第三方集成。以下列表按使用场景分组，列出了这些集成： - - **Deploy**: AWS Lambda、Cloudflare Workers、Gitpod、Netlify、Terraform、WordPress - - **Data**: Airbyte、Amazon AppFlow、dbt Labs、Looker Studio、n8n、Zapier - - **GUIs**: DBeaver、JetBrains DataGrip、MySQL Workbench、Navicat、ProxySQL、Visual Studio Code - - **Java**: JDBC、Hibernate、MyBatis、Spring Boot - - **Go**: Go-MySQL-Driver、GORM - - **Python**: Django、mysqlclient、MySQL Connector/Python、peewee、PyMySQL、SQLAlchemy - - **Node.js**: mysql.js、Next.js、node-mysql2、Prisma、Sequelize、TypeORM - - **Ruby**: mysql2、Rails - - 将 [Vercel](/tidb-cloud/integrate-tidbcloud-with-vercel.md) 和 [AWS Bedrock](/tidb-cloud/vector-search-integrate-with-amazon-bedrock.md) 集成入口移动到集群级别，提升可发现性。 - - 新增 **Suggest Integration**，用于提交新集成需求。 + - **Deploy**：AWS Lambda、Cloudflare Workers、Gitpod、Netlify、Terraform、WordPress + - **Data**：Airbyte、Amazon AppFlow、dbt Labs、Looker Studio、n8n、Zapier + - **GUIs**：DBeaver、JetBrains DataGrip、MySQL Workbench、Navicat、ProxySQL、Visual Studio Code + - **Java**：JDBC、Hibernate、MyBatis、Spring Boot + - **Go**：Go-MySQL-Driver、GORM + - **Python**：Django、mysqlclient、MySQL Connector/Python、peewee、PyMySQL、SQLAlchemy + - **Node.js**：mysql.js、Next.js、node-mysql2、Prisma、Sequelize、TypeORM + - **Ruby**：mysql2、Rails + - 将 [Vercel](/tidb-cloud/integrate-tidbcloud-with-vercel.md) 和 [AWS Bedrock](/tidb-cloud/vector-search-integrate-with-amazon-bedrock.md) 的集成入口移动到集群级别，以提升可发现性。 + - 新增 **Suggest Integration**，用于提交新的集成需求。 **API 变更** -- TiDB Cloud IAM API (v1beta1) 支持列出控制台审计日志。 +- TiDB Cloud IAM API（v1beta1）支持列出控制台审计日志。 - [List audit logs](https://docs.pingcap.com/tidbcloud/api/v1beta1/iam/#tag/Audit-Log/paths/~1auditLogs/get) 接口提供了对控制台审计日志的编程访问能力。你可以使用该接口自动获取审计日志并定期备份，以满足安全和合规要求。 + [List audit logs](https://docs.pingcap.com/tidbcloud/api/v1beta1/iam/#tag/Audit-Log/paths/~1auditLogs/get) 接口提供了以编程方式访问控制台审计日志的能力。你可以使用该接口自动获取审计日志，并定期备份，以满足安全和合规要求。 - 详情参见 [TiDB Cloud IAM API](https://docs.pingcap.com/tidbcloud/api/v1beta1/iam/)。 + 了解更多信息，请参见 [TiDB Cloud IAM API](https://docs.pingcap.com/tidbcloud/api/v1beta1/iam/)。 ## 2025 年 12 月 2 日 @@ -72,11 +101,11 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的 Prometheus 集成现已正式发布（GA）。 - TiDB Cloud 现以集群级别管理 Prometheus 集成，提供更细粒度的控制和配置。该功能可让你将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的统计/指标（信息）无缝发送到 Prometheus，实现统一平台下的高级报警/告警。 + TiDB Cloud 现以集群级别管理 Prometheus 集成，提供更细粒度的控制和配置。该功能允许你将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的统计/指标（信息）无缝发送到 Prometheus，实现统一平台下的高级报警/告警。 - 集成步骤参见 [集成 TiDB Cloud 与 Prometheus 和 Grafana](/tidb-cloud/monitor-prometheus-and-grafana-integration.md)。 + 集成步骤详见 [将 TiDB Cloud 集成到 Prometheus 和 Grafana](/tidb-cloud/monitor-prometheus-and-grafana-integration.md)。 - 如需将现有 Prometheus 集成迁移到集群级别，参见 [迁移 Prometheus 集成](/tidb-cloud/migrate-prometheus-metrics-integrations.md)。 + 如需将现有 Prometheus 集成迁移到集群级别，请参见 [迁移 Prometheus 集成](/tidb-cloud/migrate-prometheus-metrics-integrations.md)。 ## 2025 年 11 月 18 日 @@ -84,11 +113,11 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Dedicated** - - 增强 changefeed 概览，包含完整的配置信息。 + - 增强变更数据流（changefeed）摘要，包含完整的配置信息。 - 之前，你需要暂停 changefeed 才能查看其配置，然后再恢复。现在 **Changefeed** 页面在概览视图中直接展示完整配置。此次更新保持了修改/编辑和查看模式的一致性，并引入了全新布局以提升可读性。你可以更高效地查看当前配置。 + 之前，你需要暂停变更数据流以查看其配置，然后再恢复。现在 **Changefeed** 页面在摘要视图中直接显示完整配置。此次更新保持了修改/编辑和查看模式的一致性，并引入了全新布局以提升可读性。你可以更高效地查看当前配置。 - 详情参见 [Changefeed 概览](/tidb-cloud/changefeed-overview.md)。 + 了解更多信息，请参见 [Changefeed 概述](/tidb-cloud/changefeed-overview.md)。 ## 2025 年 11 月 11 日 @@ -98,9 +127,9 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - 当你从备份恢复 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群到新集群时，现在可以为新集群选择节点存储类型（如 [Standard storage](/tidb-cloud/size-your-cluster.md#standard-storage)），而不再局限于默认存储类型。 - 该功能支持你精确还原原有配置，或选择更适合需求的存储类型。 + 该功能允许你精确还原原有配置，或选择更适合需求的存储类型。 - 详情参见 [恢复数据到新集群](/tidb-cloud/backup-and-restore.md#restore-data-to-a-new-cluster)。 + 了解更多信息，请参见 [恢复数据到新集群](/tidb-cloud/backup-and-restore.md#restore-data-to-a-new-cluster)。 ## 2025 年 11 月 4 日 @@ -108,13 +137,13 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Dedicated** - - 通过 VPC Peering 连接 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群时，现在可以直接在 [TiDB Cloud 控制台](https://tidbcloud.com/) 配置 `/16` 到 `/18` 的 IP 范围，无需再联系 TiDB Cloud 支持。 + - 通过 VPC Peering 连接到托管在 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群时，现在可以在 [TiDB Cloud 控制台](https://tidbcloud.com/) 直接配置 `/16` 到 `/18` 的 IP 范围，无需再联系 TiDB Cloud 支持。 - 详情参见 [通过 VPC Peering 连接 TiDB Cloud Dedicated](/tidb-cloud/set-up-vpc-peering-connections.md)。 + 了解更多信息，请参见 [通过 VPC Peering 连接 TiDB Cloud Dedicated](/tidb-cloud/set-up-vpc-peering-connections.md)。 - - TiDB Cloud Dedicated 现为 4 vCPU 节点规格提供更清晰的指引和提示。该节点规格仅适用于测试、学习和探索 TiDB Cloud 功能的非生产环境。 + - TiDB Cloud Dedicated 现在为 4 vCPU 节点规格提供更清晰的指引和提示。该节点规格仅适用于测试、学习和探索 TiDB Cloud 功能的非生产环境。 - 详情参见 [确定 TiDB 规格](/tidb-cloud/size-your-cluster.md)。 + 了解更多信息，请参见 [确定 TiDB 规格](/tidb-cloud/size-your-cluster.md)。 ## 2025 年 10 月 28 日 @@ -122,21 +151,21 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Starter 和 TiDB Cloud Essential** - 为提升连接稳定性，防止 TiDB 服务器重启或维护期间出现意外断连，建议你将数据库连接的最大生命周期设置为小于 30 分钟。 + 为提升连接稳定性，防止 TiDB server 重启或维护期间出现意外断连，建议你将数据库连接的最大生命周期设置为小于 30 分钟。 - 详情参见 [配置连接生命周期](/develop/dev-guide-connection-parameters.md#configure-the-lifetime-of-connections)。 + 了解更多信息，请参见 [配置连接生命周期](/develop/dev-guide-connection-parameters.md#configure-the-lifetime-of-connections)。 **API 变更** - **TiDB Cloud Dedicated** - 新增以下 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) API 接口，用于管理第三方监控集成： + 为管理第三方监控集成，新增以下 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) API 接口： - 列出集成 - 创建集成 - 删除集成 - 详情参见 [TiDB Cloud Dedicated API](https://docs.pingcap.com/tidbcloud/api/v1beta1/dedicated/)。 + 了解更多信息，请参见 [TiDB Cloud Dedicated API](https://docs.pingcap.com/tidbcloud/api/v1beta1/dedicated/)。 ## 2025 年 10 月 21 日 @@ -144,19 +173,19 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Dedicated** - - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 增强了 [Changefeeds](/tidb-cloud/changefeed-overview.md) 的私有端点功能，简化配置、提升安全性，并为数据下游提供更大灵活性。 + - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 增强了 [Changefeeds](/tidb-cloud/changefeed-overview.md) 的私有端点功能，简化配置、提升安全性，并为数据下沉提供更大灵活性。 - - **简化配置**：私有端点的创建现与 changefeed 创建解耦，同一项目下多个 changefeed 可共享一个私有端点，减少重复配置。 - - **MySQL 私有链路下游**：为数据下沉到 MySQL 提供更安全方式，并支持通过私有链路直接下沉到另一个 TiDB Cloud Dedicated 集群。 - - **自定义域名支持**：使用自建 Kafka 服务时，可为数据下游配置自定义域名，提升安全性，并可灵活更新 advertised listener，无需重启服务器。 + - **简化配置**：私有端点的创建现已独立于变更数据流创建，允许同一项目下多个变更数据流共享一个私有端点，减少冗余配置。 + - **MySQL 的私有链路下沉**：为数据下沉到 MySQL 提供更安全的方式，并支持通过私有链路直接下沉到另一个 TiDB Cloud Dedicated 集群。 + - **自定义域名支持**：使用自建 Kafka service 时，可为数据下沉配置自定义域名，提升安全性，并在无需重启 server 的情况下灵活更新 advertised listener。 - 详情参见 [为 Changefeeds 配置私有端点](/tidb-cloud/set-up-sink-private-endpoint.md)。 + 了解更多信息，请参见 [为 Changefeeds 设置私有端点](/tidb-cloud/set-up-sink-private-endpoint.md)。 - - [Prometheus 集成（预览）](/tidb-cloud/monitor-prometheus-and-grafana-integration.md) 现已支持 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群。 + - [Prometheus 集成（预览）](/tidb-cloud/monitor-prometheus-and-grafana-integration.md) 现已适用于 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群。 - TiDB Cloud 现以集群级别管理 Prometheus 集成，提供更细粒度的控制和配置。该功能可让你将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的统计/指标（信息）无缝发送到 Prometheus，实现统一平台下的高级报警/告警。 + TiDB Cloud 现以集群级别管理 Prometheus 集成，提供更细粒度的控制和配置。该功能允许你将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的统计/指标（信息）无缝发送到 Prometheus，实现统一平台下的高级报警/告警。 - 详情参见 [集成 TiDB Cloud 与 Prometheus 和 Grafana](/tidb-cloud/monitor-prometheus-and-grafana-integration.md)。 + 了解更多信息，请参见 [将 TiDB Cloud 集成到 Prometheus 和 Grafana](/tidb-cloud/monitor-prometheus-and-grafana-integration.md)。 ## 2025 年 10 月 14 日 @@ -168,48 +197,48 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] 目前，仅 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 和 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 支持数据库审计日志。现有已启用数据库审计日志的 TiDB Cloud Starter 集群不受影响。 - - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 移除了原地恢复功能，即你无法再将备份直接恢复到同一集群。此变更有助于防止误覆盖活跃生产数据和潜在数据丢失。 + - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 移除了原地恢复功能，即不再支持将备份直接恢复到同一集群。此变更有助于防止误覆盖活跃生产数据和潜在数据丢失。 - 如需恢复数据，你可以 [将备份恢复到新集群](/tidb-cloud/backup-and-restore-serverless.md#perform-the-restore)。验证恢复数据后，将应用切换到新集群。已在现有集群中恢复的数据保持不变，无需操作，除非你执行新的恢复。 + 如需恢复数据，你可以 [将备份恢复到新集群](/tidb-cloud/backup-and-restore-serverless.md#perform-the-restore)。验证恢复数据后，将应用切换到新集群。已在现有集群中恢复的数据不受影响，除非你执行新的恢复操作。 - 若需更安全、可控和灵活的恢复与迁移流程，建议使用 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential)。 + 如需更安全、可控且灵活的恢复和迁移流程，建议使用 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential)。 - - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 的 [**Metrics**](/tidb-cloud/built-in-monitoring.md#view-the-metrics-page) 页面新增以下统计/指标（信息），以加快诊断和容量规划： + - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 的 [**Metrics**](/tidb-cloud/built-in-monitoring.md#view-the-metrics-page) 页面新增以下统计/指标（信息），以加速诊断和容量规划： - `Lock-wait (P95/P99)`：监控锁等待时间分位数，定位争用热点。 - - `Idle Connection Duration (P99 incl. not/in txn)`：识别长时间空闲连接（包括在事务内和非事务内），以便调整连接池限制和超时。 + - `Idle Connection Duration (P99 incl. not/in txn)`：识别长时间空闲连接（包括在事务和非事务），以便调整连接池限制和超时。 - **TiDB Cloud Essential** - - [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 在 AWS 和阿里云 公测中。 + - [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 在 AWS 和阿里云 上公测。 - 对于业务负载持续增长、需要实时扩展性的应用，TiDB Cloud Essential 提供灵活性和性能，助力业务发展。 + 对于业务负载持续增长、需要实时扩展性的应用，TiDB Cloud Essential 提供了灵活性和性能，助力业务发展。 - 详情参见 [TiDB Cloud Essential 现已在 AWS 和阿里云公测](https://www.pingcap.com/blog/tidb-cloud-essential-now-available-public-preview-aws-alibaba-cloud/)。 + 了解更多信息，请参见 [TiDB Cloud Essential 现已在 AWS 和阿里云公测](https://www.pingcap.com/blog/tidb-cloud-essential-now-available-public-preview-aws-alibaba-cloud/)。 - - [TiDB Cloud console](https://tidbcloud.com) 现已支持 TiDB Cloud Essential 的数据库审计日志，并支持自定义轮转设置。 + - 数据库审计日志现已在 [TiDB Cloud 控制台](https://tidbcloud.com) 上线，适用于 TiDB Cloud Essential，并支持自定义轮转设置。 你可以将数据库审计日志存储在 TiDB Cloud、Amazon S3、Google Cloud Storage、Azure Blob Storage 或阿里云 OSS。 - 目前该功能为 beta。详情参见 [TiDB Cloud Essential 数据库审计日志](/tidb-cloud/essential-database-audit-logging.md)。 + 目前该功能为 Beta 版本。了解更多信息，请参见 [TiDB Cloud Essential 的数据库审计日志](/tidb-cloud/essential-database-audit-logging.md)。 - - TiDB Cloud Essential 新增事件 `ResourceLimitation`，当集群的 Request Capacity Units (RCUs) 消耗在一小时内多次达到配置上限时通知你。 + - TiDB Cloud Essential 新增事件 `ResourceLimitation`，当集群的 Request Capacity Units（RCUs）消耗在一小时内多次达到配置上限时通知你。 - 超出限制的用量可能会被限流。为避免服务影响，建议提升最大 RCU。 + 超出限制的使用可能会被限流。为避免 service 受影响，建议提升最大 RCU。 - 事件详情参见 [TiDB Cloud 集群事件](/tidb-cloud/tidb-cloud-events.md)。 + 了解更多事件信息，请参见 [TiDB Cloud 集群事件](/tidb-cloud/tidb-cloud-events.md)。 - - [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 的 [**Metrics**](/tidb-cloud/built-in-monitoring.md#view-the-metrics-page) 页面新增以下统计/指标（信息），以加快诊断和容量规划： + - [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 的 [**Metrics**](/tidb-cloud/built-in-monitoring.md#view-the-metrics-page) 页面新增以下统计/指标（信息），以加速诊断和容量规划： - - `Capacity vs Usage (RU/s)`：可视化配置的 Request Unit (RU) 容量与实际 RU 消耗，便于发现冗余空间和优化自动扩展。 + - `Capacity vs Usage (RU/s)`：可视化已配置 Request Unit（RU）容量与实际 RU 消耗，便于发现冗余空间并优化自动扩展。 - `Lock-wait (P95/P99)`：监控锁等待时间分位数，定位争用热点。 - - `Idle Connection Duration (P99 incl. not/in txn)`：识别长时间空闲连接（包括在事务内和非事务内），以便调整连接池限制和超时。 + - `Idle Connection Duration (P99 incl. not/in txn)`：识别长时间空闲连接（包括在事务和非事务），以便调整连接池限制和超时。 - 详情参见 [TiDB Cloud 内置统计/指标（信息）](/tidb-cloud/built-in-monitoring.md)。 + 了解更多信息，请参见 [TiDB Cloud 内置统计/指标（信息）](/tidb-cloud/built-in-monitoring.md)。 ## 2025 年 9 月 30 日 @@ -217,13 +246,13 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Dedicated** - - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的 Datadog 和 New Relic 集成现已正式发布（GA）。 - - TiDB Cloud 现以集群级别管理 Datadog 和 New Relic 集成，提供更细粒度的控制和配置。该功能可让你将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的统计/指标（信息）无缝发送到 Datadog 或 New Relic，实现统一平台下的高级报警/告警。 - - 集成步骤参见 [集成 TiDB Cloud 与 Datadog](/tidb-cloud/monitor-datadog-integration.md) 和 [集成 TiDB Cloud 与 New Relic](/tidb-cloud/monitor-new-relic-integration.md)。 - - 如需将现有 Datadog 和 New Relic 集成迁移到集群级别，参见 [迁移 Datadog 和 New Relic 集成](/tidb-cloud/migrate-metrics-integrations.md)。 + - Datadog 和 New Relic 集成现已正式发布（GA），适用于 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群。 + + TiDB Cloud 现以集群级别管理 Datadog 和 New Relic 集成，提供更细粒度的控制和配置。该功能允许你将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的统计/指标（信息）无缝发送到 Datadog 或 New Relic，实现统一平台下的高级报警/告警。 + + 集成步骤详见 [将 TiDB Cloud 集成到 Datadog](/tidb-cloud/monitor-datadog-integration.md) 和 [将 TiDB Cloud 集成到 New Relic](/tidb-cloud/monitor-new-relic-integration.md)。 + + 如需将现有 Datadog 和 New Relic 集成迁移到集群级别，请参见 [迁移 Datadog 和 New Relic 集成](/tidb-cloud/migrate-metrics-integrations.md)。 ## 2025 年 9 月 23 日 @@ -231,15 +260,15 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Dedicated** - - 支持用户自定义 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) changefeed 中 `UPDATE` 事件的切分。 + - 支持用户自定义 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 变更数据流（changefeed）中的 `UPDATE` 事件切分。 在 TiDB Cloud Dedicated 集群中，你可以配置是否将 `UPDATE` 事件保留为原始事件，或切分为单独的 `DELETE` 和 `INSERT` 事件。该功能为高级复制场景提供更大灵活性。 - 该功能仅支持非 SQL 下游，如 Apache Kafka 和 Amazon S3。详情参见 [下沉到 Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md)、[下沉到 Apache Pulsar](/tidb-cloud/changefeed-sink-to-apache-pulsar.md) 和 [下沉到云存储](/tidb-cloud/changefeed-sink-to-cloud-storage.md)。 + 该功能仅支持非 SQL 目标端，如 Apache Kafka 和 Amazon S3。了解更多信息，请参见 [下沉到 Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md)、[下沉到 Apache Pulsar](/tidb-cloud/changefeed-sink-to-apache-pulsar.md) 和 [下沉到云存储](/tidb-cloud/changefeed-sink-to-cloud-storage.md)。 - 关于切分行为，参见 [为非 MySQL 下游切分主键或唯一键 `UPDATE` 事件](https://docs.pingcap.com/tidb/stable/ticdc-split-update-behavior/#split-primary-or-unique-key-update-events-for-non-mysql-sinks)。 + 关于切分行为的更多信息，请参见 [为非 MySQL sink 切分主键或唯一键 `UPDATE` 事件](https://docs.pingcap.com/tidb/stable/ticdc-split-update-behavior/#split-primary-or-unique-key-update-events-for-non-mysql-sinks)。 - - 为 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群提供新节点规格：`32 vCPU, 64 GiB`。 + - 为托管在 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群提供新的节点规格：`32 vCPU, 64 GiB`。 该节点规格适用于 TiDB 节点。 @@ -249,21 +278,21 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Dedicated** - - Azure 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群现已支持客户自管加密密钥（CMEK）静态加密。 + - Azure 上托管的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群现已支持客户自管加密密钥（CMEK）静态加密。 该功能允许你使用自主管理的加密密钥保护静态数据。CMEK 带来以下优势： - 数据安全：你拥有并管理加密密钥，确保数据受保护且可控。 - - 合规性：使用 CMEK 有助于满足数据加密的合规和监管要求。 + - 合规性：使用 CMEK 有助于满足数据加密的监管和合规要求。 - 灵活性：你可以在创建项目时启用 CMEK，并在创建集群前完成 CMEK 配置。 - 启用步骤如下： + 启用该功能，请按以下步骤操作： 1. 在 [TiDB Cloud 控制台](https://tidbcloud.com) 创建启用 CMEK 的项目。 2. 完成该项目的 CMEK 配置。 - 3. 在与 CMEK 配置相同的 region 创建 Azure 上的 TiDB Cloud Dedicated 集群。 + 3. 在与 CMEK 配置相同的 Region 创建托管在 Azure 上的 TiDB Cloud Dedicated 集群。 - 详情参见 [Azure 上使用客户自管加密密钥进行静态加密](/tidb-cloud/tidb-cloud-encrypt-cmek-azure.md)。 + 了解更多信息，请参见 [在 Azure 上使用客户自管加密密钥进行静态加密](/tidb-cloud/tidb-cloud-encrypt-cmek-azure.md)。 ## 2025 年 9 月 9 日 @@ -271,16 +300,16 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Starter** - - 新建 [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 集群仅启用分区高可用性，且不可配置。 + - 新建 [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 集群仅启用分区高可用性（zonal high availability），且不可配置。 - 2025 年 9 月 9 日前已启用区域高可用性的现有 TiDB Cloud Starter 集群，区域高可用性继续受支持，不受影响。 - **TiDB Cloud Essential** - - 新建 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群默认启用区域高可用性，且可在集群创建时根据需要切换为分区高可用性。 + - 新建 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群默认启用区域高可用性（regional high availability），你可在创建集群时根据需要切换为分区高可用性。 - 详情参见 [TiDB Cloud Starter 和 Essential 的高可用性](/tidb-cloud/serverless-high-availability.md)。 + 了解更多信息，请参见 [TiDB Cloud Starter 和 Essential 的高可用性](/tidb-cloud/serverless-high-availability.md)。 @@ -292,7 +321,7 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Essential** - - [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群支持阿里云三个新 region：`Jakarta (ap-southeast-5)`、`Mexico (na-south-1)` 和 `Tokyo (ap-northeast-1)`。 + - [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 集群新增支持 3 个阿里云 Region：`Jakarta (ap-southeast-5)`、`Mexico (na-south-1)` 和 `Tokyo (ap-northeast-1)`。 - **TiDB Cloud Dedicated** @@ -314,25 +343,25 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - **TiDB Cloud Starter** - - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 引入 Auto Embedding（Beta），让你无需额外配置即可将文本转换为向量。该功能可加速在 TiDB Cloud 上开发语义搜索、RAG、重排序和分类，减少集成开销。 + - [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 引入 Auto Embedding（Beta），让你无需额外配置即可轻松将文本转换为向量。该功能可加速在 TiDB Cloud 中开发语义搜索、RAG、重排序和分类等场景，减少集成开销。 - - **与主流 LLM 提供商的 Auto Embedding**：Amazon Titan、OpenAI、Cohere、Gemini、Jina AI、Hugging Face 和 NVIDIA NIM。 - - **原生集成 AWS Bedrock**：托管嵌入模型并提供免费额度，包括 AWS Bedrock 的 Amazon Titan 和 Cohere 文本嵌入模型。 + - **与主流 LLM 提供商的 Auto Embedding**：Amazon Titan、OpenAI、Cohere、Gemini、Jina AI、Hugging Face、NVIDIA NIM。 + - **与 AWS Bedrock 的原生集成**：支持 AWS Bedrock 的托管 embedding 模型（含免费额度），包括 Amazon Titan 和 Cohere 文本 embedding 模型。 - **支持 SQL 和 Python**，并提供创建、存储和查询 embedding 的代码示例。 - 详情参见 [Auto Embedding](https://docs.pingcap.com/tidbcloud/vector-search-auto-embedding-overview/?plan=starter)。 + 了解更多信息，请参见 [Auto Embedding](https://docs.pingcap.com/tidbcloud/vector-search-auto-embedding-overview/?plan=starter)。 - **TiDB Cloud Dedicated** - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 不再支持 Index Insight（beta）功能。 - 建议你改用 [Index Advisor](/index-advisor.md)，该功能适用于 TiDB v8.5.0 及以上版本。Index Advisor 引入了 `RECOMMEND INDEX` SQL 语句，帮助你通过推荐索引优化查询性能。 + 建议你改用 [Index Advisor](/index-advisor.md)，适用于 TiDB v8.5.0 及以上版本。Index Advisor 引入了 `RECOMMEND INDEX` SQL 语句，帮助你通过推荐索引优化查询性能。 - - 你现在可以在启用每周备份的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群上手动关闭 Point-in-time Restore 功能。 + - 你现在可以在启用每周备份的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群上手动禁用时间点恢复（Point-in-time Restore）功能。 - 该增强有助于降低不需要高 RPO 保护的集群成本。 + 该增强有助于降低不需要高 RPO 保护的集群的成本。 - 详情参见 [备份与恢复 TiDB Cloud Dedicated 数据](/tidb-cloud/backup-and-restore.md)。 + 了解更多信息，请参见 [备份与恢复 TiDB Cloud Dedicated 数据](/tidb-cloud/backup-and-restore.md)。 ## 2025 年 8 月 12 日 @@ -344,39 +373,39 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - 将 “TiDB Cloud Serverless” 重命名为 “TiDB Cloud Starter”。 - 自动扩展入门方案现命名为 “TiDB Cloud Starter”，更好地体现其为新用户设计的定位。所有功能、定价和免费额度保持不变。 + 自动扩展入门方案现更名为 “TiDB Cloud Starter”，以更好地体现其为新用户提供的角色。所有功能、定价和免费额度保持不变。 自 2025 年 8 月 12 日（PDT）起，你的现有 Serverless 集群将在 [TiDB Cloud 控制台](https://tidbcloud.com) 中显示为 Starter。你的连接字符串、端点和数据均保持不变，无需更改代码或安排停机。 - - TiDB Cloud Starter 在阿里云公测。 + - TiDB Cloud Starter 在阿里云上预览。 - **TiDB Cloud Essential** - [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 在阿里云公测。 + [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 在阿里云上预览。 - TiDB Cloud Essential 在阿里云自 2025 年 5 月起已进行有限公测。本次为首次在发布说明中正式列出。当前阶段，Essential 在阿里云新加坡 region 提供与 Starter 一致的功能集。 + TiDB Cloud Essential 在阿里云自 2025 年 5 月起已进行有限公测。本次为首次在发布说明中正式纳入 Essential。在此阶段，阿里云上的 Essential 功能集与 Starter 保持一致，现已在阿里云新加坡 Region 提供。 试用方法： - 在 [TiDB Cloud 控制台](https://tidbcloud.com/) 创建集群时选择阿里云作为云服务商，即可看到 Essential 选项。 - 你也可以通过 [阿里云 Marketplace 上的 Essential 列表](https://www.alibabacloud.com/en/marketplace/tidb?_p_lc=1) 访问。 - 下一步计划扩展阿里云 region 覆盖，并增加 AWS 支持。 + 下一步，我们计划扩展阿里云 Region 覆盖范围，并增加对 AWS 的支持。 - 若你在公测期间试用 Essential on 阿里云，可通过 Web 控制台反馈，或加入 [Slack](https://tidbcommunity.slack.com/archives/CH7TTLL7P) 或 [Discord](https://discord.gg/ukhXbn69Nx) 社区。 + 如果你在预览期间试用阿里云上的 Essential，可通过 Web 控制台反馈，也可加入我们的 [Slack 社区](https://tidbcommunity.slack.com/archives/CH7TTLL7P) 或 [Discord 社区](https://discord.gg/ukhXbn69Nx) 交流。 - **TiDB Cloud Dedicated** - - Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 现通过优化 NAT 子网分配策略，支持每个 region 超过 8 个 Google Private Service Connect (PSC) 连接。 + - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 在 Google Cloud 上通过优化 NAT 子网分配策略，现支持每个 Region 超过 8 个 Google Private Service Connect（PSC）连接。 - 详情参见 [通过 Google Cloud Private Service Connect 连接 TiDB Cloud Dedicated 集群](/tidb-cloud/set-up-private-endpoint-connections-on-google-cloud.md#restrictions)。 + 了解更多信息，请参见 [通过 Google Cloud Private Service Connect 连接 TiDB Cloud Dedicated 集群](/tidb-cloud/set-up-private-endpoint-connections-on-google-cloud.md#restrictions)。 - 优化 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 统计/指标（信息）： - 在 [**Advanced**](/tidb-cloud/built-in-monitoring.md#advanced) 分类下，新增 **Affected Rows**、**Leader Count** 和 **Region Count** 统计/指标（信息），提升诊断能力。 - 在 [**Server**](/tidb-cloud/built-in-monitoring.md#server) 分类下，优化 **TiKV IO Bps** 统计/指标（信息），提升准确性和一致性。 - 详情参见 [TiDB Cloud 内置统计/指标（信息）](/tidb-cloud/built-in-monitoring.md)。 + 了解更多信息，请参见 [TiDB Cloud 内置统计/指标（信息）](/tidb-cloud/built-in-monitoring.md)。 @@ -386,50 +415,50 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] 将 “TiDB Cloud Serverless” 重命名为 “TiDB Cloud Starter”。 - 自动扩展入门方案现命名为 “TiDB Cloud Starter”，更好地体现其为新用户设计的定位。所有功能、定价和免费额度保持不变。 + 自动扩展入门方案现更名为 “TiDB Cloud Starter”，以更好地体现其为新用户提供的角色。所有功能、定价和免费额度保持不变。 自 2025 年 8 月 12 日（PDT）起，你的现有 Serverless 集群将在 [TiDB Cloud 控制台](https://tidbcloud.com) 中显示为 Starter。你的连接字符串、端点和数据均保持不变，无需更改代码或安排停机。 - **TiDB Cloud Dedicated** - - Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 现通过优化 NAT 子网分配策略，支持每个 region 超过 8 个 Google Private Service Connect (PSC) 连接。 + - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 在 Google Cloud 上通过优化 NAT 子网分配策略，现支持每个 Region 超过 8 个 Google Private Service Connect（PSC）连接。 - 详情参见 [通过 Google Cloud Private Service Connect 连接 TiDB Cloud Dedicated 集群](/tidb-cloud/set-up-private-endpoint-connections-on-google-cloud.md#restrictions)。 + 了解更多信息，请参见 [通过 Google Cloud Private Service Connect 连接 TiDB Cloud Dedicated 集群](/tidb-cloud/set-up-private-endpoint-connections-on-google-cloud.md#restrictions)。 - 优化 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 统计/指标（信息）： - 在 [**Advanced**](/tidb-cloud/built-in-monitoring.md#advanced) 分类下，新增 **Affected Rows**、**Leader Count** 和 **Region Count** 统计/指标（信息），提升诊断能力。 - 在 [**Server**](/tidb-cloud/built-in-monitoring.md#server) 分类下，优化 **TiKV IO Bps** 统计/指标（信息），提升准确性和一致性。 - 详情参见 [TiDB Cloud 内置统计/指标（信息）](/tidb-cloud/built-in-monitoring.md)。 + 了解更多信息，请参见 [TiDB Cloud 内置统计/指标（信息）](/tidb-cloud/built-in-monitoring.md)。 **API 变更** -- 推出 TiDB Cloud Dedicated API (v1beta1)，可自动高效管理以下资源： +- 推出 TiDB Cloud Dedicated API（v1beta1），可自动高效地管理以下资源： - **Cluster**：更灵活地管理你的 TiDB Cloud Dedicated 集群。 - - **Region**：展示可部署 TiDB Cloud Dedicated 集群的所有云 region。 - - **Private endpoint connection**：为集群配置安全私有连接。 + - **Region**：展示所有可部署 TiDB Cloud Dedicated 集群的云 Region。 + - **Private endpoint connection**：为集群设置安全私有连接。 - **Import**：管理集群的数据导入任务。 - 详情参见 [TiDB Cloud Dedicated API](https://docs.pingcap.com/tidbcloud/api/v1beta1/dedicated/)。 + 了解更多信息，请参见 [TiDB Cloud Dedicated API](https://docs.pingcap.com/tidbcloud/api/v1beta1/dedicated/)。 -- 推出 TiDB Cloud Starter 和 Essential API (v1beta1)，可自动高效管理以下资源： +- 推出 TiDB Cloud Starter 和 Essential API（v1beta1），可自动高效地管理以下资源： - **Cluster**：更灵活地管理你的 TiDB Cloud Starter 或 Essential 集群。 - **Branch**：管理集群的分支。 - **Export**：管理集群的数据导出任务。 - **Import**：管理集群的数据导入任务。 - 详情参见 [TiDB Cloud Starter 和 Essential API](https://docs.pingcap.com/tidbcloud/api/v1beta1/serverless/)。 + 了解更多信息，请参见 [TiDB Cloud Starter 和 Essential API](https://docs.pingcap.com/tidbcloud/api/v1beta1/serverless/)。 -- TiDB Cloud IAM API (v1beta1) 支持 API 密钥的基于角色的访问控制（RBAC），可在组织和项目级别管理。 +- TiDB Cloud IAM API（v1beta1）支持 API 密钥的基于角色的访问控制（RBAC），适用于组织和项目级别。 - 你可以在组织级或项目级设置 API 密钥角色，提升安全性和访问控制。 + 你可以在组织级或项目级设置 API 密钥角色，以提升安全性和访问控制。 - 详情参见 [TiDB Cloud IAM API](https://docs.pingcap.com/tidbcloud/api/v1beta1/iam/)。 + 了解更多信息，请参见 [TiDB Cloud IAM API](https://docs.pingcap.com/tidbcloud/api/v1beta1/iam/)。 ## 2025 年 7 月 31 日 @@ -445,36 +474,36 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] 这些增强带来更准确的监控，并提升 Datadog 和 New Relic 集成的可靠性。 - 发布计划： + 推广计划： - 该预览版现已对未配置 Datadog 或 New Relic 集成的组织开放。对于已配置的组织，我们将在下月主动联系你，协商合适的迁移方案和时间表。 + 该预览版现已面向未使用 Datadog 或 New Relic 集成的组织开放。对于已集成的组织，我们将在下月主动联系你，协商合适的迁移方案和时间表。 - 详情参见 [集成 TiDB Cloud 与 Datadog（预览）](/tidb-cloud/monitor-datadog-integration.md) 和 [集成 TiDB Cloud 与 New Relic（预览）](/tidb-cloud/monitor-new-relic-integration.md)。 + 了解更多信息，请参见 [将 TiDB Cloud 集成到 Datadog（预览）](/tidb-cloud/monitor-datadog-integration.md) 和 [将 TiDB Cloud 集成到 New Relic（预览）](/tidb-cloud/monitor-new-relic-integration.md)。 ## 2025 年 7 月 22 日 **通用变更** -- 为 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群提供新节点规格：`32 vCPU, 128 GiB`。 +- 为托管在 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群提供新的节点规格：`32 vCPU, 128 GiB`。 该规格适用于 TiDB、TiKV 和 TiFlash 节点。 - 优化 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 中 TiKV 扩容流程，提升集群稳定性。 - 当你 [修改 TiKV 节点的 vCPU 和内存规格](/tidb-cloud/scale-tidb-cluster.md#change-vcpu-and-ram) 时，TiDB Cloud 会自动检查集群内部服务是否需要扩容以支持新配置。 + 当你 [修改 TiKV 节点的 vCPU 和内存规格](/tidb-cloud/scale-tidb-cluster.md#change-vcpu-and-ram) 时，TiDB Cloud 会自动检查集群内部 service 是否需要扩容以支持新配置。 - 若需扩容，TiDB Cloud 会在操作前提示你确认。 - - 若扩容后内部服务容量已大于所需，TiDB Cloud 会保留现有配置，避免不必要的变更影响集群稳定性。 + - 若当前内部 service 容量已大于扩容后所需，TiDB Cloud 会保留现有配置，避免不必要的变更影响集群稳定性。 **控制台变更** - 优化 [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群的云存储数据导入体验。 - 导入流程现简化为 3 步向导，并具备智能预检查。新向导引导你完成连接配置、文件映射和存储桶扫描。通过扫描，TiDB Cloud 会在导入前准确展示将被导入的文件及其目标位置，大幅降低配置复杂度并防止导入失败。 + 导入流程现已简化为 3 步向导，并具备智能预检查。新向导引导你完成连接设置、文件映射和 bucket 扫描。通过扫描，TiDB Cloud 会在导入前准确展示将被导入的文件及其目标位置，大幅降低配置复杂度并防止导入失败。 - 详情参见以下文档： + 了解更多信息，请参见以下文档： - - [导入示例数据到 TiDB Cloud Serverless](/tidb-cloud/import-sample-data-serverless.md) + - [将示例数据导入 TiDB Cloud Serverless](/tidb-cloud/import-sample-data-serverless.md) - [从云存储导入 CSV 文件到 TiDB Cloud Serverless](/tidb-cloud/import-csv-files-serverless.md) - [从云存储导入 Apache Parquet 文件到 TiDB Cloud Serverless](/tidb-cloud/import-parquet-files-serverless.md) @@ -488,35 +517,35 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - 支持审计 `BackupCompleted` 事件，增强备份活动的控制台审计日志。 - 该增强可记录备份完成活动，满足安全和合规要求。 + 该增强允许你记录备份完成活动，以满足安全和合规要求。 - 详情参见 [控制台审计日志](/tidb-cloud/tidb-cloud-console-auditing.md)。 + 了解更多信息，请参见 [控制台审计日志](/tidb-cloud/tidb-cloud-console-auditing.md)。 -- 支持在 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) changefeed 中按表达式过滤列值。 +- 支持在 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 变更数据流中过滤列值。 - 你现在可以在 changefeed 中使用表达式过滤特定列值，从源头排除无关数据。该功能实现 DML 事件的细粒度过滤，帮助你降低资源消耗并提升性能。 + 你现在可以在变更数据流中使用表达式过滤特定列值，从源头排除无关数据。该功能实现 DML 事件的细粒度过滤，帮助你降低资源消耗并提升性能。 - 详情参见 [Changefeed](/tidb-cloud/changefeed-overview.md)。 + 了解更多信息，请参见 [Changefeed](/tidb-cloud/changefeed-overview.md)。 ## 2025 年 6 月 24 日 **通用变更** -- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 数据库审计日志（beta）现可按需申请。该功能可记录用户访问详情（如执行的 SQL 语句）历史。 +- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 数据库审计日志（Beta）现可按需申请。该功能允许你在日志中记录用户访问详情（如执行的 SQL 语句）历史。 - 申请方法：在 [TiDB Cloud 控制台](https://tidbcloud.com) 右下角点击 **?**，选择 **Request Support**，在 Description 填写 “申请 TiDB Cloud Serverless 数据库审计日志”，点击 **Submit**。 + 申请该功能，请在 [TiDB Cloud 控制台](https://tidbcloud.com) 右下角点击 **?**，选择 **Request Support**，在 Description 字段填写 “Apply for TiDB Cloud Serverless database audit logging”，并点击 **Submit**。 - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 支持用户自主管理日志脱敏。 - 你现在可以为 TiDB Cloud Dedicated 集群启用或关闭日志脱敏，自主管理集群日志的脱敏状态。 + 你现在可以为 TiDB Cloud Dedicated 集群启用或禁用日志脱敏，自主管理集群日志的脱敏状态。 - 详情参见 [用户自主管理日志脱敏](/tidb-cloud/tidb-cloud-log-redaction.md)。 + 了解更多信息，请参见 [用户自主管理日志脱敏](/tidb-cloud/tidb-cloud-log-redaction.md)。 -- AWS 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群现已正式支持客户自管加密密钥（CMEK）静态加密。 +- AWS 上托管的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群现已正式支持客户自管加密密钥（CMEK）静态加密。 - 该功能允许你通过 Key Management Service (KMS) 管理的对称加密密钥保护静态数据。 + 该功能允许你通过 Key Management Service（KMS）管理的对称加密密钥保护静态数据。 - 详情参见 [AWS 上使用客户自管加密密钥进行静态加密](/tidb-cloud/tidb-cloud-encrypt-cmek-aws.md)。 + 了解更多信息，请参见 [在 AWS 上使用客户自管加密密钥进行静态加密](/tidb-cloud/tidb-cloud-encrypt-cmek-aws.md)。 ## 2025 年 6 月 17 日 @@ -524,14 +553,14 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群中，16 vCPU 和 32 vCPU TiKV 节点的最大存储容量由 **6144 GiB** 调整为 **4096 GiB**。 - 详情参见 [TiKV 节点存储容量](/tidb-cloud/size-your-cluster.md#tikv-node-storage-size)。 + 了解更多信息，请参见 [TiKV 节点存储容量](/tidb-cloud/size-your-cluster.md#tikv-node-storage-size)。 **控制台变更** - 重构左侧导航栏，提升整体导航体验。 - 左上角新增 图标，可随时隐藏或显示左侧导航栏。 - - 左上角新增组合框，可一站式快速切换组织、项目和集群。 + - 左上角新增组合框，可快速切换组织、项目和集群，集中管理。 @@ -542,15 +571,15 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] **通用变更** -- [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 现已在 Microsoft Azure 公测。 +- [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 在 Microsoft Azure 上现已公测。 随着本次发布，TiDB Cloud 现已支持三大主流公有云平台 —— AWS、Google Cloud 和 Azure，助你根据业务需求和云战略灵活部署 TiDB Cloud Dedicated 集群。 - AWS 和 Google Cloud 上的所有核心功能在 Azure 上均已支持。 - - Azure 目前支持 East US 2、日本东部和东南亚三个 region，后续将支持更多 region。 + - Azure 目前支持 East US 2、日本东部和东南亚 3 个 Region，后续将支持更多 Region。 - Azure 上的 TiDB Cloud Dedicated 集群需 TiDB 版本 v7.5.3 或以上。 - 快速上手文档： + 快速上手 Azure 上的 TiDB Cloud Dedicated，请参见以下文档： - [在 Azure 上创建 TiDB Cloud Dedicated 集群](/tidb-cloud/create-tidb-cluster.md) - [通过 Azure Private Endpoint 连接 TiDB Cloud Dedicated 集群](/tidb-cloud/set-up-private-endpoint-connections-on-azure.md) @@ -560,11 +589,11 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] 你现在可以将 `tidbcloud_disk_read_latency`、`tidbcloud_kv_request_duration` 等更多统计/指标（信息）集成到 Prometheus，追踪 TiDB Cloud Dedicated 的更多性能维度。 - 详情及启用方法参见 [集成 TiDB Cloud 与 Prometheus 和 Grafana（Beta）](/tidb-cloud/monitor-prometheus-and-grafana-integration.md#metrics-available-to-prometheus)。 + 了解可用统计/指标（信息）及启用方法，请参见 [将 TiDB Cloud 集成到 Prometheus 和 Grafana（Beta）](/tidb-cloud/monitor-prometheus-and-grafana-integration.md#metrics-available-to-prometheus)。 - TiKV [Standard](/tidb-cloud/size-your-cluster.md#standard-storage) 和 [Performance](/tidb-cloud/size-your-cluster.md#performance-and-plus-storage) 存储定价正式发布。 - 优惠期自 **2025 年 6 月 5 日 00:00 UTC** 起结束，届时价格恢复为标准价。TiDB Cloud Dedicated 价格详情参见 [TiDB Cloud Dedicated 价格明细](https://www.pingcap.com/tidb-dedicated-pricing-details/#node-cost)。 + 优惠期自 **2025 年 6 月 5 日 00:00 UTC** 起结束，届时价格恢复为标准价。TiDB Cloud Dedicated 价格详情请参见 [TiDB Cloud Dedicated 价格明细](https://www.pingcap.com/tidb-dedicated-pricing-details/#node-cost)。 **控制台变更** @@ -576,26 +605,26 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] **通用变更** -- [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的 changefeed 现支持将数据流式发送到 [Apache Pulsar](https://pulsar.apache.org)。 +- [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的变更数据流现已支持流式写入 [Apache Pulsar](https://pulsar.apache.org)。 - 该功能可将 TiDB Cloud Dedicated 集群与更多下游系统集成，满足更多数据集成需求。使用该功能需确保集群版本为 v7.5.1 或以上。 + 该功能让你可将 TiDB Cloud Dedicated 集群与更多下游系统集成，满足更多数据集成需求。使用该功能需确保集群版本为 v7.5.1 或以上。 - 详情参见 [下沉到 Apache Pulsar](/tidb-cloud/changefeed-sink-to-apache-pulsar.md)。 + 了解更多信息，请参见 [下沉到 Apache Pulsar](/tidb-cloud/changefeed-sink-to-apache-pulsar.md)。 ## 2025 年 5 月 13 日 **通用变更** -- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 现已支持全文检索（beta），助力 AI 应用。 +- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 现已支持全文检索（Beta），助力 AI 应用。 - TiDB Cloud Serverless 现已支持全文检索（beta），使 AI 和 RAG 应用可通过精确关键字检索内容。该功能补充了向量检索（按语义相似度检索内容）。两者结合可显著提升 RAG 工作流的检索准确性和答案质量。主要特性包括： + TiDB Cloud Serverless 现已支持全文检索（Beta），使 AI 和 RAG（检索增强生成）应用可通过精确关键字检索内容。该功能补充了向量检索（按语义相似度检索内容）。两者结合可显著提升 RAG 工作流的检索准确性和答案质量。主要特性包括： - - 直接文本检索：可直接查询字符串列，无需 embedding。 - - 多语言支持：自动检测并分析多语言文本，单表内多语言无需指定语言。 + - 直接文本检索：可直接对 string 列进行查询，无需 embedding。 + - 多语言支持：自动检测并分析多语言文本，支持同一表中多语言，无需指定语言。 - 基于相关性的排序：结果采用业界标准 BM25 算法排序，确保最优相关性。 - - 原生 SQL 兼容：可与 SQL 过滤、分组、关联等功能无缝结合。 + - 原生 SQL 兼容性：可与 SQL 过滤、分组、关联等功能无缝结合。 - 快速上手参见 [使用 SQL 进行全文检索](/tidb-cloud/vector-search-full-text-search-sql.md) 或 [使用 Python 进行全文检索](/tidb-cloud/vector-search-full-text-search-python.md)。 + 快速上手，请参见 [使用 SQL 进行全文检索](/tidb-cloud/vector-search-full-text-search-sql.md) 或 [使用 Python 进行全文检索](/tidb-cloud/vector-search-full-text-search-python.md)。 - [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群 TiFlash 节点最大存储容量提升： @@ -604,19 +633,19 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] 该增强提升了 TiDB Cloud Dedicated 集群的分析数据存储能力，提高了工作负载扩展效率，满足不断增长的数据需求。 - 详情参见 [TiFlash 节点存储容量](/tidb-cloud/size-your-cluster.md#tiflash-node-storage)。 + 了解更多信息，请参见 [TiFlash 节点存储容量](/tidb-cloud/size-your-cluster.md#tiflash-node-storage)。 -- 优化维护窗口配置体验，提供更直观的选项以配置和重新安排维护任务。 +- 通过更直观的选项优化维护窗口配置体验，支持配置和重新安排维护任务。 - 详情参见 [配置维护窗口](/tidb-cloud/configure-maintenance-window.md)。 + 了解更多信息，请参见 [配置维护窗口](/tidb-cloud/configure-maintenance-window.md)。 -- 延长 TiKV [Standard](/tidb-cloud/size-your-cluster.md#standard-storage) 和 [Performance](/tidb-cloud/size-your-cluster.md#performance-and-plus-storage) 存储类型的优惠期，现延长至 2025 年 6 月 5 日。届时价格恢复为标准价。 +- 延长 TiKV [Standard](/tidb-cloud/size-your-cluster.md#standard-storage) 和 [Performance](/tidb-cloud/size-your-cluster.md#performance-and-plus-storage) 存储类型的优惠期。促销截止日期为 2025 年 6 月 5 日，届时价格恢复为标准价。 **控制台变更** - 优化 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群 **Backup Setting** 页面布局，提升备份配置体验。 - 详情参见 [备份与恢复 TiDB Cloud Dedicated 数据](/tidb-cloud/backup-and-restore.md)。 + 了解更多信息，请参见 [备份与恢复 TiDB Cloud Dedicated 数据](/tidb-cloud/backup-and-restore.md)。 ## 2025 年 4 月 22 日 @@ -626,7 +655,7 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群现支持通过 [AccessKey 对](https://www.alibabacloud.com/help/en/ram/user-guide/create-an-accesskey-pair) 导出数据到 [阿里云对象存储服务（OSS）](https://www.alibabacloud.com/en/product/object-storage-service)。 - 详情参见 [从 TiDB Cloud Serverless 导出数据](/tidb-cloud/serverless-export.md#alibaba-cloud-oss)。 + 了解更多信息，请参见 [从 TiDB Cloud Serverless 导出数据](/tidb-cloud/serverless-export.md#alibaba-cloud-oss)。 - [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群 TiDB 版本由 [v7.1.3](https://docs.pingcap.com/tidb/v7.1/release-7.1.3) 升级到 [v7.5.2](https://docs.pingcap.com/tidb/v7.5/release-7.5.2)。 @@ -636,9 +665,9 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - 支持从 [阿里云对象存储服务（OSS）](https://www.alibabacloud.com/en/product/object-storage-service) 导入数据到 [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群。 - 该功能简化了数据迁移到 TiDB Cloud Serverless。你可以使用 AccessKey 对进行认证。 + 该功能简化了数据迁移到 TiDB Cloud Serverless 的流程。你可以使用 AccessKey 对进行认证。 - 详情参见以下文档： + 了解更多信息，请参见以下文档： - [从 Amazon S3、GCS、Azure Blob Storage 或阿里云 OSS 导入 CSV 文件到 TiDB Cloud Serverless](/tidb-cloud/import-csv-files-serverless.md) - [从 Amazon S3、GCS、Azure Blob Storage 或阿里云 OSS 导入 Apache Parquet 文件到 TiDB Cloud Serverless](/tidb-cloud/import-parquet-files-serverless.md) @@ -647,67 +676,67 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] **通用变更** -- [TiDB Node Groups](/tidb-cloud/tidb-node-group-overview.md) 功能现已在 AWS 和 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群正式发布（GA）。 +- [TiDB Node Groups](/tidb-cloud/tidb-node-group-overview.md) 功能现已在 AWS 和 Google Cloud 上托管的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群正式发布（GA）。 - 该功能支持在单一集群内实现**细粒度计算资源隔离**，助你为多租户或多工作负载场景优化性能和资源分配。 + 该功能支持在单一集群内实现 **细粒度计算资源隔离**，助你为多租户或多工作负载场景优化性能和资源分配。 **主要优势：** - **资源隔离**： - 将 TiDB 节点分组为逻辑隔离单元，确保一个组内的工作负载不会影响其他组。 - - 防止应用或业务单元间资源争用。 + - 防止应用或业务单元间的资源争用。 - **简化管理**： - 在单一集群内统一管理所有节点组，降低运维开销。 - 可按需独立扩展各组。 - 详细优势参见 [技术博客](https://www.pingcap.com/blog/tidb-cloud-node-groups-scaling-workloads-predictable-performance/)。快速上手参见 [管理 TiDB Node Groups](/tidb-cloud/tidb-node-group-management.md)。 + 了解更多优势，请参见 [技术博客](https://www.pingcap.com/blog/tidb-cloud-node-groups-scaling-workloads-predictable-performance/)。快速上手，请参见 [管理 TiDB Node Group](/tidb-cloud/tidb-node-group-management.md)。 -- 在 AWS 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群 TiKV 节点引入 [Standard storage](/tidb-cloud/size-your-cluster.md#standard-storage) 类型。 +- 在 AWS 上托管的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群引入 [Standard storage](/tidb-cloud/size-your-cluster.md#standard-storage) 类型的 TiKV 节点。 - Standard storage 类型适用于大多数工作负载，在性能和成本之间实现平衡。 + Standard storage 类型适用于大多数工作负载，在性能与成本之间实现平衡。 **主要优势：** - - **性能提升**：为 Raft 日志预留充足磁盘资源，减少 Raft 与数据存储的 I/O 争用，提升 TiKV 读写性能。 + - **性能提升**：为 Raft 日志预留充足磁盘资源，减少 Raft 与数据存储的 I/O 争用，提升 TiKV 的读写性能。 - **稳定性增强**：将关键 Raft 操作与数据工作负载隔离，确保更可预测的性能。 - - **成本效益**：与原有存储类型相比，以更具竞争力的价格提供更高性能。 + - **成本效益**：相比旧存储类型，以更具竞争力的价格提供更高性能。 **可用性：** - 2025 年 4 月 1 日及以后在 AWS 上新建的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群，且版本 >= 7.5.5、8.1.2 或 8.5.0，自动采用 Standard storage 类型。现有集群仍使用原有 [Basic storage](/tidb-cloud/size-your-cluster.md#basic-storage) 类型，无需迁移。 + Standard storage 类型会自动应用于 2025 年 4 月 1 日及以后在 AWS 上新建的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群，且需支持的版本（>= 7.5.5、8.1.2 或 8.5.0）。现有集群仍使用旧的 [Basic storage](/tidb-cloud/size-your-cluster.md#basic-storage) 类型，无需迁移。 - Standard storage 的价格与 Basic storage 不同。详情参见 [价格](https://www.pingcap.com/tidb-dedicated-pricing-details/)。 + Standard storage 的价格与 Basic storage 不同。详情请参见 [价格说明](https://www.pingcap.com/tidb-dedicated-pricing-details/)。 ## 2025 年 3 月 25 日 **控制台变更** -- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群现支持为公网端点配置防火墙规则。 +- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群现已支持为公网端点配置防火墙规则。 你现在可以为 TiDB Cloud Serverless 集群配置防火墙规则，控制公网端点的访问。可在 [TiDB Cloud 控制台](https://tidbcloud.com/) 直接指定允许的 IP 地址或范围，提升安全性。 - 详情参见 [为 TiDB Cloud Serverless 公网端点配置防火墙规则](/tidb-cloud/configure-serverless-firewall-rules-for-public-endpoints.md)。 + 了解更多信息，请参见 [为 TiDB Cloud Serverless 公网端点配置防火墙规则](/tidb-cloud/configure-serverless-firewall-rules-for-public-endpoints.md)。 ## 2025 年 3 月 18 日 **通用变更** -- 支持为 Google Cloud 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群创建 TiDB 节点组，提升资源管理灵活性。 +- 支持为 Google Cloud 上部署的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群创建 TiDB 节点组，提升资源管理灵活性。 - 详情参见 [TiDB Node Group 概览](/tidb-cloud/tidb-node-group-overview.md)。 + 了解更多信息，请参见 [TiDB Node Group 概述](/tidb-cloud/tidb-node-group-overview.md)。 -- 支持将数据库审计日志文件存储在 TiDB Cloud，用于 AWS 上的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群。 +- 支持将数据库审计日志文件存储在 TiDB Cloud，适用于 AWS 上部署的 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群。 你可以直接从 TiDB Cloud 下载这些审计日志文件。该功能仅支持按需申请。 - 详情参见 [数据库审计日志](/tidb-cloud/tidb-cloud-auditing.md)。 + 了解更多信息，请参见 [数据库审计日志](/tidb-cloud/tidb-cloud-auditing.md)。 -- 通过优化多因素认证（MFA）管理，提升 TiDB Cloud 账户安全。该功能适用于 TiDB Cloud 的密码登录。 +- 通过优化多因素认证（MFA）管理，增强 TiDB Cloud 账户安全。该功能适用于 TiDB Cloud 的密码登录。 - 详情参见 [密码认证](/tidb-cloud/tidb-cloud-password-authentication.md)。 + 了解更多信息，请参见 [密码认证](/tidb-cloud/tidb-cloud-password-authentication.md)。 ## 2025 年 2 月 18 日 @@ -715,40 +744,40 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - 推出 Connected Care，TiDB Cloud 的全新支持服务。 - Connected Care 服务通过现代通信工具、主动支持和先进 AI 能力，强化你与 TiDB Cloud 的连接，带来无缝、以客户为中心的体验。 + Connected Care 服务通过现代通信工具、主动支持和先进 AI 能力，增强你与 TiDB Cloud 的连接，带来无缝且以客户为中心的体验。 - Connected Care 服务包括以下功能： + Connected Care 服务包含以下功能： - **Clinic service**：高级监控与诊断，优化性能。 - **AI chat in IM**：通过即时通讯工具获得 AI 实时协助。 - - **IM 订阅报警/告警与工单进展**：通过 IM 实时获知报警/告警和工单进展。 - - **IM 工单交互**：通过 IM 工具创建和跟进支持工单。 + - **IM 订阅报警/告警和工单进展**：通过 IM 实时获知报警/告警和工单进展。 + - **IM 工单交互**：可通过 IM 工具创建和交互支持工单。 - 详情参见 [Connected Care 概览](/tidb-cloud/connected-care-overview.md)。 + 了解更多信息，请参见 [Connected Care 概述](/tidb-cloud/connected-care-overview.md)。 -- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群现支持从 GCS 和 Azure Blob Storage 导入数据。 +- 支持从 GCS 和 Azure Blob Storage 导入数据到 [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群。 - TiDB Cloud Serverless 现支持从 Google Cloud Storage (GCS) 和 Azure Blob Storage 导入数据。你可以使用 Google Cloud 服务账户密钥或 Azure SAS token 认证。该功能简化了数据迁移到 TiDB Cloud Serverless。 + TiDB Cloud Serverless 现已支持从 Google Cloud Storage（GCS）和 Azure Blob Storage 导入数据。你可以使用 Google Cloud service account key 或 Azure SAS token 进行认证。该功能简化了数据迁移到 TiDB Cloud Serverless。 - 详情参见 [从 Amazon S3、GCS 或 Azure Blob Storage 导入 CSV 文件到 TiDB Cloud Serverless](/tidb-cloud/import-csv-files-serverless.md) 和 [从 Amazon S3、GCS 或 Azure Blob Storage 导入 Apache Parquet 文件到 TiDB Cloud Serverless](/tidb-cloud/import-parquet-files-serverless.md)。 + 了解更多信息，请参见 [从 Amazon S3、GCS 或 Azure Blob Storage 导入 CSV 文件到 TiDB Cloud Serverless](/tidb-cloud/import-csv-files-serverless.md) 和 [从 Amazon S3、GCS 或 Azure Blob Storage 导入 Apache Parquet 文件到 TiDB Cloud Serverless](/tidb-cloud/import-parquet-files-serverless.md)。 ## 2025 年 1 月 21 日 **控制台变更** -- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群现支持每次任务导入单个本地 CSV 文件，文件大小上限由 50 MiB 提升至 250 MiB。 +- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群单次任务支持导入最大 250 MiB 的本地 CSV 文件（此前为 50 MiB）。 - 详情参见 [导入本地文件到 TiDB Cloud](/tidb-cloud/tidb-cloud-import-local-files.md)。 + 了解更多信息，请参见 [导入本地文件到 TiDB Cloud](/tidb-cloud/tidb-cloud-import-local-files.md)。 ## 2025 年 1 月 14 日 **通用变更** -- [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群新增 AWS region：`Jakarta (ap-southeast-3)`。 +- [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群新增支持 AWS Region：`Jakarta (ap-southeast-3)`。 -- 推出 Notification 功能，让你通过 [TiDB Cloud 控制台](https://tidbcloud.com/) 实时获知 TiDB Cloud 更新和报警/告警。 +- 推出 Notification 功能，让你可通过 [TiDB Cloud 控制台](https://tidbcloud.com/) 实时获知 TiDB Cloud 更新和报警/告警。 - 详情参见 [Notifications](/tidb-cloud/notifications.md)。 + 了解更多信息，请参见 [Notifications](/tidb-cloud/notifications.md)。 ## 2025 年 1 月 2 日 @@ -756,57 +785,61 @@ aliases: ['/tidbcloud/supported-tidb-versions','/tidbcloud/release-notes'] - 支持为 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群创建 TiDB 节点组，提升资源管理灵活性。 - 详情参见 [TiDB Node Group 概览](/tidb-cloud/tidb-node-group-overview.md)。 + 了解更多信息，请参见 [TiDB Node Group 概述](/tidb-cloud/tidb-node-group-overview.md)。 + +- 支持通过 Private Connect（Beta）将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群连接到 AWS 和 Google Cloud 上的通用 Kafka。 -- 支持通过 Private Connect（beta）将 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群连接到 AWS 和 Google Cloud 上的通用 Kafka。 + Private Connect 利用云服务商的 Private Link 或 Private Service Connect 技术，使 TiDB Cloud VPC 内的变更数据流可通过私有 IP 连接到客户 VPC 内的 Kafka，就像这些 Kafka 直接托管在 TiDB Cloud VPC 内一样。该功能有助于避免 VPC CIDR 冲突，满足安全合规要求。 - Private Connect 利用云服务商的 Private Link 或 Private Service Connect 技术，使 TiDB Cloud VPC 内的 changefeed 可通过私有 IP 连接客户 VPC 内的 Kafka，仿佛这些 Kafka 直接托管在 TiDB Cloud VPC 内。该功能有助于避免 VPC CIDR 冲突，满足安全合规要求。 + - 对于 AWS 上的 Apache Kafka，请参见 [在 AWS 上配置自建 Kafka Private Link Service](/tidb-cloud/setup-aws-self-hosted-kafka-private-link-service.md) 进行网络配置。 - - AWS 上的 Apache Kafka，参见 [在 AWS 配置自建 Kafka Private Link 服务](/tidb-cloud/setup-aws-self-hosted-kafka-private-link-service.md)。 - - Google Cloud 上的 Apache Kafka，参见 [在 Google Cloud 配置自建 Kafka Private Service Connect](/tidb-cloud/setup-self-hosted-kafka-private-service-connect.md)。 + - 对于 Google Cloud 上的 Apache Kafka，请参见 [在 Google Cloud 上配置自建 Kafka Private Service Connect](/tidb-cloud/setup-self-hosted-kafka-private-service-connect.md) 进行网络配置。 注意，使用该功能会产生额外的 [Private Data Link 费用](/tidb-cloud/tidb-cloud-billing-ticdc-rcu.md#private-data-link-cost)。 - 详情参见 [Changefeed 下沉到 Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md#network)。 + 了解更多信息，请参见 [变更数据流下沉到 Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md#network)。 -- Kafka changefeed 新增可配置选项： +- Kafka 变更数据流新增可配置选项： + + - 支持使用 Debezium 协议。Debezium 是一种数据库变更捕获工具。它将每个捕获的数据库变更转换为事件消息，并发送到 Kafka。了解更多信息，请参见 [TiCDC Debezium 协议](https://docs.pingcap.com/tidb/v8.1/ticdc-debezium)。 - - 支持使用 Debezium 协议。Debezium 是数据库变更捕获工具，将每个捕获的数据库变更转换为事件消息并发送到 Kafka。详情参见 [TiCDC Debezium 协议](https://docs.pingcap.com/tidb/v8.1/ticdc-debezium)。 - 支持为所有表定义单一分区分发器，或为不同表定义不同分区分发器。 - - 新增两种分发器类型：按时间戳和按列值分区分发 Kafka 消息。 - 详情参见 [下沉到 Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md)。 + - 新增两种分发器类型：按时间戳分区和按列值分区。 + + 了解更多信息，请参见 [下沉到 Apache Kafka](/tidb-cloud/changefeed-sink-to-apache-kafka.md)。 - TiDB Cloud 角色增强： - - 新增 `Project Viewer` 和 `Organization Billing Viewer` 角色，实现更细粒度的访问控制。 + - 新增 `Project Viewer` 和 `Organization Billing Viewer` 角色，实现更细粒度的 TiDB Cloud 访问控制。 + - 重命名以下角色： - `Organization Member` 改为 `Organization Viewer` - `Organization Billing Admin` 改为 `Organization Billing Manager` - `Organization Console Audit Admin` 改为 `Organization Console Audit Manager` - 详情参见 [身份访问管理](/tidb-cloud/manage-user-access.md#organization-roles)。 + 了解更多信息，请参见 [身份访问管理](/tidb-cloud/manage-user-access.md#organization-roles)。 -- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群区域高可用性（beta）。 +- [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 集群区域高可用性（Beta）。 - 该功能适用于对基础设施冗余和业务可持续性有极高要求的工作负载。主要特性： + 该功能适用于对基础设施冗余和业务可持续性有极高要求的工作负载。主要功能包括： - - 节点分布于多个可用区，确保单区故障时高可用性。 - - 关键 OLTP 组件（如 PD、TiKV）跨可用区多副本冗余。 - - 主区故障时自动故障转移，最小化服务中断。 + - 节点分布在多个可用区，确保主可用区故障时的高可用性。 + - 关键 OLTP 组件（如 PD 和 TiKV）在可用区间多副本冗余。 + - 主可用区故障时自动故障转移，最小化 service 中断。 - 该功能目前仅在 AWS Tokyo (ap-northeast-1) region 可用，且仅在集群创建时可启用。 + 该功能目前仅在 AWS Tokyo（ap-northeast-1）Region 提供，且仅可在集群创建时启用。 - 详情参见 [TiDB Cloud Serverless 的高可用性](/tidb-cloud/serverless-high-availability.md)。 + 了解更多信息，请参见 [TiDB Cloud Serverless 的高可用性](/tidb-cloud/serverless-high-availability.md)。 - 新建 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的默认 TiDB 版本从 [v8.1.1](https://docs.pingcap.com/tidb/v8.1/release-8.1.1) 升级到 [v8.1.2](https://docs.pingcap.com/tidb/v8.1/release-8.1.2)。 **控制台变更** -- 数据导出服务增强： +- 数据导出 service 增强： - - 支持通过 [TiDB Cloud 控制台](https://tidbcloud.com/) 将 [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 数据导出到 Google Cloud Storage 和 Azure Blob Storage。 + - 支持通过 [TiDB Cloud 控制台](https://tidbcloud.com/) 将数据从 [TiDB Cloud Serverless](/tidb-cloud/select-cluster-tier.md#starter) 导出到 Google Cloud Storage 和 Azure Blob Storage。 - 支持通过 [TiDB Cloud 控制台](https://tidbcloud.com/) 导出 Parquet 文件格式数据。 - 详情参见 [从 TiDB Cloud Serverless 导出数据](/tidb-cloud/serverless-export.md) 和 [为 TiDB Cloud Serverless 配置外部存储访问](/tidb-cloud/configure-external-storage-access.md)。 \ No newline at end of file + 了解更多信息，请参见 [从 TiDB Cloud Serverless 导出数据](/tidb-cloud/serverless-export.md) 和 [为 TiDB Cloud Serverless 配置外部存储访问](/tidb-cloud/configure-external-storage-access.md)。 \ No newline at end of file diff --git a/tidb-cloud/tiproxy-management.md b/tidb-cloud/tiproxy-management.md new file mode 100644 index 0000000000000..62457934d3f0b --- /dev/null +++ b/tidb-cloud/tiproxy-management.md @@ -0,0 +1,128 @@ +--- +title: 管理 TiProxy +summary: 了解如何启用、禁用、查看和修改 TiProxy。 +--- + +# 管理 TiProxy + +本文档介绍如何启用、禁用、查看和修改 TiProxy。 + +> **注意：** +> +> TiProxy 目前处于 beta 阶段，仅适用于部署在 AWS 上的 TiDB Cloud Dedicated 集群。 + +## 启用 TiProxy + +你可以在任何 TiDB 节点组中为新集群或现有集群启用 TiProxy。 + +### 决定 TiProxy 节点的规格和数量 + +TiProxy 节点的规格和数量取决于集群的 QPS 和网络带宽。网络带宽是客户端请求和 TiDB 响应带宽的总和。 + +下表展示了每种 TiProxy 规格的最大 QPS 和网络带宽。 + +| 规格 | 最大 QPS | 最大网络带宽 | +| :---- | :------- | :------------------- | +| Small | 30K | 93 MiB/s | +| Large | 120K | 312 MiB/s | + +可用的 TiProxy 规格为 `Small` 和 `Large`。可用的 TiProxy 节点数量为 2、3、6、9、12、15、18、21 和 24。默认的两个 Small 规格 TiProxy 节点可提供 60K QPS 和 186 MiB/s 网络带宽。建议预留 20% 的 QPS 容量以防止高延时。 + +例如，如果你的集群最大 QPS 为 100K，最大网络带宽为 100 MiB/s，则 TiProxy 节点的规格和数量主要取决于 QPS。在这种情况下，你可以选择 6 个 Small 规格的 TiProxy 节点。 + +### 为新集群启用 TiProxy + +在创建新集群时启用 TiProxy，点击 TiProxy 开关并选择 TiProxy 的规格和数量。 + +![Enable TiProxy](/media/tidb-cloud/tiproxy-enable-tiproxy.png) + +### 为现有集群启用 TiProxy + +> **注意：** +> +> 启用 TiProxy 会导致对应 TiDB 节点组中的 TiDB 节点滚动重启，重启期间会断开现有连接。此外，创建新连接可能会假死最长 30 秒。请确保在维护窗口内启用 TiProxy。 + +为现有集群启用 TiProxy，请执行以下步骤： + +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，然后点击目标集群名称进入其概览页面。 +2. 点击右上角的 **...**，在下拉菜单中点击 **Modify**。此时会显示 **Modify Cluster** 页面。 +3. 在 **Modify Cluster** 页面，点击 TiProxy 开关并选择 TiProxy 的规格和数量。 + +![Enable TiProxy](/media/tidb-cloud/tiproxy-enable-tiproxy.png) + +### 限制与配额 + +- 每个 TiDB 节点组中至少需要有两个 TiDB 节点。 +- TiDB 节点规格至少为 4 vCPU。 +- 组织中 TiProxy 节点的默认最大数量为 `10`。更多信息参见 [Limitations and Quotas](/tidb-cloud/limitations-and-quotas.md)。 +- TiDB 集群的版本必须为 v6.5.0 或更高。 + +## 禁用 TiProxy + +> **注意：** +> +> 禁用 TiProxy 会导致连接断开。此外，创建新连接可能会假死最长 10 秒。请确保在维护窗口内禁用 TiProxy。 + +要禁用 TiProxy，请执行以下步骤： + +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，然后点击目标集群名称进入其概览页面。 +2. 点击右上角的 **...**，在下拉菜单中点击 **Modify**。此时会显示 **Modify Cluster** 页面。 +3. 在 **Modify Cluster** 页面，点击 TiProxy 开关以禁用 TiProxy。 + +![Disable TiProxy](/media/tidb-cloud/tiproxy-disable-tiproxy.png) + +## 查看 TiProxy + +### 查看 TiProxy 拓扑结构 + +要查看 TiProxy 拓扑结构，请执行以下步骤： + +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，然后点击目标集群名称进入其概览页面。 +2. 在左侧导航栏点击 **Monitoring > Nodes**。此时会显示 **Node Map** 页面。 +3. 在 **Node Map** 页面，TiProxy 拓扑结构显示在 **TiDB** 面板中。 + +![TiProxy Topology](/media/tidb-cloud/tiproxy-topology.png) + +### 查看 TiProxy 统计/指标（信息） + +要查看 TiProxy 统计/指标（信息），请执行以下步骤： + +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，然后点击目标集群名称进入其概览页面。 +2. 在左侧导航栏点击 **Monitoring > Metrics**。此时会显示 **Metrics** 页面。 +3. 在 **Metrics** 页面，点击 **Server** 并下拉至 TiProxy 相关统计/指标（信息）。如需查看特定 TiDB 节点组的 TiProxy 统计/指标（信息），点击 **TiDB Node Group View**，选择你的 TiDB 节点组，然后下拉至 TiProxy 相关统计/指标（信息）。 + +这些统计/指标（信息）包括： + +- **TiProxy CPU Usage**：每个 TiProxy 节点的 CPU 使用率统计。上限为 100%。如果最大 CPU 使用率超过 80%，建议扩容 TiProxy。 +- **TiProxy Connections**：每个 TiProxy 节点上的连接数。 +- **TiProxy Throughput**：每个 TiProxy 节点每秒传输的字节数。如果最大吞吐达到最大网络带宽，建议扩容 TiProxy。关于最大网络带宽的更多信息，参见 [决定 TiProxy 节点的规格和数量](#决定-tiproxy-节点的规格和数量)。 +- **TiProxy Sessions Migration Reasons**：每分钟发生的会话迁移次数及其原因。例如，当 TiDB 缩容且 TiProxy 将会话迁移到其他 TiDB 节点时，原因为 `status`。更多迁移原因，参见 [TiProxy Monitoring Metrics](https://docs.pingcap.com/tidb/stable/tiproxy-grafana#balance)。 + +### 查看 TiProxy 账单 + +要查看 TiProxy 账单，请执行以下步骤： + +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com) 中，使用左上角的下拉框切换到目标组织。 +2. 在左侧导航栏点击 **Billing**。在 **Billing** 页面，默认显示 **Bills** 标签页。 +3. 在 **Summary by Service** 部分，TiProxy 节点费用显示在 **TiDB Dedicated** 下，而 TiProxy 数据传输费用包含在 **Data Transfer > Same Region** 中。 + +![TiProxy Billing](/media/tidb-cloud/tiproxy-billing.png) + +## 修改 TiProxy + +> **注意** +> +> - 不支持直接修改 TiProxy 规格。建议你修改 TiProxy 节点数量。如果必须修改 TiProxy 规格，需要在所有 TiDB 节点组中禁用 TiProxy，然后重新启用以选择不同规格。 +> - 缩容 TiProxy 会导致连接断开。请确保在维护窗口内进行缩容操作。 + +要对 TiProxy 进行扩容或缩容，请执行以下步骤： + +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入项目的 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，然后点击目标集群名称进入其概览页面。 +2. 点击右上角的 **...**，在下拉菜单中点击 **Modify**。此时会显示 **Modify Cluster** 页面。 +3. 在 **Modify Cluster** 页面，修改 TiProxy 节点的数量。 + +![Modify TiProxy](/media/tidb-cloud/tiproxy-enable-tiproxy.png) + +## 在多个 TiDB 节点组中管理 TiProxy + +当你拥有多个 TiDB 节点组时，每个 TiDB 节点组都有其专属的 TiProxy 组。TiProxy 会将流量路由到同一 TiDB 节点组中的 TiDB 节点，以实现计算资源隔离。你可以在每个 TiDB 节点组中启用、禁用或修改 TiProxy。但所有 TiDB 节点组中的 TiProxy 规格必须保持一致。 \ No newline at end of file diff --git a/tidb-cloud/tiproxy-overview-for-cloud.md b/tidb-cloud/tiproxy-overview-for-cloud.md new file mode 100644 index 0000000000000..3a781d47b5978 --- /dev/null +++ b/tidb-cloud/tiproxy-overview-for-cloud.md @@ -0,0 +1,47 @@ +--- +title: TiDB Cloud 中 TiProxy 概述 +summary: 了解 TiDB Cloud 中 TiProxy 的使用场景。 +--- + +# TiDB Cloud 中 TiProxy 概述 + +TiProxy 是 PingCAP 官方的代理组件。它位于客户端与 TiDB 服务器之间，为 TiDB 提供负载均衡、连接保持等功能。 + +更多信息，参见 [TiProxy 概述](https://docs.pingcap.com/tidb/stable/tiproxy-overview)。 + +> **注意：** +> +> TiProxy 目前处于 beta 阶段，仅适用于部署在 AWS 上的 TiDB Cloud Dedicated 集群。 + +## 场景 + +TiProxy 适用于以下场景： + +- 连接保持：当 TiDB 服务器进行缩容、滚动升级或滚动重启时，客户端连接会断开，导致报错。如果客户端没有幂等的错误重试机制，则需要手动排查和修复错误，极大增加了运维开销。TiProxy 可以保持客户端连接，使客户端不会报错。 +- 频繁缩容与扩容：应用的工作负载可能会周期性变化。为了节省成本，你可以在云上部署 TiDB，并根据工作负载自动缩容和扩容 TiDB 服务器。但缩容可能导致客户端断开连接，扩容可能导致负载不均。TiProxy 可以保持客户端连接，并实现负载均衡。 +- CPU 负载不均：当后台任务消耗大量 CPU 资源，或不同连接的工作负载差异较大，导致 CPU 负载不均时，TiProxy 可以根据 CPU 使用率迁移连接，实现负载均衡。更多详情，参见 [基于 CPU 的负载均衡](https://docs.pingcap.com/tidb/stable/tiproxy-load-balance#cpu-based-load-balancing)。 + +更多场景，参见 [TiProxy 用户场景](https://docs.pingcap.com/tidb/stable/tiproxy-overview#user-scenarios)。 + +## 限制 + +在以下场景下，TiProxy 无法保持客户端连接： + +- 升级 AWS EKS、Azure AKS、Google Cloud GKE 或阿里云 ACK。 +- 禁用、缩容、升级或重启 TiProxy。 +- 单条语句或事务运行超过 20 秒。如果你的应用需要更长的超时时间，请联系 [TiDB Cloud 支持](/tidb-cloud/tidb-cloud-support.md)。 + +更多场景，参见 [TiProxy 限制](https://docs.pingcap.com/tidb/stable/tiproxy-overview#limitations)。 + +## 计费 + +TiProxy 会引入两类成本： + +- 节点成本。更多信息，参见 [节点成本](https://www.pingcap.com/tidb-dedicated-pricing-details/#node-cost) +- 数据传输成本。更多信息，参见 [数据传输成本](https://www.pingcap.com/tidb-dedicated-pricing-details/#data-transfer-cost)。TiProxy 优先将流量路由到同一可用区（AZ）的 TiDB 节点。但如果 TiDB 工作负载不均，也会将流量路由到其他可用区，这可能会产生额外的数据传输成本。 + +你可以在 **Billing** 页面查看 TiProxy 账单。更多信息，参见 [查看 TiProxy 账单](/tidb-cloud/tiproxy-management.md#view-tiproxy-bills)。 + +## SLA 影响 + +TiProxy 对 SLA 没有影响。 \ No newline at end of file diff --git a/tidb-cloud/use-tidb-cloud-with-ai-tools.md b/tidb-cloud/use-tidb-cloud-with-ai-tools.md new file mode 100644 index 0000000000000..25141d04ede04 --- /dev/null +++ b/tidb-cloud/use-tidb-cloud-with-ai-tools.md @@ -0,0 +1,163 @@ +--- +title: 使用 TiDB Cloud Starter 搭配 AI 工具 +summary: 了解如何将 TiDB Cloud Starter 集群连接到支持 Model Context Protocol (MCP) 的 AI 驱动开发工具，如 Cursor、Claude Code、VS Code 和 Windsurf。 +--- + +# 使用 TiDB Cloud Starter 搭配 AI 工具 + +本文介绍如何将 TiDB Cloud Starter 集群连接到支持 Model Context Protocol (MCP) 的 AI 驱动开发工具，如 Cursor、Claude Code、Visual Studio Code (VS Code) 和 Windsurf。 + +通过将 TiDB Cloud Starter 集群配置为 MCP 服务器，你可以让开发工具中的 AI 助手查询你的数据库 schema，理解你的数据模型，并生成具备上下文感知的代码建议。 + +## 开始之前 + +完成本指南，你需要准备以下内容： + +- 一个 TiDB Cloud Starter 集群。如果你还没有，可以[创建一个 TiDB Cloud Starter 集群](/develop/dev-guide-build-cluster-in-cloud.md)。 +- 已安装 [Python 3.11 或更高版本](https://www.python.org/downloads/)。 +- 已安装 [uv](https://docs.astral.sh/uv/getting-started/installation/)。 +- 一个支持 MCP 的 AI 开发工具，例如： + + - [Cursor](https://cursor.com) + - [Claude Code](https://claude.com/product/claude-code) + - [Visual Studio Code](https://code.visualstudio.com) + - [Windsurf](https://windsurf.com) + +## 连接到 AI 工具 + +在 TiDB Cloud 中创建 TiDB Cloud Starter 集群后，按照以下步骤将其连接到你的 AI 工具。 + +1. 在 [**Clusters**](https://tidbcloud.com/project/clusters) 页面，点击目标集群名称进入其概览页面。然后，点击右上角的 **Use with AI Tools**。 +2. 在 **Access `your_cluster_name` with AI tools** 对话框中，选择你希望 AI 工具访问的 **Branch** 和 **Database**。 +3. 确认你已满足所有 **Prerequisites**（前置条件）。如未满足，请按照屏幕提示安装所需依赖。 +4. 配置密码： + + - 如果你尚未设置密码，点击 **Generate Password** 生成一个随机密码。 + + 生成的密码只会显示一次，请妥善保存到安全的位置。 + + - 如果你已设置过密码，在 **Enter the password for easy setup** 字段输入你的密码。 + - 如果你忘记了密码，在 **Prerequisites** 部分点击 **Reset password** 生成新密码。 + + 注意，重置密码会断开所有现有 root 用户会话。 + +5. 选择你的 AI 工具对应的标签页：**Cursor**、**Claude Code**、**VS Code** 或 **Windsurf**。 +6. 按照所选工具的设置步骤完成配置。 + + 更多信息请参见 [特定工具设置](#tool-specific-setup)。 + +## 特定工具设置 + +### Cursor + +要将 Cursor 配置为 TiDB 的 MCP 客户端，你可以使用以下任一方法： + +- **方法 1**：在 [TiDB Cloud 控制台](https://tidbcloud.com) 的 **Access `your_cluster_name` with AI tools** 对话框中，点击 **Add to Cursor** 启动 Cursor，然后点击 **Install**。 +- **方法 2**：手动将以下配置添加到你的 `.cursor/mcp.json` 文件中： + + ```json + { + "mcpServers": { + "TiDB": { + "command": "uvx --from pytidb[mcp] tidb-mcp-server", + "env": { + "TIDB_HOST": "", + "TIDB_PORT": "", + "TIDB_USERNAME": "", + "TIDB_PASSWORD": "", + "TIDB_DATABASE": "" + } + } + } + } + ``` + +### Claude Code + +要将 Claude Code 配置为 TiDB 的 MCP 客户端，你可以使用以下任一方法： + +- **方法 1**：在 [TiDB Cloud 控制台](https://tidbcloud.com/) 的 **Access `your_cluster_name` with AI tools** 对话框中复制设置命令，并在终端中运行： + + ```bash + claude mcp add --transport stdio TiDB \ + --env TIDB_HOST='' \ + --env TIDB_PORT= \ + --env TIDB_USERNAME='' \ + --env TIDB_PASSWORD='' \ + --env TIDB_DATABASE='' \ + -- uvx --from 'pytidb[mcp]' 'tidb-mcp-server' + ``` + +- **方法 2**：将以下配置添加到你的项目级 `.mcp.json` 文件中。更多信息请参见 [Claude Code 文档](https://code.claude.com/docs/en/mcp#project-scope)。 + + ```json + { + "mcpServers": { + "TiDB": { + "type": "stdio", + "command": "uvx", + "args": ["--from", "pytidb[mcp]", "tidb-mcp-server"], + "env": { + "TIDB_HOST": "", + "TIDB_PORT": "", + "TIDB_USERNAME": "", + "TIDB_PASSWORD": "", + "TIDB_DATABASE": "" + } + } + } + } + ``` + +### VS Code + +要将 VS Code 配置为 TiDB 的 MCP 客户端，你可以使用以下任一方法： + +- **方法 1**：在 [TiDB Cloud 控制台](https://tidbcloud.com/) 的 **Access `your_cluster_name` with AI tools** 对话框中，点击 **Add to VS Code** 启动 VS Code，然后点击 **Install**。 +- **方法 2**：将以下配置添加到你的 `.vscode/mcp.json` 文件中： + + ```json + { + "mcpServers": { + "TiDB": { + "type": "stdio", + "command": "uvx", + "args": ["--from", "pytidb[mcp]", "tidb-mcp-server"], + "env": { + "TIDB_HOST": "", + "TIDB_PORT": "", + "TIDB_USERNAME": "", + "TIDB_PASSWORD": "", + "TIDB_DATABASE": "" + } + } + } + } + ``` + +### Windsurf + +要将 TiDB MCP 插件添加到 Windsurf，请按如下方式更新你的 `mcp_config.json` 文件。更多信息请参见 [Windsurf 文档](https://docs.windsurf.com/windsurf/cascade/mcp#adding-a-new-mcp-plugin)。 + +```json +{ + "mcpServers": { + "TiDB": { + "command": "uvx", + "args": ["--from", "pytidb[mcp]", "tidb-mcp-server"], + "env": { + "TIDB_HOST": "", + "TIDB_PORT": "", + "TIDB_USERNAME": "", + "TIDB_PASSWORD": "", + "TIDB_DATABASE": "" + } + } + } +} +``` + +## 另请参阅 + +- [体验 TiDB + 向量检索](/vector-search/vector-search-get-started-using-python.md) +- [开发者指南总览](/develop/dev-guide-overview.md)
API✅
（公开预览）		✅
（公开预览）		✅
（公开预览）		✅
（公测）		✅
（公测）		✅
（公测）
集群管理
数据迁移 ❌✅
（私有预览）		✅
（私测）		 ✅
数据导出 导出✅
（公开预览）		✅
（公开预览）		✅
（公测）		✅
（公测）		 ❌
变更数据订阅（Changefeed） ❌✅
（CLI 私有预览）		✅
（公测）		 ✅
数据库审计日志 ❌✅
（私有预览）		✅
（私测）		 ✅
AI 与开发 向量检索✅
（公开预览）		✅
（公开预览）		✅
（公开预览）		✅
（公测）		✅
（公测）		✅
（公测）
数据分支