Skip to content

master: add v8.5.4 info #20984

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
+8 −8
Open

master: add v8.5.4 info #20984

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
519c80b
Update partitioned-table.md
qiancai Oct 10, 2025
d645440
add v8.5.4 to table distribution docs
qiancai Oct 11, 2025
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
2 changes: 1 addition & 1 deletion partitioned-table.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1689,7 +1689,7 @@ ERROR 8264 (HY000): Global Index is needed for index 'a', since the unique index

在引入全局索引 (Global Index) 之前，TiDB 会为每个分区创建一个局部索引 (Local Index)，即一个分区对应一个局部索引。这种索引方式存在一个[使用限制](#分区键主键和唯一键)：主键和唯一键必须包含所有的分区键，以确保数据的全局唯一性。此外，当查询的数据跨越多个分区时，TiDB 需要扫描各个分区的数据才能返回结果。

为解决这些问题，TiDB 从 v8.3.0 开始引入全局索引。全局索引能覆盖整个表的数据，使得主键和唯一键在不包含分区键的情况下仍能保持全局唯一性。此外，全局索引可以在一次操作中访问多个分区的索引数据，而无需对每个分区的局部索引逐一查找，显著提升了针对非分区键的查询性能。从 v9.0.0 开始，非唯一索引也可以创建为全局索引。
为解决这些问题，TiDB 从 v8.3.0 开始引入全局索引。全局索引能覆盖整个表的数据，使得主键和唯一键在不包含分区键的情况下仍能保持全局唯一性。此外，全局索引可以在一次操作中访问多个分区的索引数据，而无需对每个分区的局部索引逐一查找，显著提升了针对非分区键的查询性能。从 v8.5.4 和 v9.0.0 开始，非唯一索引也可以创建为全局索引。

如果你需要创建全局索引，可以通过在索引定义中添加 `GLOBAL` 关键字来实现。

Expand Down
2 changes: 1 addition & 1 deletion sql-statements/sql-statement-cancel-distribution-job.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: CANCEL DISTRIBUTION JOB
summary: TiDB 数据库中 CANCEL DISTRIBUTION JOB 的使用情况。
---

# CANCEL DISTRIBUTION JOB <span class="version-mark">从 v9.0.0 开始引入</span>
# CANCEL DISTRIBUTION JOB <span class="version-mark">从 v8.5.4 和 v9.0.0 开始引入</span>

`CANCEL DISTRIBUTION JOB` 语句用于取消 TiDB 中通过 [`DISTRIBUTE TABLE`](/sql-statements/sql-statement-distribute-table.md) 语句创建的 Region 调度任务。

Expand Down
2 changes: 1 addition & 1 deletion sql-statements/sql-statement-distribute-table.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: DISTRIBUTE TABLE
summary: 介绍 TiDB 数据库中 DISTRIBUTE TABLE 的使用概况。
---

# DISTRIBUTE TABLE <span class="version-mark">从 v9.0.0 开始引入</span>
# DISTRIBUTE TABLE <span class="version-mark">从 v8.5.4 和 v9.0.0 开始引入</span>

> **警告：**
>
Expand Down
2 changes: 1 addition & 1 deletion sql-statements/sql-statement-show-distribution-jobs.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: SHOW DISTRIBUTION JOBS
summary: 介绍 TiDB 数据库中 SHOW DISTRIBUTION JOBS 的使用概况。
---

# SHOW DISTRIBUTION JOBS <span class="version-mark">从 v9.0.0 开始引入</span>
# SHOW DISTRIBUTION JOBS <span class="version-mark">从 v8.5.4 和 v9.0.0 开始引入</span>

`SHOW DISTRIBUTION JOBS` 语句用于显示当前所有的 Region 调度任务。

Expand Down
8 changes: 4 additions & 4 deletions sql-statements/sql-statement-show-table-distribution.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ title: SHOW TABLE DISTRIBUTION
summary: 介绍 TiDB 数据库中 SHOW TABLE DISTRIBUTION 的使用概况。
---

# SHOW TABLE DISTRIBUTION <span class="version-mark">从 v9.0.0 开始引入</span>
# SHOW TABLE DISTRIBUTION <span class="version-mark">从 v8.5.4 和 v9.0.0 开始引入</span>

`SHOW TABLE DISTRIBUTION` 语句用于显示指定表的 Region 分布情况。

Expand All @@ -19,7 +19,7 @@ TableName ::=

## 示例

显示当前表 `t1` 的 Region 分布情况：
显示当前表 `t` 的 Region 分布情况：

```sql
CREATE TABLE `t` (
Expand All @@ -29,8 +29,8 @@ CREATE TABLE `t` (
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin
PARTITION BY RANGE (`a`)
(PARTITION `p1` VALUES LESS THAN (10000),
PARTITION `p2` VALUES LESS THAN (MAXVALUE)) |
SHOW TABLE t1 DISTRIBUTIONS;
PARTITION `p2` VALUES LESS THAN (MAXVALUE));
SHOW TABLE t DISTRIBUTIONS;
```

```
Expand Down