diff --git a/TOC-tidb-cloud-essential.md b/TOC-tidb-cloud-essential.md index 4b5c6cd5939fe..59aa3270d6754 100644 --- a/TOC-tidb-cloud-essential.md +++ b/TOC-tidb-cloud-essential.md @@ -37,10 +37,6 @@ - [通过 Public Endpoint 连接](/tidb-cloud/connect-via-standard-connection-serverless.md) - [通过 AWS Private Endpoint 连接](/tidb-cloud/set-up-private-endpoint-connections-serverless.md) - [通过 Alibaba Cloud Private Endpoint 连接](/tidb-cloud/set-up-private-endpoint-connections-on-alibaba-cloud.md) - - 分支 ![BETA](/media/tidb-cloud/blank_transparent_placeholder.png) - - [概览](/tidb-cloud/branch-overview.md) - - [管理分支](/tidb-cloud/branch-manage.md) - - [GitHub 集成](/tidb-cloud/branch-github-integration.md) - [备份和恢复 TiDB Cloud 数据](/tidb-cloud/backup-and-restore-serverless.md) - [从 TiDB Cloud 导出数据](/tidb-cloud/serverless-export.md) - 使用 TiFlash 实现 HTAP @@ -546,7 +542,7 @@ - [MSP 客户](/tidb-cloud/managed-service-provider-customer.md) - [经销商的客户](/tidb-cloud/cppo-customer.md) - [{{{ .starter }}} 和 Essential 的使用限制](/tidb-cloud/serverless-limitations.md) - - [TiDB Cloud 上的 SQL 功能限制](/tidb-cloud/limited-sql-features.md) + - [TiDB X 实例上的有限 SQL 功能](/tidb-cloud/limited-sql-features-tidb-x.md) - [TiDB 限制](/tidb-limitations.md) - [系统变量](/system-variables.md) - [服务器状态变量](/status-variables.md) diff --git a/TOC-tidb-cloud-premium.md b/TOC-tidb-cloud-premium.md index 651ba883e10bf..9570c8afed08e 100644 --- a/TOC-tidb-cloud-premium.md +++ b/TOC-tidb-cloud-premium.md @@ -457,7 +457,7 @@ - [TiDB Cloud 合作伙伴](/tidb-cloud/tidb-cloud-partners.md) - [MSP 客户](/tidb-cloud/managed-service-provider-customer.md) - [经销商的客户](/tidb-cloud/cppo-customer.md) - - [TiDB Cloud 上的 SQL 功能限制](/tidb-cloud/limited-sql-features.md) + - [TiDB X 实例上的有限 SQL 功能](/tidb-cloud/limited-sql-features-tidb-x.md) - [TiDB 限制](/tidb-limitations.md) - [系统变量](/system-variables.md) - [服务器状态变量](/status-variables.md) diff --git a/TOC-tidb-cloud-starter.md b/TOC-tidb-cloud-starter.md index a6045b835343c..a5b33a59c03c6 100644 --- a/TOC-tidb-cloud-starter.md +++ b/TOC-tidb-cloud-starter.md @@ -536,7 +536,7 @@ - [MSP 客户](/tidb-cloud/managed-service-provider-customer.md) - [经销商的客户](/tidb-cloud/cppo-customer.md) - [{{{ .starter }}} 和 Essential 的使用限制](/tidb-cloud/serverless-limitations.md) - - [TiDB Cloud 上的 SQL 功能限制](/tidb-cloud/limited-sql-features.md) + - [TiDB X 实例上的有限 SQL 功能](/tidb-cloud/limited-sql-features-tidb-x.md) - [TiDB 限制](/tidb-limitations.md) - [系统变量](/system-variables.md) - [服务器状态变量](/status-variables.md) diff --git a/TOC-tidb-cloud.md b/TOC-tidb-cloud.md index 8fae0e91d6ef7..07496578e3f73 100644 --- a/TOC-tidb-cloud.md +++ b/TOC-tidb-cloud.md @@ -589,7 +589,7 @@ - [介绍](/tidb-distributed-execution-framework.md) - [TiDB 全局排序](/tidb-global-sort.md) - [TiDB Cloud Dedicated 限制和配额](/tidb-cloud/limitations-and-quotas.md) - - [TiDB Cloud 上的 SQL 功能限制](/tidb-cloud/limited-sql-features.md) + - [TiDB Cloud Dedicated 上受限的 SQL 功能](/tidb-cloud/limited-sql-features.md) - [TiDB 限制](/tidb-limitations.md) - 基准测试 - TiDB v8.5 @@ -620,7 +620,7 @@ - [Connected Care 概述](/tidb-cloud/connected-care-overview.md) - [Connected Care 详情](/tidb-cloud/connected-care-detail.md) - Connected Care 支持服务 - - [Connected: Clinic Service](/tidb-cloud/tidb-cloud-clinic.md) + - [已连接：诊所服务](/tidb-cloud/tidb-cloud-clinic.md) - [Connected：IM 中的 AI 聊天](/tidb-cloud/connected-ai-chat-in-im.md) - Connected：通过 IM 订阅 TiDB Cloud 告警 - [通过 Slack 订阅](/tidb-cloud/monitor-alert-slack.md) diff --git a/latest_translation_commit.json b/latest_translation_commit.json index 37be1a4e65145..8dc13ce607203 100644 --- a/latest_translation_commit.json +++ b/latest_translation_commit.json @@ -1,4 +1,4 @@ { "target": "release-8.5", - "sha": "6a3301ed41e2d6edcc5f6d76f06fffdfe029acd5" + "sha": "42da4252914248472710bc8f9d3bb0546015093e" } diff --git a/mysql-compatibility.md b/mysql-compatibility.md index e070772909f1a..61b96d1b5718d 100644 --- a/mysql-compatibility.md +++ b/mysql-compatibility.md @@ -48,7 +48,7 @@ TiDB 高度兼容 MySQL 协议，以及 MySQL 5.7 和 MySQL 8.0 的常用特性 >**Note:** > - > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 和 TiDB Cloud Essential 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。TiDB 自建版和 TiDB Cloud Dedicated 支持解析 `FULLTEXT` 语法，但不支持使用 `FULLTEXT` 索引。 + > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。TiDB 自建版和 TiDB Cloud Dedicated 支持解析 `FULLTEXT` 语法，但不支持使用 `FULLTEXT` 索引。 + `SPATIAL`（也称为 `GIS`/`GEOMETRY`）函数、数据类型和索引 [#6347](https://github.com/pingcap/tidb/issues/6347) + 除 `ascii`、`latin1`、`binary`、`utf8`、`utf8mb4` 和 `gbk` 之外的字符集 diff --git a/pessimistic-transaction.md b/pessimistic-transaction.md index 51b242e25923b..c7dedd9f6085a 100644 --- a/pessimistic-transaction.md +++ b/pessimistic-transaction.md @@ -73,6 +73,10 @@ TiDB 中的悲观事务行为与 MySQL 类似。关于与 MySQL InnoDB 的细微 - 如果 `Point Get` 和 `Batch Point Get` 操作没有读取数据，它们仍会锁定给定的主键或唯一键，从而阻止其他事务锁定或写入相同的主键或唯一键。 + > **注意：** + > + > 此行为仅适用于 [Repeatable Read](/transaction-isolation-levels.md#repeatable-read-isolation-level) 隔离级别。在 [Read Committed](/transaction-isolation-levels.md#read-committed-isolation-level) 隔离级别下，`Point Get` 和 `Batch Point Get` 操作不会锁定不存在的键。 + - TiDB 支持 `FOR UPDATE OF TABLES` 语法。对于连接多个表的语句，TiDB 只会对与 `OF TABLES` 中表相关的行加悲观锁。 ## 与 MySQL InnoDB 的差异 diff --git a/sql-statements/sql-statement-add-index.md b/sql-statements/sql-statement-add-index.md index b9430b29bc948..add0f74de2ee9 100644 --- a/sql-statements/sql-statement-add-index.md +++ b/sql-statements/sql-statement-add-index.md @@ -100,7 +100,7 @@ mysql> EXPLAIN SELECT * FROM t1 WHERE c1 = 3; >**注意：** > - > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 和 TiDB Cloud Essential 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。 + > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。 * 不支持降序索引（与 MySQL 5.7 类似）。 * 不支持为表添加 `CLUSTERED` 类型的主键。关于 `CLUSTERED` 类型主键的更多信息，参见 [聚簇索引](/clustered-indexes.md)。 diff --git a/sql-statements/sql-statement-create-index.md b/sql-statements/sql-statement-create-index.md index 384d6fd888160..59a5b96140f43 100644 --- a/sql-statements/sql-statement-create-index.md +++ b/sql-statements/sql-statement-create-index.md @@ -388,7 +388,7 @@ CREATE UNIQUE INDEX c1 ON t1 (c1) INVISIBLE; >**注意：** > - > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 和 TiDB Cloud Essential 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。 + > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。 * TiDB 为兼容 MySQL，语法上接受 `HASH`、`BTREE` 和 `RTREE` 等索引类型，但会忽略它们。 * 不支持降序索引（与 MySQL 5.7 类似）。 diff --git a/sql-statements/sql-statement-create-table.md b/sql-statements/sql-statement-create-table.md index f15db3ebc577a..11ed35ee8d259 100644 --- a/sql-statements/sql-statement-create-table.md +++ b/sql-statements/sql-statement-create-table.md @@ -277,7 +277,7 @@ mysql> DESC t1; >**注意：** > - > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 和 TiDB Cloud Essential 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。 + > 目前，仅部分 AWS 区域的 TiDB Cloud Starter 实例支持 [`FULLTEXT` 语法和索引](https://docs.pingcap.com/tidbcloud/vector-search-full-text-search-sql)。 * 在分区表中，将 `PRIMARY KEY` 或 `UNIQUE INDEX` 设置为 [全局索引](/global-indexes.md)（通过 `GLOBAL` 索引选项）是 TiDB 的扩展功能，并不兼容 MySQL。 diff --git a/sql-statements/sql-statement-flashback-cluster.md b/sql-statements/sql-statement-flashback-cluster.md index 243dbb6c28387..fa5bc48bab5e3 100644 --- a/sql-statements/sql-statement-flashback-cluster.md +++ b/sql-statements/sql-statement-flashback-cluster.md @@ -11,7 +11,7 @@ TiDB v6.4.0 引入了 `FLASHBACK CLUSTER TO TIMESTAMP` 语法。你可以使用 > **Warning:** > -> `FLASHBACK CLUSTER TO [TIMESTAMP|TSO]` 语法不适用于 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) 和 [TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 实例。为避免出现不可预期的结果，请不要在 TiDB Cloud Starter 和 TiDB Cloud Essential 实例上执行该语句。 +> `FLASHBACK CLUSTER TO [TIMESTAMP|TSO]` 语法不适用于 [TiDB Cloud Starter](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter)、[TiDB Cloud Essential](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 和 [{{{ .premium }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#premium) 实例。为避免出现不可预期的结果，请不要在 TiDB Cloud Starter、Essential 和 Premium 实例上执行该语句。 > **Warning:** > diff --git a/system-variables.md b/system-variables.md index 42cd0406ebb4e..9ff5c44e0d7d7 100644 --- a/system-variables.md +++ b/system-variables.md @@ -1749,7 +1749,7 @@ mysql> SELECT job_info FROM mysql.analyze_jobs ORDER BY end_time DESC LIMIT 1; > **注意：** > -> 对于 [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter) 和 [{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 实例，该变量为只读。 +> 对于 [{{{ .starter }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#starter)、[{{{ .essential }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#essential) 和 [{{{ .premium }}}](https://docs.pingcap.com/tidbcloud/select-cluster-tier#premium) 实例，该变量为只读。 - 作用域：GLOBAL - 是否持久化到集群：是 diff --git a/tidb-cloud/backup-and-restore.md b/tidb-cloud/backup-and-restore.md index 1ff43239336d7..15ce9b71c16be 100644 --- a/tidb-cloud/backup-and-restore.md +++ b/tidb-cloud/backup-and-restore.md @@ -275,13 +275,7 @@ TiDB Cloud Dedicated 集群支持双区域备份，通过将集群所在区域 2. 点击 **Restore**，弹出设置窗口。 -3. 在 **Restore Mode** 中，选择 **Restore From Region**，即备份存储的区域。 - - > **注意** - > - > - **Restore From Region** 的默认值与备份集群相同。 - -4. 在 **Restore Mode** 中，选择将任意时间点的数据或选定备份恢复到新集群。 +3. 在 **Restore Mode** 中，选择将任意时间点的数据或选定备份恢复到新集群。
@@ -303,19 +297,24 @@ TiDB Cloud Dedicated 集群支持双区域备份，通过将集群所在区域
-5. 在 **Restore to Region** 中，选择与 **Backup Setting** 中配置的 **Primary Region** 相同的区域。 +4. 在 **Cloud Provider & Region** 中，选择新集群的目标区域。 -6. 在 **Restore** 窗口中，如有需要你还可以进行如下更改： + > **注意** + > + > - 默认情况下，新集群会恢复到与源集群相同的区域。 + > - 如果在 **Backup Setting** 中启用了 [**Dual Region Backup**](/tidb-cloud/backup-and-restore.md#turn-on-dual-region-backup)，你还可以选择将新集群恢复到为双区域备份配置的 **Secondary Region**。 + +5. 在 **Restore** 窗口中，如有需要你还可以进行如下更改： - 设置集群名称。 - 更新集群端口号。 - 增加集群节点数、vCPU 和内存、存储空间。 -7. 点击 **Restore**。 +6. 点击 **Restore**。 集群恢复流程启动，并弹出 **Password Settings** 对话框。 -8. 在 **Password Settings** 对话框中，设置连接 TiDB Cloud Dedicated 集群的 root 密码，然后点击 **Save**。 +7. 在 **Password Settings** 对话框中，设置连接 TiDB Cloud Dedicated 集群的 root 密码，然后点击 **Save**。 ### 恢复已删除的集群 diff --git a/tidb-cloud/branch-github-integration.md b/tidb-cloud/branch-github-integration.md index 79151f8fe182f..082abdfcdbb54 100644 --- a/tidb-cloud/branch-github-integration.md +++ b/tidb-cloud/branch-github-integration.md @@ -11,13 +11,13 @@ summary: 了解如何将 TiDB Cloud Branching 功能与 GitHub 集成。 如果你在应用开发中使用 GitHub，可以将 TiDB Cloud Branching 集成到你的 GitHub CI/CD 流水线中，从而让你能够在不影响生产数据库的情况下，使用分支自动测试你的 pull request。 -在集成过程中，你会被提示安装 [TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) GitHub 应用。该应用可以根据你 GitHub 仓库中的 pull request，自动管理 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的分支。例如，当你创建一个 pull request 时，应用会为你的 TiDB Cloud Starter 或 TiDB Cloud Essential 实例创建一个对应的分支，你可以在该分支中独立开发新功能或修复 bug，而不会影响生产数据库。 +在集成过程中，你会被提示安装 [TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) GitHub 应用。该应用可以根据你 GitHub 仓库中的 pull request，自动管理 TiDB Cloud Starter 实例的分支。例如，当你创建一个 pull request 时，应用会为你的 TiDB Cloud Starter 实例创建一个对应的分支，你可以在该分支中独立开发新功能或修复 bug，而不会影响生产数据库。 本文档涵盖以下内容： 1. 如何将 TiDB Cloud Branching 与 GitHub 集成 2. TiDB Cloud Branching 应用的工作原理 -3. 如何构建基于分支的 CI 工作流，使用分支而非生产 TiDB Cloud Starter 或 TiDB Cloud Essential 实例测试每个 pull request +3. 如何构建基于分支的 CI 工作流，使用分支而非生产 TiDB Cloud Starter 实例测试每个 pull request ## 开始前的准备 @@ -25,13 +25,13 @@ summary: 了解如何将 TiDB Cloud Branching 功能与 GitHub 集成。 - 一个 GitHub 账号 - 一个用于你的应用的 GitHub 仓库 -- 一个 [TiDB Cloud Starter 或 TiDB Cloud Essential 实例](/tidb-cloud/create-tidb-cluster-serverless.md) +- 一个 [TiDB Cloud Starter 实例](/tidb-cloud/create-tidb-cluster-serverless.md) ## 将 TiDB Cloud Branching 集成到你的 GitHub 仓库 {#integrate-branching-with-your-github-repository} 要将 TiDB Cloud Branching 集成到你的 GitHub 仓库，请按照以下步骤操作： -1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的名称，进入其概览页面。 +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。 2. 在左侧导航栏点击 **Branches**。 @@ -48,17 +48,17 @@ summary: 了解如何将 TiDB Cloud Branching 功能与 GitHub 集成。 5. 在 **GitHub Repository** 下拉列表中选择你的目标仓库。如果列表较长，可以通过输入名称进行搜索。 -6. 点击 **Connect**，将你的 TiDB Cloud Starter 或 TiDB Cloud Essential 实例与 GitHub 仓库进行连接。 +6. 点击 **Connect**，将你的 TiDB Cloud Starter 实例与 GitHub 仓库进行连接。 ## TiDB Cloud Branching 应用行为 -当你将 TiDB Cloud Starter 或 TiDB Cloud Essential 实例与 GitHub 仓库连接后，对于该仓库中的每个 pull request，[TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) GitHub 应用都可以自动管理 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的对应分支。以下是 pull request 变更的默认行为列表： +当你将 TiDB Cloud Starter 实例与 GitHub 仓库连接后，对于该仓库中的每个 pull request，[TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) GitHub 应用都可以自动管理 TiDB Cloud Starter 实例的对应分支。以下是 pull request 变更的默认行为列表： | Pull request 变更 | TiDB Cloud Branching 应用行为 | |------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| 创建 pull request | 当你在仓库中创建 pull request 时，[TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) 应用会为你的 TiDB Cloud Starter 或 TiDB Cloud Essential 实例创建一个分支。当 `branch.mode` 设置为 `reset` 时，分支名称为 `${github_branch_name}_${pr_id}` 格式。当 `branch.mode` 设置为 `reserve` 时，分支名称为 `${github_branch_name}_${pr_id}_${commit_sha}` 格式。注意，分支数量有 [限制](/tidb-cloud/branch-overview.md#limitations-and-quotas)。 | +| 创建 pull request | 当你在仓库中创建 pull request 时，[TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) 应用会为你的 TiDB Cloud Starter 实例创建一个分支。当 `branch.mode` 设置为 `reset` 时，分支名称为 `${github_branch_name}_${pr_id}` 格式。当 `branch.mode` 设置为 `reserve` 时，分支名称为 `${github_branch_name}_${pr_id}_${commit_sha}` 格式。注意，分支数量有 [限制](/tidb-cloud/branch-overview.md#limitations-and-quotas)。 | | 向 pull request 推送新提交 | 当 `branch.mode` 设置为 `reset` 时，每次你向仓库中的 pull request 推送新提交，[TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) 应用会重置该分支。当 `branch.mode` 设置为 `reserve` 时，应用会为最新提交创建一个新分支。 | | 关闭或合并 pull request | 当你关闭或合并 pull request 时，[TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) 应用会删除该 pull request 对应的分支。 | | 重新打开 pull request | 当你重新打开 pull request 时，[TiDB Cloud Branching](https://github.com/apps/tidb-cloud-branching) 应用会为该 pull request 的最新提交创建一个分支。 | @@ -113,7 +113,7 @@ github: **类型：** 布尔值。**默认值：** `true`。 -如果设置为 `false`，当 pull request 被关闭或合并时，TiDB Cloud Branching 应用不会删除 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的分支。 +如果设置为 `false`，当 pull request 被关闭或合并时，TiDB Cloud Branching 应用不会删除 TiDB Cloud Starter 实例的分支。 ```yaml github: @@ -123,7 +123,7 @@ github: ## 创建基于分支的 CI 工作流 -使用分支的最佳实践之一是创建基于分支的 CI 工作流。通过该工作流，你可以在 pull request 合并前，使用 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的分支而不是生产实例本身来测试你的代码。你可以在 [这里](https://github.com/shiyuhang0/tidbcloud-branch-gorm-example) 查看在线演示。 +使用分支的最佳实践之一是创建基于分支的 CI 工作流。通过该工作流，你可以在 pull request 合并前，使用 TiDB Cloud Starter 实例的分支而不是生产实例本身来测试你的代码。你可以在 [这里](https://github.com/shiyuhang0/tidbcloud-branch-gorm-example) 查看在线演示。 创建该工作流的主要步骤如下： diff --git a/tidb-cloud/branch-manage.md b/tidb-cloud/branch-manage.md index 3c7cca23cf248..b010701f7ecfd 100644 --- a/tidb-cloud/branch-manage.md +++ b/tidb-cloud/branch-manage.md @@ -5,7 +5,7 @@ summary: 了解如何管理 TiDB Cloud 分支。 # 管理 TiDB Cloud 分支 -本文档介绍如何使用 [TiDB Cloud 控制台](https://tidbcloud.com) 管理你的 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的分支。若需使用 TiDB Cloud CLI 进行管理，请参见 [`ticloud branch`](/tidb-cloud/ticloud-branch-create.md)。 +本文档介绍如何使用 [TiDB Cloud 控制台](https://tidbcloud.com) 管理你的 TiDB Cloud Starter 实例的分支。若需使用 TiDB Cloud CLI 进行管理，请参见 [`ticloud branch`](/tidb-cloud/ticloud-branch-create.md)。 ## 所需权限 @@ -18,11 +18,11 @@ summary: 了解如何管理 TiDB Cloud 分支。 > **Note:** > -> 你只能为 2023 年 7 月 5 日之后创建的 TiDB Cloud Starter 或 TiDB Cloud Essential 实例创建分支。更多限制请参见 [限制与配额](/tidb-cloud/branch-overview.md#limitations-and-quotas)。 +> 你只能为 2023 年 7 月 5 日之后创建的 TiDB Cloud Starter 实例创建分支。更多限制请参见 [限制与配额](/tidb-cloud/branch-overview.md#limitations-and-quotas)。 创建分支，请按照以下步骤操作： -1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的名称，进入其概览页面。 +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。 2. 在左侧导航栏点击 **Branches**。 3. 在 **Branches** 页面右上角，点击 **Create Branch**。此时会弹出对话框。 @@ -31,38 +31,38 @@ summary: 了解如何管理 TiDB Cloud 分支。 4. 在 **Create Branch** 对话框中，配置以下选项： - **Name**：输入分支名称。 - - **Parent branch**：选择原始 TiDB Cloud Starter 或 Essential 实例或已有分支。`main` 代表当前实例。 + - **Parent branch**：选择原始 TiDB Cloud Starter 实例或已有分支。`main` 代表当前实例。 - **Include data up to**：选择以下之一： - **Current point in time**：从当前状态创建分支。 - **Specific date and time**：从指定时间点创建分支。 5. 点击 **Create**。 -根据你的 TiDB Cloud Starter 或 Essential 实例中的数据量，分支创建将在几分钟内完成。 +根据你的 TiDB Cloud Starter 实例中的数据量，分支创建将在几分钟内完成。 ## 查看分支 -要查看 TiDB Cloud Starter 或 Essential 实例的分支，请按照以下步骤操作： +要查看 TiDB Cloud Starter 实例的分支，请按照以下步骤操作： -1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的名称，进入其概览页面。 +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。 2. 在左侧导航栏点击 **Branches**。 - TiDB Cloud Starter 或 Essential 实例的分支列表会显示在右侧面板。 + TiDB Cloud Starter 实例的分支列表会显示在右侧面板。 ## 连接到分支 要连接到分支，请按照以下步骤操作： -1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的名称，进入其概览页面。 +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。 2. 在左侧导航栏点击 **Branches**。 3. 在目标分支所在行的 **Action** 列，点击 **...**。 4. 在下拉列表中点击 **Connect**。此时会弹出连接信息对话框。 5. 点击 **Generate Password** 或 **Reset Password**，以创建或重置 root 密码。 6. 使用连接信息连接到该分支。 -另外，你也可以在 TiDB Cloud Starter 或 Essential 实例的概览页面获取连接字符串： +另外，你也可以在 TiDB Cloud Starter 实例的概览页面获取连接字符串： -1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的名称，进入其概览页面。 +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。 2. 在右上角点击 **Connect**。 3. 在 `Branch` 下拉列表中选择你要连接的分支。 4. 点击 **Generate Password** 或 **Reset Password**，以创建或重置 root 密码。 @@ -72,7 +72,7 @@ summary: 了解如何管理 TiDB Cloud 分支。 要删除分支，请按照以下步骤操作： -1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的名称，进入其概览页面。 +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。 2. 在左侧导航栏点击 **Branches**。 3. 在目标分支所在行的 **Action** 列，点击 **...**。 4. 在下拉列表中点击 **Delete**。 @@ -88,7 +88,7 @@ summary: 了解如何管理 TiDB Cloud 分支。 要重置分支，请按照以下步骤操作： -1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 TiDB Cloud Essential 实例的名称，进入其概览页面。 +1. 在 [TiDB Cloud 控制台](https://tidbcloud.com/)中，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。 2. 在左侧导航栏点击 **Branches**。 3. 在目标分支所在行的 **Action** 列，点击 **...**。 4. 在下拉列表中点击 **Reset**。 diff --git a/tidb-cloud/branch-overview.md b/tidb-cloud/branch-overview.md index af23c1fab48b7..2cbc904b5a443 100644 --- a/tidb-cloud/branch-overview.md +++ b/tidb-cloud/branch-overview.md @@ -5,7 +5,7 @@ summary: 了解 TiDB Cloud 分支的概念。 # TiDB Cloud Branching（Beta）概述 -TiDB Cloud 允许你为 {{{ .starter }}} 和 {{{ .essential }}} 实例创建分支。{{{ .starter }}} 或 Essential 实例的分支是一个独立的实例，包含从原始 {{{ .starter }}} 或 Essential 实例分叉出来的数据副本。它提供了一个隔离的环境，使你可以自由地进行实验，而无需担心影响原始 {{{ .starter }}} 或 Essential 实例。 +TiDB Cloud 允许你为 {{{ .starter }}} 实例创建分支。{{{ .starter }}} 实例的分支是一个独立的实例，包含从原始 {{{ .starter }}} 实例分叉出来的数据副本。它提供了一个隔离的环境，使你可以自由地进行实验，而无需担心影响原始 {{{ .starter }}} 实例。 通过分支，开发者可以并行工作，快速迭代新功能，排查问题而不影响生产数据库，并且在需要时可以轻松回滚更改。该功能简化了开发和部署流程，同时确保生产数据库具有高稳定性和可靠性。 @@ -15,9 +15,9 @@ TiDB Cloud 允许你为 {{{ .starter }}} 和 {{{ .essential }}} 实例创建分 ## 实现方式 -当为 {{{ .starter }}} 或 Essential 实例创建分支时，分支中的数据会在某一特定时间点与原始 {{{ .starter }}} 或 Essential 实例或其父分支的数据分叉。这意味着之后在父分支或分支中所做的更改将不会相互同步。 +当为 {{{ .starter }}} 实例创建分支时，分支中的数据会在某一特定时间点与原始 {{{ .starter }}} 实例或其父分支的数据分叉。这意味着之后在父分支或分支中所做的更改将不会相互同步。 -为了确保分支创建的快速与无缝，TiDB Cloud 采用了写时复制（copy-on-write）技术，在原始 {{{ .starter }}} 或 Essential 实例与其分支之间共享数据。该过程通常在几分钟内完成，对用户来说几乎无感知，并且不会影响原始 {{{ .starter }}} 或 Essential 实例的性能。 +为了确保分支创建的快速与无缝，TiDB Cloud 采用了写时复制（copy-on-write）技术，在原始 {{{ .starter }}} 实例与其分支之间共享数据。该过程通常在几分钟内完成，对用户来说几乎无感知，并且不会影响原始 {{{ .starter }}} 实例的性能。 ## 场景 @@ -39,7 +39,7 @@ TiDB Cloud 允许你为 {{{ .starter }}} 和 {{{ .essential }}} 实例创建分 目前，TiDB Cloud 分支处于 beta 阶段，且免费使用。 -- 对于 TiDB Cloud 中的每个组织，默认最多可在所有 {{{ .starter }}} 和 Essential 实例下创建 5 个分支。{{{ .starter }}} 或 Essential 实例的分支会在与实例相同的 region 创建，且无法为受限或大于 100 GiB 的 {{{ .starter }}} 或 Essential 实例创建分支。 +- 对于 TiDB Cloud 中的每个组织，默认最多可在所有 {{{ .starter }}} 实例下创建 5 个分支。TiDB Cloud 会在与 {{{ .starter }}} 实例相同的 region 创建分支，且无法为受限或大于 100 GiB 的 {{{ .starter }}} 实例创建分支。 > **注意：** > @@ -49,12 +49,12 @@ TiDB Cloud 允许你为 {{{ .starter }}} 和 {{{ .essential }}} 实例创建分 - 分支主要用于短期功能开发和功能测试。由于分支不具备自动扩缩容能力，不适合用于性能测试。 -- 如果你的 {{{ .starter }}} 或 Essential 实例包含 TiFlash 副本，在创建新分支后，这些副本会在新分支中暂时不可用，因为 TiFlash 需要重建副本数据。 +- 如果你的 {{{ .starter }}} 实例包含 TiFlash 副本，在创建新分支后，这些副本会在新分支中暂时不可用，因为 TiFlash 需要重建副本数据。 - 当你从某一特定时间点[创建分支](/tidb-cloud/branch-manage.md#create-a-branch)时： - 对于免费 {{{ .starter }}} 实例，你可以选择最近 24 小时内的任意时间点。 - - 对于 {{{ .starter }}}（消费额度大于 0）或 {{{ .essential }}} 实例，你可以选择最近 14 天内的任意时间点。 + - 对于 {{{ .starter }}}（消费额度大于 0）实例，你可以选择最近 14 天内的任意时间点。 如果你需要更多配额，请[联系 TiDB Cloud 支持](/tidb-cloud/tidb-cloud-support.md)。 diff --git a/tidb-cloud/connect-via-standard-connection-serverless.md b/tidb-cloud/connect-via-standard-connection-serverless.md index d90d1eecf1bd9..f117ee5d24273 100644 --- a/tidb-cloud/connect-via-standard-connection-serverless.md +++ b/tidb-cloud/connect-via-standard-connection-serverless.md @@ -7,15 +7,22 @@ summary: 了解如何通过公共端点连接到你的 TiDB Cloud Starter 或 Ti 本文档介绍了如何通过公共端点，使用你电脑上的 SQL 客户端连接到 TiDB Cloud Starter 或 TiDB Cloud Essential 实例，以及如何禁用公共端点。 -## 通过公共端点连接 +## 选择端点模型 {#choose-an-endpoint-model} + +根据你的 TiDB Cloud 计划，选择合适的端点模型： + +- 对于 {{{ .starter }}} 实例，或在 2026 年 7 月 1 日之前创建的 {{{ .essential }}} 实例，请使用[**端点共享模型**](#connect-via-a-public-endpoint-endpoint-shared-model)。在此模型中，同一 Region 中的多个 {{{ .starter }}} 和 Essential 实例可以共享一个公共端点。 +- 对于从 2026 年 7 月 1 日开始创建的 {{{ .essential }}} 实例，请使用[**端点独占模型**](#connect-via-a-public-endpoint-endpoint-exclusive-model)。在此模型中，每个 {{{ .essential }}} 实例都使用自己的独立公共端点。此模型无需在连接时包含[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)，但你需要为每个 {{{ .essential }}} 实例重复执行设置步骤。 + +## 通过公共端点连接（端点共享模型） {#connect-via-a-public-endpoint-endpoint-shared-model} > **提示：** > > 如需了解如何通过公共端点连接 TiDB Cloud Dedicated 集群，请参见 [Connect to TiDB Cloud Dedicated via Public Connection](/tidb-cloud/connect-via-standard-connection.md)。 -要通过公共端点连接到 TiDB Cloud Starter 或 TiDB Cloud Essential 实例，请按照以下步骤操作： +要使用共享模型通过公共端点连接到 {{{ .starter }}} 或 {{{ .essential }}} 实例，请按照以下步骤操作： -1. 进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 TiDB Cloud Starter 或 Essential 实例的名称，进入其概览页面。 +1. 进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，然后点击目标 {{{ .starter }}} 或 Essential 实例的名称，进入其概览页面。 2. 点击右上角的 **Connect**。此时会弹出连接对话框。 @@ -25,11 +32,11 @@ summary: 了解如何通过公共端点连接到你的 TiDB Cloud Starter 或 Ti > **注意：** > - > - 保持连接类型为 `Public`，表示通过标准 TLS 连接进行连接。更多信息，请参见 [TLS Connection to TiDB Cloud Starter or Essential](/tidb-cloud/secure-connections-to-serverless-clusters.md)。 + > - 保持连接类型为 `Public`，表示通过标准 TLS 连接进行连接。更多信息，请参见 [TLS Connection to {{{ .starter }}} or Essential](/tidb-cloud/secure-connections-to-serverless-clusters.md)。 > - 如果你在 **Connection Type** 下拉列表中选择 **Private Endpoint**，则表示通过私有端点进行连接。更多信息，请参见以下文档： > - > - [Connect to TiDB Cloud Starter or Essential via AWS PrivateLink](/tidb-cloud/set-up-private-endpoint-connections-serverless.md) - > - [Connect to TiDB Cloud Starter or Essential via Alibaba Cloud Private Endpoint](/tidb-cloud/set-up-private-endpoint-connections-on-alibaba-cloud.md) + > - [Connect to {{{ .starter }}} or Essential via AWS PrivateLink](/tidb-cloud/set-up-private-endpoint-connections-serverless.md) + > - [Connect to {{{ .starter }}} or Essential via Alibaba Cloud Private Endpoint](/tidb-cloud/set-up-private-endpoint-connections-on-alibaba-cloud.md) @@ -37,21 +44,53 @@ summary: 了解如何通过公共端点连接到你的 TiDB Cloud Starter 或 Ti > **注意：** > - > - 保持连接类型为 `Public`，表示通过标准 TLS 连接进行连接。更多信息，请参见 [TLS Connection to TiDB Cloud Starter or Essential](/tidb-cloud/secure-connections-to-serverless-clusters.md)。 - > - 如果你在 **Connection Type** 下拉列表中选择 **Private Endpoint**，则表示通过私有端点进行连接。更多信息，请参见 [Connect to TiDB Cloud Starter or Essential via AWS PrivateLink](/tidb-cloud/set-up-private-endpoint-connections-serverless.md)。 + > - 保持连接类型为 `Public`，表示通过标准 TLS 连接进行连接。更多信息，请参见 [TLS Connection to {{{ .starter }}} or Essential](/tidb-cloud/secure-connections-to-serverless-clusters.md)。 + > - 如果你在 **Connection Type** 下拉列表中选择 **Private Endpoint**，则表示通过私有端点进行连接。更多信息，请参见 [Connect to {{{ .starter }}} or Essential via AWS PrivateLink](/tidb-cloud/set-up-private-endpoint-connections-serverless.md)。 -4. TiDB Cloud 支持为你的 TiDB Cloud Starter 或 TiDB Cloud Essential 实例创建 [branches](/tidb-cloud/branch-overview.md)。创建分支后，你可以通过 **Branch** 下拉列表选择连接到某个分支。`main` 代表 TiDB Cloud Starter 或 Essential 实例本身。 +4. TiDB Cloud 支持为你的 {{{ .starter }}} 实例创建 [branches](https://docs.pingcap.com/tidbcloud/branch-overview/?plan=starter)。创建分支后，你可以通过 **Branch** 下拉列表选择连接到某个分支。`main` 代表 {{{ .starter }}} 实例本身。 5. 如果你还没有设置密码，请点击 **Generate Password** 生成一个随机密码。生成的密码只会显示一次，请妥善保存。 -6. 使用连接字符串连接到你的 TiDB Cloud Starter 或 Essential 实例。 +6. 使用连接字符串连接到你的 {{{ .starter }}} 或 Essential 实例。 > **注意：** > - > 连接 TiDB Cloud Starter 或 TiDB Cloud Essential 实例时，必须在用户名中包含 TiDB Cloud Starter 或 Essential 实例的前缀，并用引号包裹。更多信息，请参见 [User name prefix](/tidb-cloud/select-cluster-tier.md#user-name-prefix)。 - > 你的客户端 IP 必须在 TiDB Cloud Starter 或 Essential 实例公共端点的允许 IP 规则中。更多信息，请参见 [Configure TiDB Cloud Starter or Essential Firewall Rules for Public Endpoints](/tidb-cloud/configure-serverless-firewall-rules-for-public-endpoints.md)。 + > 连接 {{{ .starter }}} 或 {{{ .essential }}} 实例时，必须在用户名中包含 {{{ .starter }}} 或 Essential 实例的前缀，并用引号包裹。更多信息，请参见 [User name prefix](/tidb-cloud/select-cluster-tier.md#user-name-prefix)。 + > 你的客户端 IP 必须在 {{{ .starter }}} 或 Essential 实例公共端点的允许 IP 规则中。更多信息，请参见 [Configure {{{ .starter }}} or Essential Firewall Rules for Public Endpoints](/tidb-cloud/configure-serverless-firewall-rules-for-public-endpoints.md)。 + +## 通过公共端点连接（端点独占模型） {#connect-via-a-public-endpoint-endpoint-exclusive-model} + +> **注意：** +> +> 目前，端点独占模型仅适用于在特定 Region 中从 2026 年 7 月 1 日开始创建的 {{{ .essential }}} 实例。如果你的实例不支持该模型，可以改用[端点共享模型](#connect-via-a-public-endpoint-endpoint-shared-model)。 + +在端点独占模型中，每个 {{{ .essential }}} 实例都使用自己的独立公共端点。此模型无需在连接时包含[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)，但你需要为每个 {{{ .essential }}} 实例重复执行设置步骤。 + +要使用独占模型通过公共端点连接到 {{{ .essential }}} 实例，请按照以下步骤操作： + +1. 打开目标实例的概览页面。 + + 1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，然后进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面。 + + > **提示：** + > + > 如果你属于多个组织，请先使用左上角的组合框切换到目标组织。 + + 2. 点击目标实例的名称，进入其概览页面。 + +2. 点击右上角的 **Connect**。此时会弹出连接对话框。 + +3. 在连接对话框中，从 **Connection Type** 下拉列表中选择 **Public**。 + + - 如果公共连接已禁用，请在左侧窗格中点击 **Settings** > **Networking**，然后在 **Networking** 页面启用 **Public Endpoint** 选项。 + - 如果你尚未配置 IP 访问列表，请点击 **Configure IP Access List**，并在首次连接前完成配置。 + - 如果你尚未为 {{{ .essential }}} 实例配置 root 密码，请点击 **Set Root Password** 并进行设置。 + +4. 点击 **CA cert** 下载用于连接 {{{ .essential }}} 实例的 TLS CA 证书。该 CA 证书默认支持 TLS 1.2。 + +5. 在 **Connection with** 下拉列表中选择你偏好的连接方式，然后参考连接字符串连接到你的实例。 ## 禁用公共端点 @@ -61,7 +100,7 @@ summary: 了解如何通过公共端点连接到你的 TiDB Cloud Starter 或 Ti 2. 在左侧导航栏，点击 **Settings** > **Networking**。 -3. 在 **Networking** 页面，点击 **Disable**。此时会弹出确认对话框。 +3. 在 **Networking** 页面，点击 **Public Endpoint** 对应的 **Disable**。此时会弹出确认对话框。 4. 在确认对话框中点击 **Disable**。 diff --git a/tidb-cloud/essential-changefeed-overview.md b/tidb-cloud/essential-changefeed-overview.md index ce5b2d5bc8623..950cb90f4e78a 100644 --- a/tidb-cloud/essential-changefeed-overview.md +++ b/tidb-cloud/essential-changefeed-overview.md @@ -182,7 +182,9 @@ ticloud serverless changefeed delete --cluster-id --changefeed-id < ## changefeed 计费 -changefeed 在 beta 阶段免费。 +对于 2026 年 7 月 1 日之前创建的现有 {{{ .essential }}} 实例，changefeed 免费。 + +从 2026 年 7 月 1 日起，changefeed 对新创建的 {{{ .essential }}} 实例按功能收费。有关计费详情，请参见 [TiDB Cloud Essential Pricing Details](https://www.pingcap.com/tidb-cloud-essential-pricing-details/)。 ## changefeed 状态 diff --git a/tidb-cloud/essential-database-audit-logging.md b/tidb-cloud/essential-database-audit-logging.md index 30ddcd4e46adc..a186f39c1c245 100644 --- a/tidb-cloud/essential-database-audit-logging.md +++ b/tidb-cloud/essential-database-audit-logging.md @@ -43,16 +43,11 @@ INSERT INTO `test`.`users` (`id`, `name`, `password`) VALUES ( ... ); 你可以将审计日志存储在以下位置： -- TiDB Cloud - [Amazon S3](https://aws.amazon.com/s3/) - [Google Cloud Storage](https://cloud.google.com/storage) - [Azure Blob Storage](https://azure.microsoft.com/en-us/services/storage/blobs/) - [阿里云对象存储 OSS](https://www.alibabacloud.com/product/oss) -### TiDB Cloud - -你可以将审计日志存储在 TiDB Cloud，并下载到本地。审计日志会在 365 天后过期并被删除。如需更长的保留时间，请联系 [TiDB Cloud 支持](/tidb-cloud/tidb-cloud-support.md)。 - ### Amazon S3 如需将审计日志存储在 Amazon S3，你需要提供以下信息： @@ -361,46 +356,6 @@ ticloud serverless audit-log filter delete --cluster-id --filter-ru -## 通过 TiDB Cloud 存储访问审计日志 - -当你将审计日志存储在 TiDB Cloud 时，TiDB Cloud Essential 会将其保存为可读文本文件，命名为 `YYYY-MM-DD-.log`。你可以通过 TiDB Cloud 控制台或 TiDB Cloud CLI 查看和下载这些文件。 - -> **注意：** -> -> - TiDB Cloud Essential 不保证审计日志的存储顺序。名为 `YYYY-MM-DD-.log` 的日志文件可能包含更早日期的日志条目。 -> - 如需获取某一天（如 2025 年 1 月 1 日）的所有日志，请设置 `--start-date 2025-01-01` 和 `--end-date 2025-01-02`。在某些情况下，你可能需要下载所有日志文件并按 `TIME` 字段进行排序。 - - -
- -1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，进入 [**My TiDB**](https://tidbcloud.com/tidbs) 页面。 - - > **提示：** - > - > 如果你属于多个组织，请先使用左上角的下拉框切换到目标组织。 - -2. 点击目标 {{{ .essential }}} 实例名称进入概览页，然后在左侧导航栏点击 **Settings** > **DB Audit Logging**。 - -3. 在 **DB Audit Logging** 页面，你可以在 **TiDB Cloud Storage** 下查看审计日志列表。 - -4. 如需下载审计日志，从列表中选择一个或多个日志，然后点击 **Download**。 - -
- -
- -如需通过 TiDB Cloud CLI 下载审计日志，运行以下命令： - -```shell -ticloud serverless audit-log download --cluster-id --output-path --start-date --end-date -``` - -- `start-date`：要下载的审计日志起始日期，格式为 `YYYY-MM-DD`，如 `2025-01-01`。 -- `end-date`：要下载的审计日志结束日期，格式为 `YYYY-MM-DD`，如 `2025-01-01`。 - -
- - ## 审计日志字段 对于审计日志中的每条数据库事件记录，TiDB Cloud 提供以下字段： diff --git a/tidb-cloud/limited-sql-features-tidb-x.md b/tidb-cloud/limited-sql-features-tidb-x.md new file mode 100644 index 0000000000000..58a2143d9f7d1 --- /dev/null +++ b/tidb-cloud/limited-sql-features-tidb-x.md @@ -0,0 +1,368 @@ +--- +title: TiDB X 实例上的受限 SQL 功能 +summary: 了解 TiDB X 实例上的受限 SQL 功能。 +--- + +# TiDB X 实例上的受限 SQL 功能 + +TiDB X 实例是一种面向服务的 TiDB Cloud 产品，基于 [TiDB X architecture](/tidb-cloud/tidb-x-architecture.md) 构建，例如 {{{ .starter }}}、Essential 或 Premium 实例。 + +TiDB Cloud 适用于 TiDB 支持的几乎所有工作负载，但 TiDB Self-Managed 与 TiDB Cloud 之间仍存在一些功能差异。本文档介绍 TiDB Cloud Starter、Essential 和 Premium 在 SQL 功能方面的限制。我们正在持续缩小 TiDB Self-Managed 与 TiDB Cloud 之间的功能差距。如果你需要这些尚未覆盖的功能或能力，请[联系我们](/tidb-cloud/tidb-cloud-support.md)提交功能请求。 + +> **Note:** +> +> 本文档仅适用于 {{{ .starter }}}、Essential 和 Premium。对于 TiDB Cloud Dedicated，请参见 [Limited SQL Features on TiDB Cloud Dedicated](/tidb-cloud/limited-sql-features.md)。 + +## 语句 {#statements} + +### 放置策略与范围管理 {#placement-and-range-management} + +| Statement | {{{ .premium }}} | {{{ .starter }}} and {{{ .essential }}} | +|:-|:-|:-| +| `ALTER PLACEMENT POLICY` | 不支持 [^1] | 不支持 [^1] | +| `ALTER RANGE` | 不支持 | 不支持 | +| `CREATE PLACEMENT POLICY` | 不支持 [^1] | 不支持 [^1] | +| `DROP PLACEMENT POLICY` | 不支持 [^1] | 不支持 [^1] | +| `SHOW CREATE PLACEMENT POLICY` | 不支持 [^1] | 不支持 [^1] | +| `SHOW PLACEMENT` | 不支持 [^1] | 不支持 [^1] | +| `SHOW PLACEMENT FOR` | 不支持 [^1] | 不支持 [^1] | +| `SHOW PLACEMENT LABELS` | 不支持 [^1] | 不支持 [^1] | +| `SHOW TABLE REGIONS` | 支持 | 不支持 [^1] | +| `SPLIT REGION` | 支持 | 不支持 [^1] | + +### 资源组 {#resource-groups} + +| Statement | {{{ .premium }}} | {{{ .starter }}} and {{{ .essential }}} | +|:-|:-|:-| +| `ALTER RESOURCE GROUP` | 不支持 [^2] | 不支持 [^2] | +| `CALIBRATE RESOURCE` | 不支持 [^2] | 不支持 [^2] | +| `CREATE RESOURCE GROUP` | 不支持 [^2] | 不支持 [^2] | +| `DROP RESOURCE GROUP` | 不支持 [^2] | 不支持 [^2] | +| `SET RESOURCE GROUP` | 不支持 [^2] | 不支持 [^2] | +| `SHOW CREATE RESOURCE GROUP` | 不支持 [^2] | 不支持 [^2] | + +### 其他 {#others} + +| Statement | {{{ .premium }}} | {{{ .starter }}} and {{{ .essential }}} | +|:-|:-|:-| +| `BACKUP` | 不支持 [^3] | 不支持 [^3] | +| `SHOW BACKUPS` | 不支持 [^3] | 不支持 [^3] | +| `RESTORE` | 不支持 [^3] | 不支持 [^3] | +| `SHOW RESTORES` | 不支持 [^3] | 不支持 [^3] | +| `BACKUP LOGS` | 不支持 | 不支持 | +| `STOP BACKUP LOGS` | 不支持 | 不支持 | +| `PAUSE BACKUP LOGS` | 不支持 | 不支持 | +| `RESUME BACKUP LOGS` | 不支持 | 不支持 | +| `SHOW BACKUP LOGS STATUS` | 不支持 | 不支持 | +| `SHOW BACKUP LOGS METADATA` | 不支持 | 不支持 | +| `PURGE BACKUP LOGS` | 不支持 | 不支持 | +| `SHOW BR JOB` | 不支持 | 不支持 | +| `SHOW BR JOB QUERY` | 不支持 | 不支持 | +| `CANCEL BR JOB` | 不支持 | 不支持 | +| `SHOW BACKUP META` | 不支持 | 不支持 | +| `RECOVER TABLE` | 不支持 | 不支持 | +| `ADMIN RESET TELEMETRY_ID` | 支持 | {{{ .starter }}} 或 {{{ .essential }}} 不支持 Telemetry。 | +| `ADMIN SHOW TELEMETRY` | 不支持 [^4] | 不支持 [^4] | +| `ADMIN SHOW SLOW` | 不支持 [^5] | 不支持 [^5] | +| `ADMIN PLUGINS ENABLE` | 不支持 [^8] | 不支持 [^8] | +| `ADMIN PLUGINS DISABLE` | 不支持 [^8] | 不支持 [^8] | +| `ADMIN SET BDR ROLE` | 不支持 | 不支持 | +| `ADMIN SHOW BDR ROLE` | 不支持 | 不支持 | +| `ADMIN UNSET BDR ROLE` | 不支持 | 不支持 | +| `ADMIN REPAIR TABLE` | 不支持 | 不支持 | +| `ALTER INSTANCE` | 不支持 | 不支持 | +| `ALTER INSTANCE RELOAD TLS` | 不支持 | {{{ .starter }}} 和 {{{ .essential }}} 会自动刷新 TLS 证书。 | +| `ALTER TABLE ... ATTRIBUTES` | 不支持 | 不支持 | +| `CHANGE DRAINER` | 不支持 [^7] | 不支持 [^7] | +| `CHANGE PUMP` | 不支持 [^7] | 不支持 [^7] | +| `FLASHBACK CLUSTER` | 不支持 [^3] | 不支持 [^3] | +| `IMPORT INTO` | 支持，但会阻止使用本地文件路径或 S3 EXTERNAL_ID 的 `IMPORT INTO` 语句。 | 不支持 | +| `LOAD DATA INFILE` | 阻止从本地文件路径执行 `LOAD DATA LOCAL INFILE`。 | 仅支持 `LOAD DATA LOCAL INFILE` | +| `LOAD STATS` | 不支持 | 不支持 | +| `SELECT ... INTO OUTFILE` | 不支持 [^4] | 不支持 [^4] | +| `SET CONFIG` | 不支持 [^4] | 不支持 [^4] | +| `SHOW CONFIG` | 不支持 [^4] | 不支持 [^4] | +| `SHOW DRAINER STATUS` | 不支持 [^7] | 不支持 [^7] | +| `SHOW PLUGINS` | 不支持 [^8] | 不支持 [^8] | +| `SHOW PUMP STATUS` | 不支持 [^7] | 不支持 [^7] | +| `SHUTDOWN` | 不支持 [^4] | 不支持 [^4] | +| `PLAN REPLAYER` | 支持 | 支持，但使用不同的文件下载方式 [^11] | +| `time_to_live` | 支持 | 不支持 | + +## 函数和运算符 {#functions-and-operators} + +| Function and operator | {{{ .premium }}} | {{{ .starter }}} and {{{ .essential }}} | +|:-|:-|:-| +| `SLEEP` | 无限制 | [`SLEEP()` function](https://docs.pingcap.com/tidbcloud/miscellaneous-functions) 函数支持的最大休眠时间为 300 秒。 | + +## 系统表 {#system-tables} + +| Database | Table | {{{ .premium }}} | {{{ .starter }}} and {{{ .essential }}} | +|:-|:-|:-|:-| +| `metrics_schema` | 所有数据库 | 不支持 | 不支持 | +| `information_schema` | `ATTRIBUTES` | 支持 | 不支持 [^1] | +| `information_schema` | `CLUSTER_CONFIG` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `CLUSTER_HARDWARE` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `CLUSTER_INFO` | 支持 | 不支持 [^1] | +| `information_schema` | `CLUSTER_LOAD` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `CLUSTER_LOG` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `CLUSTER_SLOW_QUERY` | 不支持 [^5] | 不支持 [^5] | +| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY` | 支持 | 不支持 [^6] | +| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY_EVICTED` | 支持 | 不支持 [^6] | +| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY_HISTORY` | 支持 | 不支持 [^6] | +| `information_schema` | `CLUSTER_SYSTEMINFO` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `INSPECTION_RESULT` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `INSPECTION_RULES` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `INSPECTION_SUMMARY` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `METRICS_SUMMARY` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `METRICS_SUMMARY_BY_LABEL` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `METRICS_TABLES` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `PLACEMENT_POLICIES` | 不支持 [^1] | 不支持 [^1] | +| `information_schema` | `RESOURCE_GROUPS` | 不支持 [^2] | 不支持 [^2] | +| `information_schema` | `SLOW_QUERY` | 不支持 [^5] | 不支持 [^5] | +| `information_schema` | `STATEMENTS_SUMMARY` | 支持 | 不支持 [^6] | +| `information_schema` | `STATEMENTS_SUMMARY_EVICTED` | 支持 | 不支持 [^6] | +| `information_schema` | `TIDB_HOT_REGIONS` | 不支持 [^4] | 不支持 [^4] | +| `information_schema` | `TIDB_HOT_REGIONS_HISTORY` | 支持 | 不支持 [^1] | +| `information_schema` | `TIDB_SERVERS_INFO` | 支持 | 不支持 [^1] | +| `information_schema` | `TIKV_REGION_PEERS` | 支持 | 不支持 [^1] | +| `information_schema` | `TIKV_REGION_STATUS` | 支持 | 不支持 [^1] | +| `information_schema` | `TIKV_STORE_STATUS` | 支持 | 不支持 [^1] | +| `performance_schema` | `pd_profile_allocs` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `pd_profile_block` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `pd_profile_cpu` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `pd_profile_goroutines` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `pd_profile_memory` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `pd_profile_mutex` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `tidb_profile_allocs` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `tidb_profile_block` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `tidb_profile_cpu` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `tidb_profile_goroutines` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `tidb_profile_memory` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `tidb_profile_mutex` | 不支持 [^4] | 不支持 [^4] | +| `performance_schema` | `tikv_profile_cpu` | 不支持 [^4] | 不支持 [^4] | +| `mysql` | `expr_pushdown_blacklist` | 不支持 [^4] | 不支持 [^4] | +| `mysql` | `gc_delete_range` | 不支持 [^4] | 不支持 [^4] | +| `mysql` | `gc_delete_range_done` | 不支持 [^4] | 不支持 [^4] | +| `mysql` | `opt_rule_blacklist` | 不支持 [^4] | 不支持 [^4] | +| `mysql` | `tidb` | 不支持 [^4] | 不支持 [^4] | + +## 系统变量 {#system-variables} + +| Variable | {{{ .premium }}} | {{{ .starter }}} and {{{ .essential }}} | +|:-|:-|:-| +| `hostname` | 值已隐藏 | 值已隐藏 | +| `datadir` | 值已隐藏 | 不支持 [^1] | +| `ddl_slow_threshold` | 只读 | 只读 | +| `block_encryption_mode` | 只读 | 只读 | +| `max_connections` | 只读 | 只读 | +| `mpp_version` | 只读 | 只读 | +| `interactive_timeout` | 无限制 | 只读 [^10] | +| `max_allowed_packet` | 无限制 | 只读 [^10] | +| `plugin_dir` | 不支持 [^8] | 不支持 [^8] | +| `plugin_load` | 不支持 [^8] | 不支持 [^8] | +| `require_secure_transport` | 不支持 | 只读 [^10] | +| `skip_name_resolve` | 只读 [^10] | 只读 [^10] | +| `sql_log_bin` | 无限制 | 只读 [^10] | +| `tidb_adaptive_closest_read_threshold` | 不支持 | 不支持 | +| `tidb_allow_batch_cop` | 只读 | 只读 | +| `tidb_allow_mpp` | 只读 | 只读 | +| `tidb_analyze_skip_column_types` | 无限制 | 只读 [^10] | +| `tidb_analyze_version` | 只读 | 只读 | +| `tidb_backoff_lock_fast` | 只读 | 只读 | +| `tidb_backoff_weight` | 只读 | 只读 | +| `tidb_batch_commit` | 不支持 | 不支持 | +| `tidb_batch_delete` | 不支持 | 不支持 | +| `tidb_batch_insert` | 不支持 | 不支持 | +| `tidb_capture_plan_baselines` | 只读 | 只读 | +| `tidb_cdc_write_source` | 无限制 | 只读 [^10] | +| `tidb_check_mb4_value_in_utf8` | 不支持 [^4] | 不支持 [^4] | +| `tidb_cloud_storage_uri` | 不支持 | 不支持 | +| `tidb_config` | 不支持 [^4] | 不支持 [^4] | +| `tidb_constraint_check_in_place` | 只读 | 只读 | +| `tidb_constraint_check_in_place_pessimistic` | 只读 | 只读 | +| `tidb_cost_model_version` | 只读 | 只读 | +| `tidb_ddl_disk_quota` | 只读 [^10] | 只读 [^10] | +| `tidb_ddl_enable_fast_reorg` | 只读 [^10] | 只读 [^10] | +| `tidb_ddl_error_count_limit` | 无限制 | 只读 [^10] | +| `tidb_ddl_flashback_concurrency` | 只读 [^10] | 只读 [^10] | +| `tidb_ddl_reorg_batch_size` | 无限制 | 只读 [^10] | +| `tidb_ddl_reorg_max_write_speed` | 不支持 | 不支持 | +| `tidb_ddl_reorg_priority` | 无限制 | 只读 [^10] | +| `tidb_ddl_reorg_worker_cnt` | 无限制 | 只读 [^10] | +| `tidb_disable_txn_auto_retry` | 不支持 | 不支持 | +| `tidb_dml_batch_size` | 不支持 | 不支持 | +| `tidb_dml_type` | 不支持 | 只读 [^10] | +| `tidb_enable_1pc` | 无限制 | 只读 [^10] | +| `tidb_enable_analyze_snapshot` | 只读 | 只读 | +| `tidb_enable_async_commit` | 无限制 | 只读 [^10] | +| `tidb_enable_async_merge_global_stats` | 只读 | 只读 | +| `tidb_enable_auto_analyze` | 无限制 | 只读 [^10] | +| `tidb_enable_batch_dml` | 不支持 | 不支持 | +| `tidb_enable_chunk_rpc` | 只读 | 只读 | +| `tidb_enable_collect_execution_info` | 不支持 [^4] | 不支持 [^4] | +| `tidb_enable_column_tracking` | 不支持 | 不支持 | +| `tidb_enable_ddl` | 只读 [^10] | 只读 [^10] | +| `tidb_enable_dist_task` | 只读 | 只读 | +| `tidb_enable_exchange_partition` | 不支持 | 不支持 | +| `tidb_enable_extended_stats` | 只读 | 只读 | +| `tidb_enable_fast_analyze` | 不支持 | 不支持 | +| `tidb_enable_gc_aware_memory_track` | 无限制 | 只读 [^10] | +| `tidb_enable_global_index` | 不支持 | 不支持 | +| `tidb_enable_gogc_tuner` | 只读 [^10] | 只读 [^10] | +| `tidb_enable_historical_stats` | 只读 | 只读 | +| `tidb_enable_historical_stats_for_capture` | 只读 | 只读 | +| `tidb_enable_legacy_instance_scope` | 只读 | 只读 | +| `tidb_enable_list_partition` | 不支持 | 不支持 | +| `tidb_enable_local_txn` | 只读 [^10] | 只读 [^10] | +| `tidb_enable_metadata_lock` | 只读 | 只读 | +| `tidb_enable_mutation_checker` | 只读 | 不支持 | +| `tidb_enable_new_cost_interface` | 只读 | 只读 | +| `tidb_enable_parallel_hashagg_spill` | 只读 | 只读 | +| `tidb_enable_pipelined_window_function` | 无限制 | 不支持 | +| `tidb_enable_plan_replayer_capture` | 只读 | 只读 | +| `tidb_enable_plan_replayer_continuous_capture` | 只读 | 只读 | +| `tidb_enable_point_get_cache` | 不支持 | 不支持 | +| `tidb_enable_rate_limit_action` | 只读 | 只读 | +| `tidb_enable_resource_control` | 只读 [^10] | 只读 [^10] | +| `tidb_enable_reuse_chunk` | 只读 | 只读 | +| `tidb_enable_slow_log` | 不支持 [^4] | 不支持 [^4] | +| `tidb_enable_stats_owner` | 只读 | 只读 | +| `tidb_enable_stmt_summary` | 只读 [^10] | 只读 [^10] | +| `tidb_enable_table_partition` | 不支持 | 不支持 | +| `tidb_enable_telemetry` | 不支持 [^4] | 不支持 [^4] | +| `tidb_enable_tiflash_read_for_write_stmt` | 不支持 | 不支持 | +| `tidb_enable_tmp_storage_on_oom` | 不支持 | 不支持 | +| `tidb_enable_top_sql` | 只读 [^10] | 只读 [^10] | +| `tidb_enable_tso_follower_proxy` | 无限制 | 只读 [^10] | +| `tidb_enable_vectorized_expression` | 只读 | 只读 | +| `tidb_evolve_plan_baselines` | 不支持 | 不支持 | +| `tidb_evolve_plan_task_end_time` | 不支持 | 不支持 | +| `tidb_evolve_plan_task_max_time` | 不支持 | 不支持 | +| `tidb_evolve_plan_task_start_time` | 不支持 | 不支持 | +| `tidb_expensive_query_time_threshold` | 不支持 [^4] | 不支持 [^4] | +| `tidb_force_priority` | 不支持 [^4] | 不支持 [^4] | +| `tidb_gc_concurrency` | 无限制 | 只读 [^10] | +| `tidb_gc_enable` | 无限制 | 只读 [^10] | +| `tidb_gc_leader_desc` | 不支持 | 不支持 | +| `tidb_gc_max_wait_time` | 无限制 | 只读 [^10] | +| `tidb_gc_run_interval` | 无限制 | 只读 [^10] | +| `tidb_gc_scan_lock_mode` | 无限制 | 只读 [^10] | +| `tidb_general_log` | 不支持 [^4] | 不支持 [^4] | +| `tidb_generate_binary_plan` | 只读 [^10] | 只读 [^10] | +| `tidb_gogc_tuner_threshold` | 无限制 | 只读 [^10] | +| `tidb_guarantee_linearizability` | 只读 [^10] | 只读 [^10] | +| `tidb_hash_exchange_with_new_collation` | 只读 | 只读 | +| `tidb_historical_stats_duration` | 不支持 | 不支持 | +| `tidb_isolation_read_engines` | 无限制 | 只读 [^10] | +| `tidb_load_based_replica_read_threshold` | 只读 | 只读 | +| `tidb_lock_unchanged_keys` | 只读 | 只读 | +| `tidb_log_file_max_days` | 只读 [^10] | 只读 [^10] | +| `tidb_mem_oom_action` | 只读 | 只读 | +| `tidb_mem_quota_analyze` | 只读 | 只读 | +| `tidb_memory_debug_mode_alarm_ratio` | 不支持 | 不支持 | +| `tidb_memory_debug_mode_min_heap_inuse` | 不支持 | 不支持 | +| `tidb_memory_usage_alarm_keep_record_num` | 只读 | 只读 | +| `tidb_memory_usage_alarm_ratio` | 不支持 [^4] | 不支持 [^4] | +| `tidb_merge_join_concurrency` | 不支持 | 不支持 | +| `tidb_metric_query_range_duration` | 不支持 [^4] | 不支持 [^4] | +| `tidb_metric_query_step` | 不支持 [^4] | 不支持 [^4] | +| `tidb_non_prepared_plan_cache_size` | 不支持 | 不支持 | +| `tidb_opt_broadcast_cartesian_join` | 只读 | 只读 | +| `tidb_opt_concurrency_factor` | 只读 | 只读 | +| `tidb_opt_copcpu_factor` | 只读 | 只读 | +| `tidb_opt_write_row_id` | 不支持 [^4] | 不支持 [^4] | +| `tidb_partition_prune_mode` | 不支持 | 不支持 | +| `tidb_pessimistic_txn_fair_locking` | 不支持 | 不支持 | +| `tidb_placement_mode` | 无限制 | 只读 [^10] | +| `tidb_pprof_sql_cpu` | 不支持 [^4] | 不支持 [^4] | +| `tidb_pre_split_regions` | 只读 | 只读 | +| `tidb_prepared_plan_cache_size` | 不支持 | 只读 | +| `tidb_rc_read_check_ts` | 只读 | 只读 | +| `tidb_rc_write_check_ts` | 只读 | 只读 | +| `tidb_read_consistency` | 只读 | 只读 | +| `tidb_record_plan_in_slow_log` | 不支持 [^4] | 不支持 [^4] | +| `tidb_redact_log` | 不支持 [^4] | 不支持 [^4] | +| `tidb_replica_read` | 只读 [^10] | 只读 [^10] | +| `tidb_request_source_type` | 不支持 | 不支持 | +| `tidb_restricted_read_only` | 不支持 [^4] | 不支持 [^4] | +| `tidb_retry_limit` | 不支持 | 不支持 | +| `tidb_row_format_version` | 不支持 [^4] | 不支持 [^4] | +| `tidb_scatter_region` | 无限制 | 只读 [^10] | +| `tidb_server_memory_limit` | 无限制 | 只读 [^10] | +| `tidb_server_memory_limit_gc_trigger` | 无限制 | 只读 [^10] | +| `tidb_server_memory_limit_sess_min_size` | 无限制 | 只读 [^10] | +| `tidb_service_scope` | 只读 | 只读 | +| `tidb_simplified_metrics` | 只读 [^10] | 只读 [^10] | +| `tidb_skip_missing_partition_stats` | 只读 | 只读 | +| `tidb_slow_log_threshold` | 不支持 [^4] | 不支持 [^4] | +| `tidb_slow_query_file` | 不支持 [^4] | 不支持 [^4] | +| `tidb_slow_txn_log_threshold` | 不支持 [^4] | 不支持 [^4] | +| `tidb_stats_load_pseudo_timeout` | 只读 | 只读 | +| `tidb_stats_load_sync_wait` | 无限制 | 只读 [^10] | +| `tidb_stmt_summary_enable_persistent` | 只读 | 只读 | +| `tidb_stmt_summary_file_max_backups` | 只读 | 只读 | +| `tidb_stmt_summary_file_max_days` | 只读 | 只读 | +| `tidb_stmt_summary_file_max_size` | 只读 | 只读 | +| `tidb_stmt_summary_filename` | 只读 | 只读 | +| `tidb_stmt_summary_history_size` | 只读 [^10] | 只读 [^10] | +| `tidb_stmt_summary_internal_query` | 只读 [^10] | 只读 [^10] | +| `tidb_stmt_summary_max_sql_length` | 只读 [^10] | 只读 [^10] | +| `tidb_stmt_summary_max_stmt_count` | 只读 [^10] | 只读 [^10] | +| `tidb_stmt_summary_refresh_interval` | 只读 [^10] | 只读 [^10] | +| `tidb_store_limit` | 只读 | 只读 | +| `tidb_streamagg_concurrency` | 不支持 | 只读 | +| `tidb_sysproc_scan_concurrency` | 无限制 | 只读 [^10] | +| `tidb_top_sql_max_meta_count` | 不支持 [^4] | 不支持 [^4] | +| `tidb_top_sql_max_time_series_count` | 不支持 [^4] | 不支持 [^4] | +| `tidb_track_aggregate_memory_usage` | 只读 | 只读 | +| `tidb_txn_assertion_level` | 只读 | 只读 | +| `tidb_txn_commit_batch_size` | 只读 | 只读 | +| `tidb_tso_client_batch_max_wait_time` | 无限制 | 只读 [^10] | +| `tidb_ttl_delete_batch_size` | 无限制 | 只读 [^10] | +| `tidb_ttl_delete_rate_limit` | 无限制 | 只读 [^10] | +| `tidb_ttl_delete_worker_count` | 无限制 | 只读 [^10] | +| `tidb_ttl_job_schedule_window_end_time` | 无限制 | 只读 [^10] | +| `tidb_ttl_job_schedule_window_start_time` | 无限制 | 只读 [^10] | +| `tidb_ttl_running_tasks` | 无限制 | 只读 [^10] | +| `tidb_ttl_scan_batch_size` | 无限制 | 只读 [^10] | +| `tidb_ttl_scan_worker_count` | 无限制 | 只读 [^10] | +| `tidb_txn_mode` | 无限制 | 只读 [^10] | +| `tidb_use_plan_baselines` | 只读 | 只读 | +| `tidb_wait_split_region_finish` | 无限制 | 只读 [^10] | +| `tidb_wait_split_region_timeout` | 无限制 | 只读 [^10] | +| `tiflash_compute_dispatch_policy` | 只读 | 只读 | +| `tiflash_replica_read` | 不支持 | 不支持 | +| `tikv_client_read_timeout` | 不支持 | 不支持 | +| `tx_isolation_one_shot` | 不支持 | 不支持 | +| `tx_read_ts` | 不支持 | 不支持 | +| `txn_scope` | 无限制 | 只读 [^10] | +| `validate_password.enable` | 无限制 | 始终启用 [^9] | +| `validate_password.length` | 无限制 | 至少为 `8` [^9] | +| `validate_password.mixed_case_count` | 无限制 | 至少为 `1` [^9] | +| `validate_password.number_count` | 无限制 | 至少为 `1` [^9] | +| `validate_password.policy` | 无限制 | 只能为 `MEDIUM` 或 `STRONG` [^9] | +| `validate_password.special_char_count` | 无限制 | 至少为 `1` [^9] | +| `wait_timeout` | 无限制 | 只读 [^10] | + +[^1]: {{{ .starter }}}、Essential 和 Premium 不支持配置数据放置。 + +[^2]: {{{ .starter }}}、Essential 和 Premium 不支持配置资源组。 + +[^3]: 要在 {{{ .starter }}}、Essential 或 Premium 上执行[备份与恢复](/tidb-cloud/backup-and-restore-serverless.md)操作，可以改用 TiDB Cloud 控制台。 + +[^4]: 该功能在 [Security Enhanced Mode (SEM)](/system-variables.md#tidb_enable_enhanced_security) 中不可用。 + +[^5]: 要在 {{{ .starter }}}、Essential 或 Premium 上跟踪[慢查询](/tidb-cloud/tune-performance.md#slow-query)，可以改用 TiDB Cloud 控制台。 + +[^6]: 要在 {{{ .starter }}} 或 {{{ .essential }}} 上执行[语句分析](/tidb-cloud/tune-performance.md#statement-analysis)，可以改用 TiDB Cloud 控制台。 + +[^7]: TiDB Cloud 不支持 Drainer 和 Pump。 + +[^8]: {{{ .starter }}}、Essential 和 Premium 不支持插件。 + +[^9]: {{{ .starter }}} 和 {{{ .essential }}} 强制执行强密码策略。 + +[^10]: 该变量在 {{{ .starter }}} 和 {{{ .essential }}} 上为只读。 + +[^11]: {{{ .starter }}} 和 {{{ .essential }}} 不支持像[示例](https://docs.pingcap.com/tidb/stable/sql-plan-replayer#examples-of-exporting-cluster-information)中所示那样，通过 `${tidb-server-status-port}` 下载 `PLAN REPLAYER` 导出的文件。相反，{{{ .starter }}} 和 {{{ .essential }}} 会生成一个 [presigned URL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html) 供你下载文件。请注意，该 URL 在生成后 10 小时内有效。 \ No newline at end of file diff --git a/tidb-cloud/limited-sql-features.md b/tidb-cloud/limited-sql-features.md index ee6d19658cdb1..a8572bd6c9c5b 100644 --- a/tidb-cloud/limited-sql-features.md +++ b/tidb-cloud/limited-sql-features.md @@ -1,244 +1,230 @@ --- -title: TiDB Cloud 上受限的 SQL 功能 -summary: 了解 TiDB Cloud 上受限的 SQL 功能。 +title: TiDB Cloud Dedicated 上受限的 SQL 功能 +summary: 了解 TiDB Cloud Dedicated 上受限的 SQL 功能。 --- -# TiDB Cloud 上受限的 SQL 功能 +# TiDB Cloud Dedicated 上受限的 SQL 功能 -TiDB Cloud 支持几乎所有 TiDB 支持的工作负载，但 TiDB 自建版与 TiDB Cloud 之间存在一些功能差异。本文档描述了 TiDB Cloud 上 SQL 功能的限制。我们正在不断弥补 TiDB 自建版与 TiDB Cloud 之间的功能差距。如果你需要这些尚未支持的功能或能力，请[联系我们](/tidb-cloud/tidb-cloud-support.md)提交功能请求。 +TiDB Cloud Dedicated 支持几乎所有 TiDB 支持的工作负载，但 TiDB 自建版与 TiDB Cloud Dedicated 之间存在一些功能差异。本文档描述了 TiDB Cloud Dedicated 上 SQL 功能的限制。我们正在不断弥补 TiDB 自建版与 TiDB Cloud Dedicated 之间的功能差距。如果你需要这些尚未支持的功能或能力，请[联系我们](/tidb-cloud/tidb-cloud-support.md)提交功能请求。 + +> **注意：** +> +> 本文档仅适用于 TiDB Cloud Dedicated。对于 TiDB Cloud Starter、Essential 和 Premium，请参见 [TiDB X 实例上受限的 SQL 功能](/tidb-cloud/limited-sql-features-tidb-x.md)。 ## 语句 ### 数据放置与范围管理 -| 语句 | TiDB Cloud Dedicated | TiDB Cloud Starter 和 TiDB Cloud Essential | -|:-|:-|:-| -| `ALTER PLACEMENT POLICY` | 支持 | 不支持 [^1] | -| `CREATE PLACEMENT POLICY` | 支持 | 不支持 [^1] | -| `DROP PLACEMENT POLICY` | 支持 | 不支持 [^1] | -| `SHOW CREATE PLACEMENT POLICY` | 支持 | 不支持 [^1] | -| `SHOW PLACEMENT` | 支持 | 不支持 [^1] | -| `SHOW PLACEMENT FOR` | 支持 | 不支持 [^1] | -| `SHOW PLACEMENT LABELS` | 支持 | 不支持 [^1] | -| `SHOW TABLE REGIONS` | 支持 | 不支持 [^1] | -| `SPLIT REGION` | 支持 | 不支持 [^1] | +| 语句 | TiDB Cloud Dedicated | +|:-|:-| +| `ALTER PLACEMENT POLICY` | 支持 | +| `CREATE PLACEMENT POLICY` | 支持 | +| `DROP PLACEMENT POLICY` | 支持 | +| `SHOW CREATE PLACEMENT POLICY` | 支持 | +| `SHOW PLACEMENT` | 支持 | +| `SHOW PLACEMENT FOR` | 支持 | +| `SHOW PLACEMENT LABELS` | 支持 | +| `SHOW TABLE REGIONS` | 支持 | +| `SPLIT REGION` | 支持 | ### 资源组 -| 语句 | TiDB Cloud Dedicated | TiDB Cloud Starter 和 TiDB Cloud Essential | -|:-|:-|:-| -| `ALTER RESOURCE GROUP` | 支持 | 不支持 [^2] | -| `CALIBRATE RESOURCE` | 不支持 | 不支持 [^2] | -| `CREATE RESOURCE GROUP` | 支持 | 不支持 [^2] | -| `DROP RESOURCE GROUP` | 支持 | 不支持 [^2] | -| `SET RESOURCE GROUP` | 支持 | 不支持 [^2] | -| `SHOW CREATE RESOURCE GROUP` | 支持 | 不支持 [^2] | +| 语句 | TiDB Cloud Dedicated | +|:-|:-| +| `ALTER RESOURCE GROUP` | 支持 | +| `CALIBRATE RESOURCE` | 不支持 | +| `CREATE RESOURCE GROUP` | 支持 | +| `DROP RESOURCE GROUP` | 支持 | +| `SET RESOURCE GROUP` | 支持 | +| `SHOW CREATE RESOURCE GROUP` | 支持 | ### 其他 -| 语句 | TiDB Cloud Dedicated | TiDB Cloud Starter 和 TiDB Cloud Essential | -|:-|:-|:-| -| `BACKUP` | 支持 | 不支持 [^3] | -| `SHOW BACKUPS` | 支持 | 不支持 [^3] | -| `RESTORE` | 支持 | 不支持 [^3] | -| `SHOW RESTORES` | 支持 | 不支持 [^3] | -| `ADMIN RESET TELEMETRY_ID` | 支持 | TiDB Cloud Starter 和 TiDB Cloud Essential 不支持 Telemetry。 | -| `ADMIN SHOW TELEMETRY` | 不支持 [^4] | 不支持 [^4] | -| `ADMIN SHOW SLOW` | 支持 | 不支持 [^5] | -| `ADMIN PLUGINS ENABLE` | 支持 | 不支持 [^8] | -| `ADMIN PLUGINS DISABLE` | 支持 | 不支持 [^8] | -| `ALTER INSTANCE RELOAD TLS` | 支持 | TiDB Cloud Starter 和 TiDB Cloud Essential 会自动刷新 TLS 证书。 | -| `LOAD DATA INFILE` | 支持 `LOAD DATA LOCAL INFILE`，以及从 Amazon S3 或 Google Cloud Storage 的 `LOAD DATA INFILE` | 仅支持 `LOAD DATA LOCAL INFILE` | -| `CHANGE DRAINER` | 不支持 [^7] | 不支持 [^7] | -| `CHANGE PUMP` | 不支持 [^7] | 不支持 [^7] | -| `FLASHBACK CLUSTER` | 支持 | 不支持 [^3] | -| `LOAD STATS` | 支持 | 不支持 | -| `SELECT ... INTO OUTFILE` | 不支持 [^4] | 不支持 [^4] | -| `SET CONFIG` | 不支持 [^4] | 不支持 [^4] | -| `SHOW CONFIG` | 不支持 [^4] | 不支持 [^4] | -| `SHOW DRAINER STATUS` | 不支持 [^7] | 不支持 [^7] | -| `SHOW PLUGINS` | 支持 | 不支持 [^8] | -| `SHOW PUMP STATUS` | 不支持 [^7] | 不支持 [^7] | -| `SHUTDOWN` | 不支持 [^4] | 不支持 [^4] | -| `PLAN REPLAYER` | 支持 | 以不同方式支持 [^11] | +| 语句 | TiDB Cloud Dedicated | +|:-|:-| +| `BACKUP` | 支持 | +| `SHOW BACKUPS` | 支持 | +| `RESTORE` | 支持 | +| `SHOW RESTORES` | 支持 | +| `ADMIN RESET TELEMETRY_ID` | 支持 | +| `ADMIN SHOW TELEMETRY` | 不支持 [^1] | +| `ADMIN SHOW SLOW` | 支持 | +| `ADMIN PLUGINS ENABLE` | 支持 | +| `ADMIN PLUGINS DISABLE` | 支持 | +| `ALTER INSTANCE RELOAD TLS` | 支持 | +| `LOAD DATA INFILE` | 支持 `LOAD DATA LOCAL INFILE`，以及从 Amazon S3 或 Google Cloud Storage 的 `LOAD DATA INFILE` | +| `CHANGE DRAINER` | 不支持 [^2] | +| `CHANGE PUMP` | 不支持 [^2] | +| `FLASHBACK CLUSTER` | 支持 | +| `LOAD STATS` | 支持 | +| `SELECT ... INTO OUTFILE` | 不支持 [^1] | +| `SET CONFIG` | 不支持 [^1] | +| `SHOW CONFIG` | 不支持 [^1] | +| `SHOW DRAINER STATUS` | 不支持 [^2] | +| `SHOW PLUGINS` | 支持 | +| `SHOW PUMP STATUS` | 不支持 [^2] | +| `SHUTDOWN` | 不支持 [^1] | +| `PLAN REPLAYER` | 支持 | ## 函数与运算符 -| 函数与运算符 | TiDB Cloud Dedicated | TiDB Cloud Starter 和 TiDB Cloud Essential | -|:-|:-|:-| -| `SLEEP` | 无限制 | [`SLEEP()` 函数](https://docs.pingcap.com/tidbcloud/miscellaneous-functions) 有限制，最大支持 300 秒的休眠时间。| +| 函数与运算符 | TiDB Cloud Dedicated | +|:-|:-| +| `SLEEP` | 无限制 | ## 系统表 -| 数据库 | 表 | TiDB Cloud Dedicated | TiDB Cloud Starter 和 TiDB Cloud Essential | -|:-|:-|:-|:-| -| `information_schema` | `ATTRIBUTES` | 支持 | 不支持 [^1] | -| `information_schema` | `CLUSTER_CONFIG` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `CLUSTER_HARDWARE` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `CLUSTER_INFO` | 支持 | 不支持 [^1] | -| `information_schema` | `CLUSTER_LOAD` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `CLUSTER_LOG` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `CLUSTER_SLOW_QUERY` | 支持 | 不支持 [^5] | -| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY` | 支持 | 不支持 [^6] | -| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY_EVICTED` | 支持 | 不支持 [^6] | -| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY_HISTORY` | 支持 | 不支持 [^6] | -| `information_schema` | `CLUSTER_SYSTEMINFO` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `INSPECTION_RESULT` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `INSPECTION_RULES` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `INSPECTION_SUMMARY` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `METRICS_SUMMARY` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `METRICS_SUMMARY_BY_LABEL` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `METRICS_TABLES` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `PLACEMENT_POLICIES` | 支持 | 不支持 [^1] | -| `information_schema` | `RESOURCE_GROUPS` | 支持 | 不支持 [^2] | -| `information_schema` | `SLOW_QUERY` | 支持 | 不支持 [^5] | -| `information_schema` | `STATEMENTS_SUMMARY` | 支持 | 不支持 [^6] | -| `information_schema` | `STATEMENTS_SUMMARY_EVICTED` | 支持 | 不支持 [^6] | -| `information_schema` | `TIDB_HOT_REGIONS` | 不支持 [^4] | 不支持 [^4] | -| `information_schema` | `TIDB_HOT_REGIONS_HISTORY` | 支持 | 不支持 [^1] | -| `information_schema` | `TIDB_SERVERS_INFO` | 支持 | 不支持 [^1] | -| `information_schema` | `TIKV_REGION_PEERS` | 支持 | 不支持 [^1] | -| `information_schema` | `TIKV_REGION_STATUS` | 支持 | 不支持 [^1] | -| `information_schema` | `TIKV_STORE_STATUS` | 支持 | 不支持 [^1] | -| `performance_schema` | `pd_profile_allocs` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `pd_profile_block` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `pd_profile_cpu` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `pd_profile_goroutines` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `pd_profile_memory` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `pd_profile_mutex` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `tidb_profile_allocs` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `tidb_profile_block` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `tidb_profile_cpu` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `tidb_profile_goroutines` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `tidb_profile_memory` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `tidb_profile_mutex` | 不支持 [^4] | 不支持 [^4] | -| `performance_schema` | `tikv_profile_cpu` | 不支持 [^4] | 不支持 [^4] | -| `mysql` | `expr_pushdown_blacklist` | 不支持 [^4] | 不支持 [^4] | -| `mysql` | `gc_delete_range` | 不支持 [^4] | 不支持 [^4] | -| `mysql` | `gc_delete_range_done` | 不支持 [^4] | 不支持 [^4] | -| `mysql` | `opt_rule_blacklist` | 不支持 [^4] | 不支持 [^4] | -| `mysql` | `tidb` | 不支持 [^4] | 不支持 [^4] | +| 数据库 | 表 | TiDB Cloud Dedicated | +|:-|:-|:-| +| `information_schema` | `ATTRIBUTES` | 支持 | +| `information_schema` | `CLUSTER_CONFIG` | 不支持 [^1] | +| `information_schema` | `CLUSTER_HARDWARE` | 不支持 [^1] | +| `information_schema` | `CLUSTER_INFO` | 支持 | +| `information_schema` | `CLUSTER_LOAD` | 不支持 [^1] | +| `information_schema` | `CLUSTER_LOG` | 不支持 [^1] | +| `information_schema` | `CLUSTER_SLOW_QUERY` | 支持 | +| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY` | 支持 | +| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY_EVICTED` | 支持 | +| `information_schema` | `CLUSTER_STATEMENTS_SUMMARY_HISTORY` | 支持 | +| `information_schema` | `CLUSTER_SYSTEMINFO` | 不支持 [^1] | +| `information_schema` | `INSPECTION_RESULT` | 不支持 [^1] | +| `information_schema` | `INSPECTION_RULES` | 不支持 [^1] | +| `information_schema` | `INSPECTION_SUMMARY` | 不支持 [^1] | +| `information_schema` | `METRICS_SUMMARY` | 不支持 [^1] | +| `information_schema` | `METRICS_SUMMARY_BY_LABEL` | 不支持 [^1] | +| `information_schema` | `METRICS_TABLES` | 不支持 [^1] | +| `information_schema` | `PLACEMENT_POLICIES` | 支持 | +| `information_schema` | `RESOURCE_GROUPS` | 支持 | +| `information_schema` | `SLOW_QUERY` | 支持 | +| `information_schema` | `STATEMENTS_SUMMARY` | 支持 | +| `information_schema` | `STATEMENTS_SUMMARY_EVICTED` | 支持 | +| `information_schema` | `TIDB_HOT_REGIONS` | 不支持 [^1] | +| `information_schema` | `TIDB_HOT_REGIONS_HISTORY` | 支持 | +| `information_schema` | `TIDB_SERVERS_INFO` | 支持 | +| `information_schema` | `TIKV_REGION_PEERS` | 支持 | +| `information_schema` | `TIKV_REGION_STATUS` | 支持 | +| `information_schema` | `TIKV_STORE_STATUS` | 支持 | +| `performance_schema` | `pd_profile_allocs` | 不支持 [^1] | +| `performance_schema` | `pd_profile_block` | 不支持 [^1] | +| `performance_schema` | `pd_profile_cpu` | 不支持 [^1] | +| `performance_schema` | `pd_profile_goroutines` | 不支持 [^1] | +| `performance_schema` | `pd_profile_memory` | 不支持 [^1] | +| `performance_schema` | `pd_profile_mutex` | 不支持 [^1] | +| `performance_schema` | `tidb_profile_allocs` | 不支持 [^1] | +| `performance_schema` | `tidb_profile_block` | 不支持 [^1] | +| `performance_schema` | `tidb_profile_cpu` | 不支持 [^1] | +| `performance_schema` | `tidb_profile_goroutines` | 不支持 [^1] | +| `performance_schema` | `tidb_profile_memory` | 不支持 [^1] | +| `performance_schema` | `tidb_profile_mutex` | 不支持 [^1] | +| `performance_schema` | `tikv_profile_cpu` | 不支持 [^1] | +| `mysql` | `expr_pushdown_blacklist` | 不支持 [^1] | +| `mysql` | `gc_delete_range` | 不支持 [^1] | +| `mysql` | `gc_delete_range_done` | 不支持 [^1] | +| `mysql` | `opt_rule_blacklist` | 不支持 [^1] | +| `mysql` | `tidb` | 不支持 [^1] | ## 系统变量 -| 变量 | TiDB Cloud Dedicated | TiDB Cloud Starter 和 TiDB Cloud Essential | -|:-|:-|:-| -| `datadir` | 无限制 | 不支持 [^1] | -| `interactive_timeout` | 无限制 | 只读 [^10] | -| `max_allowed_packet` | 无限制 | 只读 [^10] | -| `plugin_dir` | 无限制 | 不支持 [^8] | -| `plugin_load` | 无限制 | 不支持 [^8] | -| `require_secure_transport` | 不支持 [^12] | 只读 [^10] | -| `skip_name_resolve` | 无限制 | 只读 [^10] | -| `sql_log_bin` | 无限制 | 只读 [^10] | -| `tidb_analyze_skip_column_types` | 无限制 | 只读 [^10] | -| `tidb_cdc_write_source` | 无限制 | 只读 [^10] | -| `tidb_check_mb4_value_in_utf8` | 不支持 [^4] | 不支持 [^4] | -| `tidb_config` | 不支持 [^4] | 不支持 [^4] | -| `tidb_ddl_disk_quota` | 无限制 | 只读 [^10] | -| `tidb_ddl_enable_fast_reorg` | 无限制 | 只读 [^10] | -| `tidb_ddl_error_count_limit` | 无限制 | 只读 [^10] | -| `tidb_ddl_flashback_concurrency` | 无限制 | 只读 [^10] | -| `tidb_ddl_reorg_batch_size` | 无限制 | 只读 [^10] | -| `tidb_ddl_reorg_priority` | 无限制 | 只读 [^10] | -| `tidb_ddl_reorg_worker_cnt` | 无限制 | 只读 [^10] | -| `tidb_dml_type` | 无限制 | 只读 [^10] | -| `tidb_enable_1pc` | 无限制 | 只读 [^10] | -| `tidb_enable_async_commit` | 无限制 | 只读 [^10] | -| `tidb_enable_auto_analyze` | 无限制 | 只读 [^10] | -| `tidb_enable_collect_execution_info` | 不支持 [^4] | 不支持 [^4] | -| `tidb_enable_ddl` | 无限制 | 只读 [^10] | -| `tidb_enable_gc_aware_memory_track` | 无限制 | 只读 [^10] | -| `tidb_enable_gogc_tuner` | 无限制 | 只读 [^10] | -| `tidb_enable_local_txn` | 无限制 | 只读 [^10] | -| `tidb_enable_resource_control` | 无限制 | 只读 [^10] | -| `tidb_enable_slow_log` | 不支持 [^4] | 不支持 [^4] | -| `tidb_enable_stmt_summary` | 无限制 | 只读 [^10] | -| `tidb_enable_telemetry` | 不支持 [^4] | 不支持 [^4] | -| `tidb_enable_top_sql` | 无限制 | 只读 [^10] | -| `tidb_enable_tso_follower_proxy` | 无限制 | 只读 [^10] | -| `tidb_expensive_query_time_threshold` | 不支持 [^4] | 不支持 [^4] | -| `tidb_force_priority` | 不支持 [^4] | 不支持 [^4] | -| `tidb_gc_concurrency` | 无限制 | 只读 [^10] | -| `tidb_gc_enable` | 无限制 | 只读 [^10] | -| `tidb_gc_max_wait_time` | 无限制 | 只读 [^10] | -| `tidb_gc_run_interval` | 无限制 | 只读 [^10] | -| `tidb_gc_scan_lock_mode` | 无限制 | 只读 [^10] | -| `tidb_general_log` | 不支持 [^4] | 不支持 [^4] | -| `tidb_generate_binary_plan` | 无限制 | 只读 [^10] | -| `tidb_gogc_tuner_threshold` | 无限制 | 只读 [^10] | -| `tidb_guarantee_linearizability` | 无限制 | 只读 [^10] | -| `tidb_isolation_read_engines` | 无限制 | 只读 [^10] | -| `tidb_log_file_max_days` | 无限制 | 只读 [^10] | -| `tidb_memory_usage_alarm_ratio` | 不支持 [^4] | 不支持 [^4] | -| `tidb_metric_query_range_duration` | 不支持 [^4] | 不支持 [^4] | -| `tidb_metric_query_step` | 不支持 [^4] | 不支持 [^4] | -| `tidb_opt_write_row_id` | 不支持 [^4] | 不支持 [^4] | -| `tidb_placement_mode` | 无限制 | 只读 [^10] | -| `tidb_pprof_sql_cpu` | 不支持 [^4] | 不支持 [^4] | -| `tidb_record_plan_in_slow_log` | 不支持 [^4] | 不支持 [^4] | -| `tidb_redact_log` | 不支持 [^4] | 不支持 [^4] | -| `tidb_replica_read` | 无限制 | 只读 [^10] | -| `tidb_restricted_read_only` | 不支持 [^4] | 不支持 [^4] | -| `tidb_row_format_version` | 不支持 [^4] | 不支持 [^4] | -| `tidb_scatter_region` | 无限制 | 只读 [^10] | -| `tidb_server_memory_limit` | 无限制 | 只读 [^10] | -| `tidb_server_memory_limit_gc_trigger` | 无限制 | 只读 [^10] | -| `tidb_server_memory_limit_sess_min_size` | 无限制 | 只读 [^10] | -| `tidb_simplified_metrics` | 无限制 | 只读 [^10] | -| `tidb_slow_query_file` | 不支持 [^4] | 不支持 [^4] | -| `tidb_slow_log_threshold` | 不支持 [^4] | 不支持 [^4] | -| `tidb_slow_txn_log_threshold` | 不支持 [^4] | 不支持 [^4] | -| `tidb_stats_load_sync_wait` | 无限制 | 只读 [^10] | -| `tidb_stmt_summary_history_size` | 无限制 | 只读 [^10] | -| `tidb_stmt_summary_internal_query` | 无限制 | 只读 [^10] | -| `tidb_stmt_summary_max_sql_length` | 无限制 | 只读 [^10] | -| `tidb_stmt_summary_max_stmt_count` | 无限制 | 只读 [^10] | -| `tidb_stmt_summary_refresh_interval` | 无限制 | 只读 [^10] | -| `tidb_sysproc_scan_concurrency` | 无限制 | 只读 [^10] | -| `tidb_top_sql_max_meta_count` | 不支持 [^4] | 不支持 [^4] | -| `tidb_top_sql_max_time_series_count` | 不支持 [^4] | 不支持 [^4] | -| `tidb_tso_client_batch_max_wait_time` | 无限制 | 只读 [^10] | -| `tidb_ttl_delete_batch_size` | 无限制 | 只读 [^10] | -| `tidb_ttl_delete_rate_limit` | 无限制 | 只读 [^10] | -| `tidb_ttl_delete_worker_count` | 无限制 | 只读 [^10] | -| `tidb_ttl_job_schedule_window_end_time` | 无限制 | 只读 [^10] | -| `tidb_ttl_job_schedule_window_start_time` | 无限制 | 只读 [^10] | -| `tidb_ttl_running_tasks` | 无限制 | 只读 [^10] | -| `tidb_ttl_scan_batch_size` | 无限制 | 只读 [^10] | -| `tidb_ttl_scan_worker_count` | 无限制 | 只读 [^10] | -| `tidb_txn_mode` | 无限制 | 只读 [^10] | -| `tidb_wait_split_region_finish` | 无限制 | 只读 [^10] | -| `tidb_wait_split_region_timeout` | 无限制 | 只读 [^10] | -| `txn_scope` | 无限制 | 只读 [^10] | -| `validate_password.enable` | 无限制 | 始终启用 [^9] | -| `validate_password.length` | 无限制 | 至少为 `8` [^9] | -| `validate_password.mixed_case_count` | 无限制 | 至少为 `1` [^9] | -| `validate_password.number_count` | 无限制 | 至少为 `1` [^9] | -| `validate_password.policy` | 无限制 | 只能为 `MEDIUM` 或 `STRONG` [^9] | -| `validate_password.special_char_count` | 无限制 | 至少为 `1` [^9] | -| `wait_timeout` | 无限制 | 只读 [^10] | - -[^1]: TiDB Cloud Starter 和 TiDB Cloud Essential 不支持配置数据放置。 - -[^2]: TiDB Cloud Starter 和 TiDB Cloud Essential 不支持配置资源组。 - -[^3]: 在 TiDB Cloud Starter 或 TiDB Cloud Essential 上进行 [备份与恢复](/tidb-cloud/backup-and-restore-serverless.md) 操作时，可以使用 TiDB Cloud 控制台代替。 - -[^4]: 该功能在 [安全增强模式（SEM）](/system-variables.md#tidb_enable_enhanced_security) 下不可用。 - -[^5]: 在 TiDB Cloud Starter 或 TiDB Cloud Essential 上追踪 [慢查询](/tidb-cloud/tune-performance.md#slow-query) 时，可以使用 TiDB Cloud 控制台代替。 - -[^6]: 在 TiDB Cloud Starter 或 TiDB Cloud Essential 上进行 [语句分析](/tidb-cloud/tune-performance.md#statement-analysis) 时，可以使用 TiDB Cloud 控制台代替。 - -[^7]: TiDB Cloud 不支持 Drainer 和 Pump。 - -[^8]: TiDB Cloud Starter 和 TiDB Cloud Essential 不支持插件。 - -[^9]: TiDB Cloud Starter 和 TiDB Cloud Essential 强制执行强密码策略。 - -[^10]: 该变量在 TiDB Cloud Starter 和 TiDB Cloud Essential 上为只读。 - -[^11]: TiDB Cloud Starter 和 TiDB Cloud Essential 不支持像[示例](https://docs.pingcap.com/tidb/stable/sql-plan-replayer#examples-of-exporting-cluster-information)中那样通过 `${tidb-server-status-port}` 下载 `PLAN REPLAYER` 导出的文件。取而代之，TiDB Cloud Starter 和 TiDB Cloud Essential 会为你生成一个 [presigned URL](https://docs.aws.amazon.com/AmazonS3/latest/userguide/ShareObjectPreSignedURL.html) 用于下载文件。注意该 URL 在生成后 10 小时内有效。 - -[^12]: 不支持。在 TiDB Cloud Dedicated 集群上启用 `require_secure_transport` 会导致 SQL 客户端连接失败。 \ No newline at end of file +| 变量 | TiDB Cloud Dedicated | +|:-|:-| +| `datadir` | 无限制 | +| `interactive_timeout` | 无限制 | +| `max_allowed_packet` | 无限制 | +| `plugin_dir` | 无限制 | +| `plugin_load` | 无限制 | +| `require_secure_transport` | 不支持 [^3] | +| `skip_name_resolve` | 无限制 | +| `sql_log_bin` | 无限制 | +| `tidb_analyze_skip_column_types` | 无限制 | +| `tidb_cdc_write_source` | 无限制 | +| `tidb_check_mb4_value_in_utf8` | 不支持 [^1] | +| `tidb_config` | 不支持 [^1] | +| `tidb_ddl_disk_quota` | 无限制 | +| `tidb_ddl_enable_fast_reorg` | 无限制 | +| `tidb_ddl_error_count_limit` | 无限制 | +| `tidb_ddl_flashback_concurrency` | 无限制 | +| `tidb_ddl_reorg_batch_size` | 无限制 | +| `tidb_ddl_reorg_priority` | 无限制 | +| `tidb_ddl_reorg_worker_cnt` | 无限制 | +| `tidb_dml_type` | 无限制 | +| `tidb_enable_1pc` | 无限制 | +| `tidb_enable_async_commit` | 无限制 | +| `tidb_enable_auto_analyze` | 无限制 | +| `tidb_enable_collect_execution_info` | 不支持 [^1] | +| `tidb_enable_ddl` | 无限制 | +| `tidb_enable_gc_aware_memory_track` | 无限制 | +| `tidb_enable_gogc_tuner` | 无限制 | +| `tidb_enable_local_txn` | 无限制 | +| `tidb_enable_resource_control` | 无限制 | +| `tidb_enable_slow_log` | 不支持 [^1] | +| `tidb_enable_stmt_summary` | 无限制 | +| `tidb_enable_telemetry` | 不支持 [^1] | +| `tidb_enable_top_sql` | 无限制 | +| `tidb_enable_tso_follower_proxy` | 无限制 | +| `tidb_expensive_query_time_threshold` | 不支持 [^1] | +| `tidb_force_priority` | 不支持 [^1] | +| `tidb_gc_concurrency` | 无限制 | +| `tidb_gc_enable` | 无限制 | +| `tidb_gc_max_wait_time` | 无限制 | +| `tidb_gc_run_interval` | 无限制 | +| `tidb_gc_scan_lock_mode` | 无限制 | +| `tidb_general_log` | 不支持 [^1] | +| `tidb_generate_binary_plan` | 无限制 | +| `tidb_gogc_tuner_threshold` | 无限制 | +| `tidb_guarantee_linearizability` | 无限制 | +| `tidb_isolation_read_engines` | 无限制 | +| `tidb_log_file_max_days` | 无限制 | +| `tidb_memory_usage_alarm_ratio` | 不支持 [^1] | +| `tidb_metric_query_range_duration` | 不支持 [^1] | +| `tidb_metric_query_step` | 不支持 [^1] | +| `tidb_opt_write_row_id` | 不支持 [^1] | +| `tidb_placement_mode` | 无限制 | +| `tidb_pprof_sql_cpu` | 不支持 [^1] | +| `tidb_record_plan_in_slow_log` | 不支持 [^1] | +| `tidb_redact_log` | 不支持 [^1] | +| `tidb_replica_read` | 无限制 | +| `tidb_restricted_read_only` | 不支持 [^1] | +| `tidb_row_format_version` | 不支持 [^1] | +| `tidb_scatter_region` | 无限制 | +| `tidb_server_memory_limit` | 无限制 | +| `tidb_server_memory_limit_gc_trigger` | 无限制 | +| `tidb_server_memory_limit_sess_min_size` | 无限制 | +| `tidb_simplified_metrics` | 无限制 | +| `tidb_slow_query_file` | 不支持 [^1] | +| `tidb_slow_log_threshold` | 不支持 [^1] | +| `tidb_slow_txn_log_threshold` | 不支持 [^1] | +| `tidb_stats_load_sync_wait` | 无限制 | +| `tidb_stmt_summary_history_size` | 无限制 | +| `tidb_stmt_summary_internal_query` | 无限制 | +| `tidb_stmt_summary_max_sql_length` | 无限制 | +| `tidb_stmt_summary_max_stmt_count` | 无限制 | +| `tidb_stmt_summary_refresh_interval` | 无限制 | +| `tidb_sysproc_scan_concurrency` | 无限制 | +| `tidb_top_sql_max_meta_count` | 不支持 [^1] | +| `tidb_top_sql_max_time_series_count` | 不支持 [^1] | +| `tidb_tso_client_batch_max_wait_time` | 无限制 | +| `tidb_ttl_delete_batch_size` | 无限制 | +| `tidb_ttl_delete_rate_limit` | 无限制 | +| `tidb_ttl_delete_worker_count` | 无限制 | +| `tidb_ttl_job_schedule_window_end_time` | 无限制 | +| `tidb_ttl_job_schedule_window_start_time` | 无限制 | +| `tidb_ttl_running_tasks` | 无限制 | +| `tidb_ttl_scan_batch_size` | 无限制 | +| `tidb_ttl_scan_worker_count` | 无限制 | +| `tidb_txn_mode` | 无限制 | +| `tidb_wait_split_region_finish` | 无限制 | +| `tidb_wait_split_region_timeout` | 无限制 | +| `txn_scope` | 无限制 | +| `validate_password.enable` | 无限制 | +| `validate_password.length` | 无限制 | +| `validate_password.mixed_case_count` | 无限制 | +| `validate_password.number_count` | 无限制 | +| `validate_password.policy` | 无限制 | +| `validate_password.special_char_count` | 无限制 | +| `wait_timeout` | 无限制 | + +[^1]: 该功能在 [安全增强模式（SEM）](/system-variables.md#tidb_enable_enhanced_security) 下不可用。 + +[^2]: TiDB Cloud 不支持 Drainer 和 Pump。 + +[^3]: 不支持。在 TiDB Cloud Dedicated 集群上启用 `require_secure_transport` 会导致 SQL 客户端连接失败。 \ No newline at end of file diff --git a/tidb-cloud/migrate-from-mysql-using-data-migration.md b/tidb-cloud/migrate-from-mysql-using-data-migration.md index de2f3a3f44fbb..371d7d0aab7b8 100644 --- a/tidb-cloud/migrate-from-mysql-using-data-migration.md +++ b/tidb-cloud/migrate-from-mysql-using-data-migration.md @@ -659,7 +659,7 @@ GRANT SELECT, RELOAD, LOCK TABLES, REPLICATION SLAVE, REPLICATION CLIENT ON *.* 例如，你可以在目标 {{{ .dedicated }}} 集群{{{ .essential }}} 实例{{{ .premium }}} 实例中执行以下 `GRANT` 语句来授予相应权限： ```sql -GRANT CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX ON *.* TO 'dm_target_user'@'%'; +GRANT CREATE, SELECT, INSERT, UPDATE, DELETE, ALTER, DROP, INDEX, CREATE VIEW ON *.* TO 'dm_target_user'@'%'; ``` ## 第 1 步：进入数据迁移页面 diff --git a/tidb-cloud/releases/tidb-cloud-release-notes.md b/tidb-cloud/releases/tidb-cloud-release-notes.md index b41cbd7ff86b0..8088762632e41 100644 --- a/tidb-cloud/releases/tidb-cloud-release-notes.md +++ b/tidb-cloud/releases/tidb-cloud-release-notes.md @@ -8,6 +8,60 @@ aliases: ['/zh/tidbcloud/supported-tidb-versions','/zh/tidbcloud/release-notes'] 本页面列出了 [TiDB Cloud](https://www.pingcap.com/tidb-cloud/) 在 2026 年的发布说明。 +## 2026 年 6 月 30 日 {#june-30-2026} + +**常规变更** + +- **TiDB Cloud Essential** + + - 增强 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 的稳定性、安全性和运维体验。以下增强和变更将逐步向新创建的 TiDB Cloud Essential 实例推出。 + + - **改善连接体验**：为新创建的 TiDB Cloud Essential 实例支持独立端点，因此你在连接这些实例时不再需要包含必需的[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)。 + - **支持修改 root 密码**：你可以直接在 TiDB Cloud 控制台中修改 root 密码。 + - **增强数据导入体验**：在导入数据页面中输入源目标字段后，你可以点击 **Test Bucket Access**，在导入数据之前验证对指定对象存储 bucket 的访问。此外，导入页面现在会显示待导入文件的大小，以提升导入操作的可见性和管理能力。 + - **更新 Branch 功能的可用性**：从 **2026 年 7 月 14 日**开始，新创建的 TiDB Cloud Essential 实例将不再支持 [Branch](/tidb-cloud/branch-overview.md) 功能。在此日期之前创建的现有 TiDB Cloud Essential 实例不受影响。Branch 功能在 [TiDB Cloud Starter](/tidb-cloud/select-cluster-tier.md#starter) 中仍然可用。 + - **更新导入和导出能力**：为增强安全性，不再支持从本地文件导入数据以及将数据导出到本地文件。 + - **更新 DB 审计日志存储要求**：出于安全和合规原因，你必须为审计日志保留指定一个外部存储位置。 + - [Changefeed](/tidb-cloud/essential-changefeed-overview.md) 将从 **2026 年 7 月 1 日**起作为一项收费功能提供。 + + 这些功能将分阶段推出。如需抢先体验，请联系 [support@pingcap.com](mailto:support@pingcap.com)。 + + - [Top RU](/tidb-cloud/top-ru.md) 现已在以下 Region 面向 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 开启公测： + + - Alibaba Cloud：`Singapore (ap-southeast-1)` 和 `Tokyo (ap-northeast-1)` + + 此功能会显示分钟级别 RU 消耗最高的 SQL 语句，帮助你快速识别资源消耗最大的查询以降低成本。 + + 此功能将分阶段推出。如需抢先体验，请联系 [support@pingcap.com](mailto:support@pingcap.com)。 + +- **TiDB Cloud Dedicated** + + - 优化 [TiDB Cloud Dedicated](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) 集群的备份和恢复流程。 + + - TiDB Cloud Dedicated 的 **Restore** 页面不再包含 **Restore From Region** 选项。由于 TiDB Cloud Dedicated 会默认将备份数据存储在与集群相同的 Region 中，因此你不再需要选择要从哪个 Region 恢复。 + - **Restore to Region** 选项已重命名为 **Cloud Provider & Region**。 + + 更多信息，请参见[将数据恢复到新集群](/tidb-cloud/backup-and-restore.md)。 + +- **TiDB Cloud Lake** + + - TiDB Cloud Lake 现已进入公测阶段。 + + TiDB Cloud Lake 是 TiDB Cloud 中面向现代分析和 AI 导向数据工作流的云原生分析仓库。它在一项托管服务中提供弹性仓库、ANSI SQL 分析、对象存储、全文搜索、向量搜索和地理空间分析，帮助团队在无需管理独立分析基础设施的情况下分析结构化和半结构化数据。 + + 通过此次公测，你可以使用弹性仓库运行 SQL 分析，并使用内置搜索能力来支持 BI、日志分析、语义检索及其他现代分析和 AI 用例。 + + 如需试用 TiDB Cloud Lake，请登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，在左侧导航栏中点击 **My Lake**，然后点击右上角的 **Try TiDB Cloud Lake**。 + + 更多信息，请参见 [TiDB Cloud Lake documentation](https://docs.pingcap.com/tidbcloudlake/)。 + +**即将进行的计费调整** + +- 以下计费调整将对 [TiDB Cloud Essential](/tidb-cloud/select-cluster-tier.md#essential) 生效： + + - **最小 RCU 计费更新**：从 **2026 年 8 月 1 日**起，最小 RCU 值将根据你配置的最大 RCU 值自动确定（最小 RCU = 0.1 × 配置的最大 RCU，且下限为 2,000 RCU）。如果你的实际使用量始终低于最小 RCU 阈值，TiDB Cloud 将按最小 RCU 值计算费用。对于 **2026 年 7 月 1 日之前创建的现有实例**，此最小 RCU 计费策略的实现将推迟，确切生效日期将于稍后公布。 + - **新增收费功能**：备份使用量和网络出口流量的收费将于 **2026 年 9 月 1 日**起生效。更多信息，请参见 [TiDB Cloud Essential pricing](https://www.pingcap.com/tidb-cloud-essential-pricing-details/)。 + ## 2026 年 6 月 16 日 **常规变更** diff --git a/tidb-cloud/security-concepts.md b/tidb-cloud/security-concepts.md index e6790dbb19e1b..d7bf212235fa6 100644 --- a/tidb-cloud/security-concepts.md +++ b/tidb-cloud/security-concepts.md @@ -235,6 +235,18 @@ TiDB Cloud 通过高级加密能力保护静态数据，确保安全性并符合 - 对于未启用 CMEK 的 TiDB Cloud Dedicated 集群，TiDB Cloud 使用托管密钥；{{{ .starter }}} 和 {{{ .essential }}} 实例仅使用托管密钥。 +**Dual-layer encryption** + +- 双层加密通过两层独立的加密来保护数据。此方法通过防止任一单层加密被攻破来提供增强的安全性。 + + - 运行你的实例或集群的云服务提供商使用其原生存储级别加密机制对所有持久化的静态数据进行加密。 + + - 在云服务提供商加密的基础上，TiDB Cloud 通过使用客户管理的加密密钥 (CMEK) 或托管密钥自动对静态数据进行加密，从而增加第二层加密。 + +- 对于 {{{ .starter }}} 实例，双层加密默认[**禁用**](/tidb-cloud/ticloud-cluster-create.md#flags)；对于 {{{ .essential }}} 实例，双层加密默认**启用**。 + +- {{{ .dedicated }}} 集群**始终使用**双层加密。如果未启用 CMEK，TiDB Cloud 会使用托管密钥对集群中的所有静态数据进行加密。 + **Best practices:** - 定期轮换 CMEK 密钥以增强安全性并满足合规标准。 diff --git a/tidb-cloud/serverless-export.md b/tidb-cloud/serverless-export.md index aa1b74e0e6770..b7510c818f4eb 100644 --- a/tidb-cloud/serverless-export.md +++ b/tidb-cloud/serverless-export.md @@ -21,13 +21,19 @@ TiDB Cloud 支持你将数据从 TiDB Cloud Starter 或 Essential 实例导出 你可以将数据导出到以下位置： -- 本地文件 -- 外部存储，包括： +- 对于 {{{ .starter }}}： - - [Amazon S3](https://aws.amazon.com/s3/) - - [Google Cloud Storage](https://cloud.google.com/storage) - - [Azure Blob Storage](https://azure.microsoft.com/en-us/services/storage/blobs/) - - [阿里云对象存储 OSS](https://www.alibabacloud.com/product/oss) + - 本地文件 + - Amazon S3 + - Google Cloud Storage + - Azure Blob Storage + - 阿里云对象存储 OSS + +- 对于 {{{ .essential }}}： + + - Amazon S3 + - Azure Blob Storage + - 阿里云对象存储 OSS > **注意：** > @@ -35,7 +41,7 @@ TiDB Cloud 支持你将数据从 TiDB Cloud Starter 或 Essential 实例导出 ### 本地文件 -要将 TiDB Cloud Starter 或 Essential 实例中的数据导出到本地文件，你需要 [通过 TiDB Cloud 控制台导出数据](#export-data-to-a-local-file) 或 [使用 TiDB Cloud CLI 导出数据](/tidb-cloud/ticloud-serverless-export-create.md)，然后通过 TiDB Cloud CLI 下载导出数据。 +要将 {{{ .starter }}} 实例中的数据导出到本地文件，你需要 [通过 TiDB Cloud 控制台导出数据](#export-data-to-a-local-file) 或 [使用 TiDB Cloud CLI 导出数据](/tidb-cloud/ticloud-serverless-export-create.md)，然后通过 TiDB Cloud CLI 下载导出数据。 导出到本地文件有以下限制： @@ -98,7 +104,7 @@ TiDB Cloud 支持你将数据从 TiDB Cloud Starter 或 Essential 实例导出 - `separator`：指定导出数据中分隔字段的字符。默认分隔符为 `,`。 - `header`：指定是否在导出数据中包含表头行。默认值为 `true`。 - `null-value`：指定导出数据中表示空值的字符串。默认值为 `\N`。 -- `Parquet`：以 Parquet 格式导出数据。 +- `Parquet`：以 Parquet 格式导出数据。仅适用于 {{{ .starter }}} 数据导出。 schema 和数据的导出文件命名规则如下： @@ -181,7 +187,7 @@ schema 和数据的导出文件命名规则如下： > > 如果你属于多个组织，请先使用左上角的下拉框切换到目标组织。 -2. 点击目标 TiDB Cloud Starter 或 Essential 实例名称进入概览页，然后在左侧导航栏点击 **Data** > **Import**。 +2. 点击目标 {{{ .starter }}} 实例名称进入概览页，然后在左侧导航栏点击 **Data** > **Import**。 3. 在 **Import** 页面，点击右上角的 **Export Data to**，在下拉列表中选择 **Local File**，并填写以下参数： @@ -192,7 +198,7 @@ schema 和数据的导出文件命名规则如下： > **提示：** > - > 如果你的 TiDB Cloud Starter 或 Essential 实例之前未导入或导出过数据，需要在页面底部点击 **Click here to export data to...** 进行数据导出。 + > 如果你的 {{{ .starter }}} 实例之前未导入或导出过数据，需要在页面底部点击 **Click here to export data to...** 进行数据导出。 4. 点击 **Export**。 @@ -276,7 +282,7 @@ ticloud serverless export create -c --target-type S3 --s3.uri > > 如果你属于多个组织，请先使用左上角的下拉框切换到目标组织。 -2. 点击目标 TiDB Cloud Starter 或 Essential 实例名称进入概览页，然后在左侧导航栏点击 **Data** > **Import**。 +2. 点击目标 {{{ .starter }}} 实例名称进入概览页，然后在左侧导航栏点击 **Data** > **Import**。 3. 在 **Import** 页面，点击右上角的 **Export Data to**，在下拉列表中选择 **Google Cloud Storage**，并填写以下参数： @@ -424,7 +430,3 @@ ticloud serverless export cancel -c -e - 如果消费上限大于 0，导出速度最高为 100 MiB/s。 - **TiDB Cloud Essential**：最高 100 MiB/s。 - -## 计费 - -导出服务在公测期间免费。你只需为成功或已取消任务导出过程中产生的 [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) 支付费用。对于失败的导出任务，不会收取费用。 diff --git a/tidb-cloud/serverless-private-link-connection.md b/tidb-cloud/serverless-private-link-connection.md index 035fd4ea9ff9d..d50bf4935b597 100644 --- a/tidb-cloud/serverless-private-link-connection.md +++ b/tidb-cloud/serverless-private-link-connection.md @@ -56,7 +56,11 @@ ticloud serverless private-link-connection zones --cluster-id 2. 点击目标 {{{ .essential }}} 实例名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 -3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection**。 +3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection** 以在 endpoint shared 模式下创建私有端点。在此模式下，同一 AWS Region 中的多个 {{{ .essential }}} 实例可以共享一个私有端点。 + + > **注意：** + > + > 如果你的 TiDB Cloud Essential 实例创建于 2026 年 6 月 30 日之后，且 **Private Link Connection For Dataflow** 区域不可用，你可以改为点击 **AWS Private Endpoint for External Services** 区域中的 **Create Private Endpoint for External Services**，以在 endpoint exclusive 模式下创建私有链路连接。在 endpoint exclusive 模式下，每个 {{{ .essential }}} 实例都使用自己独立的私有端点。此模式在连接时无需包含[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)。 4. 在 **Create Private Link Connection** 对话框中，填写所需信息： @@ -99,7 +103,11 @@ ticloud serverless private-link-connection zones --cluster-id 2. 点击目标 {{{ .essential }}} 实例名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 -3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection**。 +3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection** 以在 endpoint shared 模式下创建私有端点。在此模式下，同一 AWS Region 中的多个 {{{ .essential }}} 实例可以共享一个私有端点。 + + > **注意：** + > + > 如果你的 TiDB Cloud Essential 实例创建于 2026 年 6 月 30 日之后，且 **Private Link Connection For Dataflow** 区域不可用，你可以改为点击 **Amazon MSK Provisioned Private Endpoint for External Services** 区域中的 **Create Private Endpoint for External Services**，以在 endpoint exclusive 模式下创建私有链路连接。在 endpoint exclusive 模式下，每个 {{{ .essential }}} 实例都使用自己独立的私有端点。此模式在连接时无需包含[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)。 4. 在 **Create Private Link Connection** 对话框中，填写所需信息： @@ -136,7 +144,11 @@ ticloud serverless private-link-connection zones --cluster-id 2. 点击目标 {{{ .essential }}} 实例名称进入概览页面，然后在左侧导航栏点击 **Settings** > **Networking**。 -3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection**。 +3. 在 **Private Link Connection For Dataflow** 区域，点击 **Create Private Link Connection** 以在 endpoint shared 模式下创建私有端点。在此模式下，同一阿里云 Region 中的多个 {{{ .essential }}} 实例可以共享一个私有端点。 + + > **注意：** + > + > 如果你的 TiDB Cloud Essential 实例创建于 2026 年 6 月 30 日之后，且 **Private Link Connection For Dataflow** 区域不可用，你可以改为点击 **Alibaba Cloud Private Endpoint for External Services** 区域中的 **Create Private Endpoint for External Services**，以在 endpoint exclusive 模式下创建私有链路连接。在 endpoint exclusive 模式下，每个 {{{ .essential }}} 实例都使用自己独立的私有端点。此模式在连接时无需包含[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)。 4. 在 **Create Private Link Connection** 对话框中，填写所需信息： diff --git a/tidb-cloud/set-up-private-endpoint-connections-serverless.md b/tidb-cloud/set-up-private-endpoint-connections-serverless.md index ae1d8832491c6..5c3060b29f371 100644 --- a/tidb-cloud/set-up-private-endpoint-connections-serverless.md +++ b/tidb-cloud/set-up-private-endpoint-connections-serverless.md @@ -35,9 +35,16 @@ TiDB Cloud 支持通过 [AWS PrivateLink](https://aws.amazon.com/privatelink/?pr 请确保在 AWS VPC 设置中已启用 DNS hostnames 和 DNS resolution。在 [AWS Management Console](https://console.aws.amazon.com/) 中创建 VPC 时，这些选项默认是禁用的。 -## 使用 AWS 设置私有端点 +## 选择端点模型 {#choose-an-endpoint-model} -要通过私有端点连接到你的 TiDB Cloud Starter 或 TiDB Cloud Essential 实例，请按照以下步骤操作： +根据你的 TiDB Cloud 计划，选择合适的私有端点模型： + +- 对于 {{{ .starter }}} 实例，或 2026 年 7 月 1 日之前创建的 {{{ .essential }}} 实例，请使用[**端点共享模型**](#set-up-a-private-endpoint-with-aws-endpoint-shared-model)。在此模型中，同一 AWS Region 和 VPC 中的多个 {{{ .starter }}} 或 {{{ .essential }}} 实例可以共享一个私有端点。 +- 对于从 2026 年 7 月 1 日开始创建的 {{{ .essential }}} 实例，请使用[**端点独占模型**](#set-up-a-private-endpoint-with-aws-endpoint-exclusive-model)。在此模型中，每个 {{{ .essential }}} 实例使用其各自独立的私有端点。此模型无需在连接时包含[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)，但你需要为每个 {{{ .essential }}} 实例重复执行设置步骤。 + +## 使用 AWS 设置私有端点（端点共享模型） {#set-up-a-private-endpoint-with-aws-endpoint-shared-model} + +要使用共享模型通过私有端点连接到你的 {{{ .starter }}} 或 {{{ .essential }}} 实例，请按照以下步骤操作： 1. [选择 {{{ .starter }}} 或 Essential 实例](#step-1-choose-a-tidb-instance) 2. [创建 AWS interface 端点](#step-2-create-an-aws-interface-endpoint) @@ -55,6 +62,34 @@ TiDB Cloud 支持通过 [AWS PrivateLink](https://aws.amazon.com/privatelink/?pr > > 对于 AWS 区域中的每个 VPC，你只需创建一个私有端点。该端点可供该 AWS 区域中同一 VPC 内的所有 {{{ .starter }}} 或 {{{ .essential }}} 实例使用，但不能跨 VPC 共享。 +## 使用 AWS 设置私有端点（端点独占模型） {#set-up-a-private-endpoint-with-aws-endpoint-exclusive-model} + +> **注意：** +> +> 目前，端点独占模型仅适用于在部分 AWS 区域中从 2026 年 7 月 1 日开始创建的 {{{ .essential }}} 实例。如果你的实例不支持该模型，可以改用[端点共享模型](#set-up-a-private-endpoint-with-aws-endpoint-shared-model)。 + +在端点独占模型中，每个 {{{ .essential }}} 实例使用其各自独立的私有端点。此模型无需在连接时包含[账户前缀](/tidb-cloud/select-cluster-tier.md#user-name-prefix)，但你需要为每个 {{{ .essential }}} 实例重复执行设置步骤。 + +要使用独占模型通过私有端点连接到 {{{ .essential }}} 实例，请按照以下步骤操作： + +1. [选择 {{{ .essential }}} 实例](#step-1-select-an-essential-instance) +2. [创建 AWS interface 端点](#step-2-create-an-aws-interface-endpoint-exclusive-model) +3. [创建私有端点连接](#step-3-create-a-private-endpoint-connection-exclusive-model) +4. [启用私有 DNS](#step-4-enable-private-dns-exclusive-model) +5. [连接到你的 {{{ .essential }}} 实例](#step-5-connect-to-your-essential-instance) + +如果你有多个实例，则需要为每个要使用 AWS PrivateLink 连接的实例重复执行这些步骤。 + +### Step 1. 选择 {{{ .essential }}} 实例 {#step-1-select-an-essential-instance} + +1. 在 TiDB Cloud 控制台的 [**My TiDB**](https://tidbcloud.com/tidbs) 页面，点击目标 {{{ .essential }}} 实例的名称，进入其概览页面。 +2. 点击右上角的 **Connect**。此时会显示连接对话框。 +3. 在 **Connection Type** 下拉列表中，选择 **Private Endpoint**，然后点击 **Create Private Endpoint Connection**。 + +> **注意：** +> +> 如果你已经创建了私有端点连接，活动端点将显示在连接对话框中。要创建更多私有端点连接，请在左侧导航栏中点击 **Settings** > **Networking**，进入 **Networking** 页面。 + ### Step 2. 创建 AWS interface 端点 @@ -143,6 +178,123 @@ aws ec2 create-vpc-endpoint --vpc-id ${your_vpc_id} --region ${region_id} --serv > > 创建 VPC 端点时，如果遇到错误 `private-dns-enabled cannot be set because there is already a conflicting DNS domain for gatewayXX-privatelink.XX.prod.aws.tidbcloud.com in the VPC vpc-XXXXX`，说明该 VPC 中已存在一个私有端点。对于相同的私有 DNS 名称，你无需再创建另一个端点。 +### Step 2. 创建 AWS interface 端点 {#step-2-create-an-aws-interface-endpoint-exclusive-model} + +> **注意：** +> +> 对于每个 {{{ .essential }}} 实例，相应的端点服务会在实例创建后 3 到 4 分钟自动创建。 + +在连接对话框中，如果你看到 `TiDB Private Link Service is ready` 消息，则表示相应的端点服务已就绪。你可以提供以下信息来创建端点。 + +1. 在连接对话框中，点击 **How to Generate VPC Endpoint ID**，然后填写 **Your VPC ID** 和 **Your Subnet IDs** 字段。你可以从 [AWS Management Console](https://console.aws.amazon.com/) 中找到这些 ID。对于多个子网，请输入以空格分隔的 ID。 + +2. 点击 **Generate Command** 获取以下端点创建命令。 + + ```bash + aws ec2 create-vpc-endpoint --vpc-id ${your_vpc_id} --region ${your_region} --service-name ${your_endpoint_service_name} --vpc-endpoint-type Interface --subnet-ids ${your_application_subnet_ids} + ``` + +然后，你可以使用 AWS CLI 或 [AWS Management Console](https://aws.amazon.com/console/) 创建 AWS interface 端点。 + + +
+ +要使用 AWS CLI 创建 VPC interface 端点，请执行以下步骤： + +1. 复制生成的命令并在终端中运行。 +2. 记录刚刚创建的 VPC 端点 ID。 + +> **Tip:** +> +> - 在运行命令之前，你需要先安装并配置 AWS CLI。详情请参见 [AWS CLI configuration basics](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)。 +> +> - 如果你的服务跨越三个以上的可用区（AZ），你将收到一条错误消息，指出 VPC 端点服务不支持该子网所在的 AZ。当你所选 Region 中除了 {{{ .essential }}} 实例所在的 AZ 之外还存在额外的 AZ 时，就会出现此问题。在这种情况下，你可以联系 [PingCAP Technical Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。 + +
+
+ +要使用 AWS Management Console 创建 VPC interface 端点，请执行以下步骤： + +1. 登录 [AWS Management Console](https://aws.amazon.com/console/)，并在 [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) 打开 Amazon VPC 控制台。 +2. 在导航窗格中点击 **Endpoints**，然后点击右上角的 **Create Endpoint**。 + + 此时会显示 **Create endpoint** 页面。 + + ![Verify endpoint service](/media/tidb-cloud/private-endpoint/create-endpoint-2.png) + +3. 在 **Endpoint settings** 区域中，根据需要填写名称标签，然后选择 **Endpoint services that use NLBs and GWLBs** 选项。 +4. 在 **Service settings** 区域中，输入生成命令中的服务名称 `${your_endpoint_service_name}`（`--service-name ${your_endpoint_service_name}`）。 +5. 点击 **Verify service**。 +6. 在 **Network settings** 区域中，从下拉列表中选择你的 VPC。 +7. 在 **Subnets** 区域中，选择 {{{ .essential }}} 实例所在的可用区。 + + > **Tip:** + > + > 如果你的服务跨越三个以上的可用区（AZ），你可能无法在 **Subnets** 区域中选择 AZ。当你所选 Region 中除了 {{{ .essential }}} 实例所在的 AZ 之外还存在额外的 AZ 时，就会出现此问题。在这种情况下，请联系 [PingCAP Technical Support](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。 + +8. 在 **Security groups** 区域中，正确选择你的安全组。 + + > **注意：** + > + > 确保所选安全组允许你的 EC2 实例通过端口 `4000` 或客户自定义端口进行入站访问。 + +9. 点击 **Create endpoint**。 + +
+ + +### Step 3. 创建私有端点连接 {#step-3-create-a-private-endpoint-connection-exclusive-model} + +1. 返回 TiDB Cloud 控制台。 +2. 在 **Create AWS Private Endpoint Connection** 页面，输入你的 VPC 端点 ID。 +3. 点击 **Create Private Endpoint Connection**。 + +> **Tip:** +> +> 你可以在目标 {{{ .essential }}} 实例的 **Networking** 页面查看和管理私有端点连接。要访问此页面，请在左侧导航栏中点击 **Settings** > **Networking**。 + +### Step 4. 启用私有 DNS {#step-4-enable-private-dns-exclusive-model} + +在 AWS 中启用私有 DNS。你可以使用 AWS CLI 或 AWS Management Console。 + + +
+ +要使用 AWS CLI 启用私有 DNS，请从 **Create Private Endpoint Connection** 页面复制以下 `aws ec2 modify-vpc-endpoint` 命令，并在 AWS CLI 中运行。 + +```bash +aws ec2 modify-vpc-endpoint --vpc-endpoint-id ${your_vpc_endpoint_id} --private-dns-enabled +``` + +或者，你也可以在实例的 **Networking** 页面找到该命令。找到私有端点后，在 **Action** 列中点击 **...** > **Enable DNS**。 + +
+
+ +要在 AWS Management Console 中启用私有 DNS： + +1. 前往 **VPC** > **Endpoints**。 +2. 右键点击你的端点 ID，然后选择 **Modify private DNS name**。 +3. 选中 **Enable for this endpoint** 复选框。 +4. 点击 **Save changes**。 + + ![Enable private DNS](/media/tidb-cloud/private-endpoint/enable-private-dns.png) + +
+ + +### Step 5. 连接到你的 {{{ .essential }}} 实例 {#step-5-connect-to-your-essential-instance} + +接受私有端点连接后，你将被重定向回连接对话框。 + +1. 等待私有端点连接状态从 **System Checking** 变为 **Active**（大约 5 分钟）。 +2. 在 **Connect With** 下拉列表中，选择你偏好的连接方法。相应的连接字符串会显示在对话框底部。 +3. 使用该连接字符串连接到你的实例。 + +> **Tip:** +> +> 如果你无法连接到实例，原因可能是 AWS 中 VPC 端点的安全组设置不正确。请参见[此常见问题](#troubleshooting)获取解决方案。 + ## 故障排查 ### I cannot connect to a {{{ .starter }}} or Essential instance via a private endpoint after enabling private DNS. Why? {#i-cannot-connect-to-a-starter-or-essential-instance-via-a-private-endpoint-after-enabling-private-dns-why} diff --git a/tidb-cloud/set-up-private-endpoint-connections.md b/tidb-cloud/set-up-private-endpoint-connections.md index 270c16c06ae1a..393a79f7f6a64 100644 --- a/tidb-cloud/set-up-private-endpoint-connections.md +++ b/tidb-cloud/set-up-private-endpoint-connections.md @@ -92,7 +92,7 @@ TiDB Cloud 支持通过 [AWS PrivateLink](https://aws.amazon.com/privatelink) > > - 在运行命令前，你需要安装并配置好 AWS CLI。详情请参见 [AWS CLI configuration basics](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html)。 > -> - 如果你的服务跨越了三个以上的可用区（AZ），你会收到一条错误消息，提示 VPC 终端节点服务不支持该子网的可用区。这种情况通常是因为你选择的区域中存在额外的可用区，而你的 TiDB 集群并未部署在该可用区。此时，你可以联系 [PingCAP 技术支持](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。 +> - 如果你的服务跨越三个以上的可用区（AZ），你会收到一条错误消息，提示 VPC 终端节点服务不支持该子网的可用区。这种情况通常是因为你选择的区域中存在额外的可用区，而你的 TiDB 集群并未部署在该可用区。此时，你可以联系 [PingCAP 技术支持](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。
@@ -114,7 +114,7 @@ TiDB Cloud 支持通过 [AWS PrivateLink](https://aws.amazon.com/privatelink) > **Tip:** > - > 如果你的服务跨越了三个以上的可用区（AZ），你可能无法在 **Subnets** 区域选择可用区。这种情况通常是因为你选择的区域中存在额外的可用区，而你的 TiDB 集群并未部署在该可用区。此时，请联系 [PingCAP 技术支持](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。 + > 如果你的服务跨越三个以上的可用区（AZ），你可能无法在 **Subnets** 区域选择可用区。这种情况通常是因为你选择的区域中存在额外的可用区，而你的 TiDB 集群并未部署在该可用区。此时，请联系 [PingCAP 技术支持](https://docs.pingcap.com/tidbcloud/tidb-cloud-support)。 8. 在 **Security groups** 区域，正确选择你的安全组。 diff --git a/tidb-cloud/tidb-cloud-import-local-files.md b/tidb-cloud/tidb-cloud-import-local-files.md index 2b9339e31127e..ce808251ecdd4 100644 --- a/tidb-cloud/tidb-cloud-import-local-files.md +++ b/tidb-cloud/tidb-cloud-import-local-files.md @@ -1,23 +1,23 @@ --- -title: 将本地文件导入 TiDB Cloud Starter 或 Essential -summary: 了解如何将本地文件导入 TiDB Cloud Starter 或 TiDB Cloud Essential。 +title: 将本地文件导入 TiDB Cloud Starter +summary: 了解如何将本地文件导入 TiDB Cloud Starter。 --- -# 将本地文件导入 {{{ .starter }}} 或 Essential +# 将本地文件导入 {{{ .starter }}} -你可以直接将本地文件导入 {{{ .starter }}} 或 {{{ .essential }}}。只需几步简单操作即可完成任务配置，你的本地 CSV 数据就会被快速导入到你的 {{{ .starter }}} 或 Essential 实例中。使用此方法，无需提供云存储和凭证，整个导入过程快速且流畅。 +你可以直接将本地文件导入 {{{ .starter }}}。只需几步简单操作即可完成任务配置，你的本地 CSV 数据就会被快速导入到你的 {{{ .starter }}} 实例中。使用此方法，无需提供云存储和凭证，整个导入过程快速且流畅。 目前，该方法支持每个任务导入一个 CSV 文件到现有的空表或新建表中。 ## 限制 - 目前，TiDB Cloud 仅支持每个任务导入一个大小不超过 250 MiB 的本地 CSV 文件。 -- 本地文件导入仅支持 {{{ .starter }}} 和 {{{ .essential }}} 实例，不支持 TiDB Cloud Dedicated 集群。 +- 本地文件导入仅支持 {{{ .starter }}} 实例，不支持 {{{ .essential }}} 实例或 TiDB Cloud Dedicated 集群。 - 你不能同时运行多个导入任务。 ## 导入本地文件 -1. 打开目标 {{{ .starter }}} 或 Essential 实例的 **Import** 页面。 +1. 打开目标 {{{ .starter }}} 实例的 **Import** 页面。 1. 登录 [TiDB Cloud 控制台](https://tidbcloud.com/)，并导航到 [**My TiDB**](https://tidbcloud.com/tidbs) 页面。 @@ -25,7 +25,7 @@ summary: 了解如何将本地文件导入 TiDB Cloud Starter 或 TiDB Cloud Ess > > 如果你属于多个组织，请先使用左上角的下拉框切换到目标组织。 - 2. 点击目标 {{{ .starter }}} 或 Essential 实例的名称进入其概览页面，然后在左侧导航栏点击 **Data** > **Import**。 + 2. 点击目标 {{{ .starter }}} 实例的名称进入其概览页面，然后在左侧导航栏点击 **Data** > **Import**。 2. 在 **Import** 页面，你可以直接将本地文件拖拽到上传区域，或点击 **Upload a local file** 选择并上传目标本地文件。请注意，每个任务只能上传一个小于 250 MiB 的 CSV 文件。如果你的本地文件大于 250 MiB，请参见 [如何导入大于 250 MiB 的本地文件？](#how-to-import-a-local-file-larger-than-250-mib)。 @@ -85,7 +85,7 @@ summary: 了解如何将本地文件导入 TiDB Cloud Starter 或 TiDB Cloud Ess 不能。目前，使用 Import 功能时，只能将 CSV 文件的所有列导入到现有表中。 -如果只想导入指定的部分列，可以使用 MySQL 客户端连接 {{{ .starter }}} 或 Essential 实例，然后通过 [`LOAD DATA`](https://docs.pingcap.com/tidb/stable/sql-statement-load-data) 指定要导入的列。例如： +如果只想导入指定列，可以使用 MySQL 客户端连接到 {{{ .starter }}} 实例，然后通过 [`LOAD DATA`](https://docs.pingcap.com/tidb/stable/sql-statement-load-data) 指定要导入的列。例如： ```sql CREATE TABLE `import_test` (