tidb: add the refresh stats statement by qiancai · Pull Request #21598 · pingcap/docs-cn

qiancai · 2026-04-29T09:05:00Z

First-time contributors' checklist

I've signed the Contributor License Agreement, which is required for the repository owners to accept my contribution.

What is changed, added or deleted? (Required)

Added the documentation for the refresh stats statement.

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions.

What is the related PR or file link(s)?

This PR is translated from: tidb: add the refresh stats statement docs#21873
Other reference link(s): Tracking issue: Refresh Stats Command tidb#61273

Do your changes match any of the following descriptions?

Delete files
Change aliases
Need modification after applied to another branch
Might cause conflicts after applied to another branch

Synced from: pingcap/docs#21873 Target PR: pingcap#21598 AI Provider: azure Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

github-actions · 2026-04-29T09:08:24Z

Auto-sync completed successfully

Source PR: pingcap/docs#21873
Target PR: #21598

Chinese documentation has been updated based on English documentation changes.

ti-chi-bot · 2026-04-29T09:08:36Z

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign lance6716 for approval. For more information see the Code Review Process.
Please ensure that each of them provides their approval before proceeding.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

Oreoxmt · 2026-05-20T08:57:54Z

      - [`PREPARE`](/sql-statements/sql-statement-prepare.md)
      - [`QUERY WATCH`](/sql-statements/sql-statement-query-watch.md)
      - [`RECOVER TABLE`](/sql-statements/sql-statement-recover-table.md)
+      - [`刷新统计信息`](/sql-statements/sql-statement-refresh-stats.md)


Suggested change

- [`刷新统计信息`](/sql-statements/sql-statement-refresh-stats.md)

- [`REFRESH STATS`](/sql-statements/sql-statement-refresh-stats.md)

Oreoxmt · 2026-05-20T09:07:08Z

+
+- **Targets（`RefreshTargetList`）**：
+    - `table_name`：刷新当前数据库中的指定表。
+    - `db_name.table_name`：刷新指定数据库中的指定表。。


Suggested change

- `db_name.table_name`：刷新指定数据库中的指定表。。

- `db_name.table_name`：刷新指定数据库中的指定表。

Oreoxmt · 2026-05-20T09:07:29Z

+
+## 选项
+
+- **Targets（`RefreshTargetList`）**：


Suggested change

- **Targets（`RefreshTargetList`）**：

- **刷新目标（`RefreshTargetList`）**：

Oreoxmt · 2026-05-20T09:07:59Z

+    - `db_name.*`：刷新指定数据库中的所有表。
+    - `*.*`：刷新集群中的所有表。
+- **`FULL`**：将完整的统计信息（例如直方图、TopN 和 CMSketch）加载到内存中，等同于针对本次操作将 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 设置为 `false`。当你需要立即获得完整统计信息时，可使用该选项。
+- **`LITE`**：执行轻量级初始化，等同于设置 `lite-init-stats = true`。该模式会跳过直方图和其他较重的数据结构的加载，直到真正需要时才进行加载。


Suggested change

- **`LITE`**：执行轻量级初始化，等同于设置 `lite-init-stats = true`。该模式会跳过直方图和其他较重的数据结构的加载，直到真正需要时才进行加载。

- **`LITE`**：执行轻量级初始化，等同于设置 `lite-init-stats = true`。该模式会跳过直方图等较重数据结构的加载，直到真正需要时才加载。

Oreoxmt · 2026-05-20T09:08:24Z

+- **`FULL`**：将完整的统计信息（例如直方图、TopN 和 CMSketch）加载到内存中，等同于针对本次操作将 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 设置为 `false`。当你需要立即获得完整统计信息时，可使用该选项。
+- **`LITE`**：执行轻量级初始化，等同于设置 `lite-init-stats = true`。该模式会跳过直方图和其他较重的数据结构的加载，直到真正需要时才进行加载。
+- **`CLUSTER`**：将刷新请求发送到所有 TiDB 服务器。如果不指定该选项，则只有接收到该语句的 TiDB 节点会重新加载其内存中的统计信息。
+- **默认模式**：如果既未指定 `FULL`，也未指定 `LITE`，TiDB 会使用 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 的当前值。


Suggested change

- **默认模式**：如果既未指定 `FULL`，也未指定 `LITE`，TiDB 会使用 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 的当前值。

- **默认模式**：如果既未指定 `FULL`，也未指定 `LITE`，TiDB 会使用 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的当前值。

Oreoxmt · 2026-05-20T09:08:47Z

+  REFRESH STATS orders;
+  ```
+
+- 以轻量级初始化刷新 `sales` 中的所有表：


Suggested change

- 以轻量级初始化刷新 `sales` 中的所有表：

- 以轻量级初始化方式刷新 `sales` 中的所有表：

Oreoxmt · 2026-05-20T09:08:56Z

+
+## MySQL 兼容性
+
+`REFRESH STATS` 是 TiDB 特有的扩展，不属于 MySQL。


Suggested change

`REFRESH STATS` 是 TiDB 特有的扩展，不属于 MySQL。

`REFRESH STATS` 语句是 TiDB 对 MySQL 语法的扩展。

ti-chi-bot · 2026-05-20T09:09:24Z

[LGTM Timeline notifier]

Timeline:

2026-05-20 09:09:24.569276978 +0000 UTC m=+341694.073407653: ☑️ agreed by Oreoxmt.

qiancai added translation/from-docs This PR is translated from a PR in pingcap/docs. v9.0-beta.3 This PR/issue applies to TiDB v9.0-beta.3. labels Apr 29, 2026

ti-chi-bot Bot added the size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. label Apr 29, 2026

Auto-sync: Update Chinese docs from English PR

2182627

Synced from: pingcap/docs#21873 Target PR: pingcap#21598 AI Provider: azure Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

github-actions Bot force-pushed the poe-patch-refresh-stats-21873 branch from 9b7b077 to 2182627 Compare April 29, 2026 09:08

ti-chi-bot Bot added size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. and removed size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. labels Apr 29, 2026

Update sql-statement-overview.md

637ca9b

ti-chi-bot Bot added size/L Denotes a PR that changes 100-499 lines, ignoring generated files. and removed size/XL Denotes a PR that changes 500-999 lines, ignoring generated files. labels May 6, 2026

revise translation

0ef5df6

qiancai commented May 7, 2026

View reviewed changes

Comment thread sql-statements/sql-statement-refresh-stats.md Outdated

Update sql-statements/sql-statement-refresh-stats.md

9a21954

qiancai self-assigned this May 8, 2026

Oreoxmt reviewed May 20, 2026

View reviewed changes

Oreoxmt approved these changes May 20, 2026

View reviewed changes

ti-chi-bot Bot added the needs-1-more-lgtm Indicates a PR needs 1 more LGTM. label May 20, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

tidb: add the refresh stats statement#21598

tidb: add the refresh stats statement#21598
qiancai wants to merge 4 commits into
pingcap:masterfrom
qiancai:poe-patch-refresh-stats-21873

qiancai commented Apr 29, 2026

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

ti-chi-bot Bot commented Apr 29, 2026

Uh oh!

Uh oh!

Oreoxmt May 20, 2026

Uh oh!

Oreoxmt May 20, 2026

Uh oh!

Oreoxmt May 20, 2026

Uh oh!

Oreoxmt May 20, 2026

Uh oh!

Oreoxmt May 20, 2026

Uh oh!

Oreoxmt May 20, 2026

Uh oh!

Oreoxmt May 20, 2026

Uh oh!

ti-chi-bot Bot commented May 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	- [`刷新统计信息`](/sql-statements/sql-statement-refresh-stats.md)
	- [`REFRESH STATS`](/sql-statements/sql-statement-refresh-stats.md)

	- `db_name.table_name`：刷新指定数据库中的指定表。。
	- `db_name.table_name`：刷新指定数据库中的指定表。

	- Targets（`RefreshTargetList`）：
	- 刷新目标（`RefreshTargetList`）：

	- `LITE`：执行轻量级初始化，等同于设置 `lite-init-stats = true`。该模式会跳过直方图和其他较重的数据结构的加载，直到真正需要时才进行加载。
	- `LITE`：执行轻量级初始化，等同于设置 `lite-init-stats = true`。该模式会跳过直方图等较重数据结构的加载，直到真正需要时才加载。

	- 默认模式：如果既未指定 `FULL`，也未指定 `LITE`，TiDB 会使用 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 的当前值。
	- 默认模式：如果既未指定 `FULL`，也未指定 `LITE`，TiDB 会使用 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-从-v710-版本开始引入) 的当前值。

	- 以轻量级初始化刷新 `sales` 中的所有表：
	- 以轻量级初始化方式刷新 `sales` 中的所有表：


		## MySQL 兼容性

		`REFRESH STATS` 是 TiDB 特有的扩展，不属于 MySQL。

	`REFRESH STATS` 是 TiDB 特有的扩展，不属于 MySQL。
	`REFRESH STATS` 语句是 TiDB 对 MySQL 语法的扩展。

Conversation

qiancai commented Apr 29, 2026

First-time contributors' checklist

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

What is the related PR or file link(s)?

Do your changes match any of the following descriptions?

Uh oh!

github-actions Bot commented Apr 29, 2026

Uh oh!

ti-chi-bot Bot commented Apr 29, 2026

Uh oh!

Uh oh!

Oreoxmt May 20, 2026

Choose a reason for hiding this comment

Uh oh!

Oreoxmt May 20, 2026

Choose a reason for hiding this comment

Uh oh!

Oreoxmt May 20, 2026

Choose a reason for hiding this comment

Uh oh!

Oreoxmt May 20, 2026

Choose a reason for hiding this comment

Uh oh!

Oreoxmt May 20, 2026

Choose a reason for hiding this comment

Uh oh!

Oreoxmt May 20, 2026

Choose a reason for hiding this comment

Uh oh!

Oreoxmt May 20, 2026

Choose a reason for hiding this comment

Uh oh!

ti-chi-bot Bot commented May 20, 2026

[LGTM Timeline notifier]

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants