tidb: document analyze v1 removal#21599
Open
qiancai wants to merge 6 commits intopingcap:masterfrom
Open
Conversation
qiancai
added
translation/from-docs
ti-chi-bot
Bot
added
the
size/XS
Synced from: pingcap/docs#22655 Target PR: pingcap#21599 AI Provider: azure Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
|
Auto-sync completed successfully Source PR: pingcap/docs#22655 Chinese documentation has been updated based on English documentation changes. |
github-actions
Bot
force-pushed
the
poe-patch-analyze-v1-master-docs-22655
branch
from
7380890 to
1768a68
Compare
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
ti-chi-bot
Bot
added
size/M
qiancai
commented
Apr 29, 2026
ti-chi-bot
Bot
added
size/XXL
Collaborator
Author
|
/bot-review |
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
|
|
||
| > **警告：** | ||
| > | ||
| > 从 v9.0.0 起，TiDB 不再支持使用统计信息版本 1（`tidb_analyze_version = 1`）收集新的统计信息。如果你尝试将此变量设置为 `1`，TiDB 会返回错误。出于升级兼容性考虑，TiDB 仍支持读取现有的版本 1 的统计信息，但所有新的 `ANALYZE` 操作都使用统计信息版本 2（`tidb_analyze_version = 2`）。建议使用 `tidb_analyze_version = 2`。 |
There was a problem hiding this comment.
警告信息中“不再支持使用统计信息版本 1”的表述不够精确，建议明确说明是“不再支持使用统计信息版本 1 收集新的统计信息”。同时，建议将“出于升级兼容性考虑”改为“为了升级兼容性”，使语句更通顺。
Suggested change
| > 从 v9.0.0 起，TiDB 不再支持使用统计信息版本 1（`tidb_analyze_version = 1`）收集新的统计信息。如果你尝试将此变量设置为 `1`，TiDB 会返回错误。出于升级兼容性考虑，TiDB 仍支持读取现有的版本 1 的统计信息，但所有新的 `ANALYZE` 操作都使用统计信息版本 2（`tidb_analyze_version = 2`）。建议使用 `tidb_analyze_version = 2`。 | |
| > 从 v9.0.0 起，TiDB 不再支持使用统计信息版本 1（`tidb_analyze_version = 1`）收集新的统计信息。如果你尝试将此变量设置为 `1`，TiDB 会返回错误。为了升级兼容性，TiDB 仍支持读取现有的版本 1 的统计信息，但所有新的 `ANALYZE` 操作都使用统计信息版本 2（`tidb_analyze_version = 2`）。建议使用 `tidb_analyze_version = 2`。 |
| - 类型：整数型 | ||
| - 默认值：`2` | ||
| - 这个变量用于控制 TiDB 收集统计信息的行为。 | ||
| - 对于 TiDB Self-Managed，从 v5.3.0 开始，此变量的默认值已从 `1` 更改为 `2`。 |
There was a problem hiding this comment.
“TiDB Self-Managed” 和 “TiDB Cloud” 的表述不够清晰，建议改为更通用的“自管理 TiDB 集群”和“TiDB Cloud”。
Suggested change
| - 对于 TiDB Self-Managed，从 v5.3.0 开始，此变量的默认值已从 `1` 更改为 `2`。 | |
| - 对于自管理 TiDB 集群，从 v5.3.0 开始，此变量的默认值已从 `1` 更改为 `2`。 |
| - 默认值：`2` | ||
| - 这个变量用于控制 TiDB 收集统计信息的行为。 | ||
| - 对于 TiDB Self-Managed，从 v5.3.0 开始，此变量的默认值已从 `1` 更改为 `2`。 | ||
| - 对于 TiDB Cloud，从 v6.5.0 开始，此变量的默认值已从 `1` 更改为 `2`。 |
There was a problem hiding this comment.
同上，建议将 “TiDB Cloud” 改为更通用的表述。
Suggested change
| - 对于 TiDB Cloud，从 v6.5.0 开始，此变量的默认值已从 `1` 更改为 `2`。 | |
| - 对于 TiDB Cloud，从 v6.5.0 开始，此变量的默认值已从 `1` 更改为 `2`。 |
| - 这个变量用于控制 TiDB 收集统计信息的行为。 | ||
| - 对于 TiDB Self-Managed，从 v5.3.0 开始，此变量的默认值已从 `1` 更改为 `2`。 | ||
| - 对于 TiDB Cloud，从 v6.5.0 开始，此变量的默认值已从 `1` 更改为 `2`。 | ||
| - 如果要升级的集群已经持久化 `tidb_analyze_version = 1` 配置，TiDB 会在升级期间将持久化的全局值重写为 `2`。请注意，升级后，现有的版本 1 统计信息不会自动转换为版本 2 统计信息。建议你[将使用统计信息版本 1 的现有对象迁移到版本 2](/statistics.md#切换统计信息版本)。 |
There was a problem hiding this comment.
“如果要升级的集群已经持久化 tidb_analyze_version = 1 配置” 表述可以更清晰，建议改为“如果待升级的集群已持久化 tidb_analyze_version = 1 配置”。
Suggested change
| - 如果要升级的集群已经持久化 `tidb_analyze_version = 1` 配置，TiDB 会在升级期间将持久化的全局值重写为 `2`。请注意，升级后，现有的版本 1 统计信息不会自动转换为版本 2 统计信息。建议你[将使用统计信息版本 1 的现有对象迁移到版本 2](/statistics.md#切换统计信息版本)。 | |
| - 如果待升级的集群已持久化 `tidb_analyze_version = 1` 配置，TiDB 会在升级期间将持久化的全局值重写为 `2`。请注意，升级后，现有的版本 1 统计信息不会自动转换为版本 2 统计信息。建议你[将使用统计信息版本 1 的现有对象迁移到版本 2](/statistics.md#切换统计信息版本)。 |
|
✅ AI review completed, 20 comments generated. |
ti-chi-bot
Bot
added
size/M
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
qiancai
commented
May 6, 2026
qiancai
commented
May 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What is changed, added or deleted? (Required)
Document on
masterthat Statistics Version 1 (tidb_analyze_version = 1) is no longer supported for new statistics collection. Update the statistics, system variable, and analyze status docs to describe the legacy read-only compatibility path and the migration and upgrade behavior.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?