Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 1 addition & 5 deletions TOC-tidb-cloud-essential.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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)
Expand Down
2 changes: 1 addition & 1 deletion TOC-tidb-cloud-premium.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
2 changes: 1 addition & 1 deletion TOC-tidb-cloud-starter.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
4 changes: 2 additions & 2 deletions TOC-tidb-cloud.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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)
Expand Down
2 changes: 1 addition & 1 deletion latest_translation_commit.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
{
"target": "release-8.5",
"sha": "6a3301ed41e2d6edcc5f6d76f06fffdfe029acd5"
"sha": "42da4252914248472710bc8f9d3bb0546015093e"
}
2 changes: 1 addition & 1 deletion mysql-compatibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` 之外的字符集
Expand Down
4 changes: 4 additions & 0 deletions pessimistic-transaction.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 的差异
Expand Down
2 changes: 1 addition & 1 deletion sql-statements/sql-statement-add-index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)。
Expand Down
2 changes: 1 addition & 1 deletion sql-statements/sql-statement-create-index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 类似)。
Expand Down
2 changes: 1 addition & 1 deletion sql-statements/sql-statement-create-table.md
Original file line number Diff line number Diff line change
Expand Up @@ -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。

Expand Down
2 changes: 1 addition & 1 deletion sql-statements/sql-statement-flashback-cluster.md
Original file line number Diff line number Diff line change
Expand Up @@ -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、EssentialPremium 实例上执行该语句。

> **Warning:**
>
Expand Down
2 changes: 1 addition & 1 deletion system-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
- 是否持久化到集群:是
Expand Down
21 changes: 10 additions & 11 deletions tidb-cloud/backup-and-restore.md
Original file line number Diff line number Diff line change
Expand Up @@ -275,13 +275,7 @@ TiDB Cloud Dedicated 集群支持双区域备份,通过将集群所在区域

2. 点击 **Restore**,弹出设置窗口。

3. 在 **Restore Mode** 中,选择 **Restore From Region**,即备份存储的区域。

> **注意**
>
> - **Restore From Region** 的默认值与备份集群相同。

4. 在 **Restore Mode** 中,选择将任意时间点的数据或选定备份恢复到新集群。
3. 在 **Restore Mode** 中,选择将任意时间点的数据或选定备份恢复到新集群。

<SimpleTab>
<div label="Select Time Point">
Expand All @@ -303,19 +297,24 @@ TiDB Cloud Dedicated 集群支持双区域备份,通过将集群所在区域
</div>
</SimpleTab>

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**。

### 恢复已删除的集群

Expand Down
18 changes: 9 additions & 9 deletions tidb-cloud/branch-github-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,27 +11,27 @@ 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

## 开始前的准备

在集成前,请确保你具备以下条件:

- 一个 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**。

Expand All @@ -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 仓库进行连接。

<img src="https://docs-download.pingcap.com/media/images/docs/tidb-cloud/branch/github-connect.png" width="40%" />

## 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 的最新提交创建一个分支。 |
Expand Down Expand Up @@ -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:
Expand All @@ -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) 查看在线演示。

创建该工作流的主要步骤如下:

Expand Down
Loading