tidb: document analyze v1 removal by 0xPoe · Pull Request #22655 · pingcap/docs

0xPoe · 2026-03-30T12:40:07Z

What is changed, added or deleted? (Required)

Document on master that 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)?

This PR is translated from:
Other reference link(s): statistics: deprecate stats v1 in 8.5 docs #22624, *: stop writing analyze v1 stats tidb#66772, session: rewrite tidb_analyze_version=1 to 2 during upgrade tidb#66957

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

gemini-code-assist · 2026-03-30T12:45:27Z

Warning

Gemini is experiencing higher than usual traffic and was unable to create the review. Please try again in a few hours by commenting /gemini review.

fix: correct the job info Signed-off-by: 0xPoe <techregister@pm.me> fix Signed-off-by: 0xPoe <techregister@pm.me>

0xPoe

🔢 Self-check (PR reviewed by myself and ready for feedback)

/cc @qw4990

ti-chi-bot · 2026-03-31T08:51:36Z

@qw4990: adding LGTM is restricted to approvers and reviewers in OWNERS files.

Details

In response to this:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

qiancai

Rest LGTM

Co-authored-by: Grace Cai <qqzczy@126.com>

ti-chi-bot · 2026-04-28T08:34:03Z

[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 ask for approval from qiancai. 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

Co-authored-by: Grace Cai <qqzczy@126.com>

0xPoe

LGTM

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>

Co-authored-by: Grace Cai <qqzczy@126.com>

Oreoxmt · 2026-05-20T07:47:34Z


+> **Note:**
+>
+> Starting from v9.0.0, TiDB no longer support using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. The following example shows the current `ANALYZE` behavior with Statistics Version 2.


Suggested change

> Starting from v9.0.0, TiDB no longer support using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. The following example shows the current `ANALYZE` behavior with Statistics Version 2.

> Starting from v9.0.0, TiDB no longer supports using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. The following example shows the `ANALYZE` behavior with Statistics Version 2.

Oreoxmt · 2026-05-20T07:49:06Z


+> **Warning:**
+>
+> Starting from v9.0.0, TiDB no longer support using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. If you try to set this variable to `1`, TiDB returns an error. For more information, see [Versions of statistics](/statistics.md#versions-of-statistics). TiDB still supports reading existing Version 1 statistics for upgrade compatibility, but all new `ANALYZE` operations use Statistics Version 2 (`tidb_analyze_version = 2`). It is recommended that you use `tidb_analyze_version = 2`.


Suggested change

> Starting from v9.0.0, TiDB no longer support using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. If you try to set this variable to `1`, TiDB returns an error. For more information, see [Versions of statistics](/statistics.md#versions-of-statistics). TiDB still supports reading existing Version 1 statistics for upgrade compatibility, but all new `ANALYZE` operations use Statistics Version 2 (`tidb_analyze_version = 2`). It is recommended that you use `tidb_analyze_version = 2`.

> Starting from v9.0.0, TiDB no longer supports using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. If you try to set this variable to `1`, TiDB returns an error. For more information, see [Versions of statistics](/statistics.md#versions-of-statistics). TiDB still supports reading existing Version 1 statistics for upgrade compatibility, but all new `ANALYZE` operations use Statistics Version 2 (`tidb_analyze_version = 2`). It is recommended that you use `tidb_analyze_version = 2`.

Oreoxmt · 2026-05-20T07:50:35Z

+    - For TiDB Self-Managed, the default value of this variable changed from `1` to `2` starting from v5.3.0.
+    - For TiDB Cloud, the default value of this variable changed from `1` to `2` starting from v6.5.0.


Suggested change

- For TiDB Self-Managed, the default value of this variable changed from `1` to `2` starting from v5.3.0.

- For TiDB Cloud, the default value of this variable changed from `1` to `2` starting from v6.5.0.

- For TiDB Self-Managed, the default value of this variable changes from `1` to `2` starting from v5.3.0.

- For TiDB Cloud, the default value of this variable changes from `1` to `2` starting from v6.5.0.

Oreoxmt

Rest LGTM

ti-chi-bot · 2026-05-20T07:51:01Z

[LGTM Timeline notifier]

Timeline:

2026-04-20 09:51:03.61898373 +0000 UTC m=+1986668.824343787: ☑️ agreed by qiancai.
2026-05-20 07:50:59.859997908 +0000 UTC m=+336989.364128574: ☑️ agreed by Oreoxmt.

ti-chi-bot Bot added missing-translation-status This PR does not have translation status info. size/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Mar 30, 2026

0xPoe changed the title ~~statistics: document analyze v1 removal on master~~ statistics: document analyze v1 removal Mar 30, 2026

0xPoe changed the title ~~statistics: document analyze v1 removal~~ tidb: document analyze v1 removal Mar 30, 2026

0xPoe changed the title ~~tidb: document analyze v1 removal~~ WIP: tidb: document analyze v1 removal Mar 30, 2026

ti-chi-bot Bot added the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Mar 30, 2026

0xPoe force-pushed the poe-patch-analyze-v1-master-docs branch from 83f51f0 to 14da936 Compare March 31, 2026 08:29

statistics: document analyze v1 removal

b541076

fix: correct the job info Signed-off-by: 0xPoe <techregister@pm.me> fix Signed-off-by: 0xPoe <techregister@pm.me>

0xPoe force-pushed the poe-patch-analyze-v1-master-docs branch from 14da936 to b541076 Compare March 31, 2026 08:29

0xPoe changed the title ~~WIP: tidb: document analyze v1 removal~~ tidb: document analyze v1 removal Mar 31, 2026

ti-chi-bot Bot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Mar 31, 2026

0xPoe commented Mar 31, 2026

View reviewed changes

ti-chi-bot Bot requested a review from qw4990 March 31, 2026 08:40

qw4990 approved these changes Mar 31, 2026

View reviewed changes

0xPoe requested a review from qiancai March 31, 2026 08:54

hfxsd added translation/doing This PR's assignee is translating this PR. v9.0-beta.3 This PR/issue applies to TiDB v9.0-beta.3. and removed missing-translation-status This PR does not have translation status info. labels Apr 2, 2026

qiancai self-assigned this Apr 8, 2026

qiancai approved these changes Apr 20, 2026

View reviewed changes

Comment thread information-schema/information-schema-analyze-status.md Outdated

Comment thread statistics.md Outdated

Comment thread statistics.md Outdated

Comment thread system-variables.md Outdated

Comment thread system-variables.md Outdated

Comment thread system-variables.md Outdated

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

Update information-schema/information-schema-analyze-status.md

b82e6fb

Co-authored-by: Grace Cai <qqzczy@126.com>

0xPoe and others added 5 commits April 28, 2026 10:34

Update statistics.md

0482877

Co-authored-by: Grace Cai <qqzczy@126.com>

Update statistics.md

903d4b2

Co-authored-by: Grace Cai <qqzczy@126.com>

Update system-variables.md

c3c7ee8

Co-authored-by: Grace Cai <qqzczy@126.com>

Update system-variables.md

a3c919a

Co-authored-by: Grace Cai <qqzczy@126.com>

Update system-variables.md

b99377c

Co-authored-by: Grace Cai <qqzczy@126.com>

0xPoe commented Apr 28, 2026

View reviewed changes

Comment thread system-variables.md Outdated

0xPoe and others added 2 commits April 28, 2026 10:38

Update system-variables.md

d78459f

fix: correct analyze v1 doc links

5b9d855

qiancai mentioned this pull request Apr 29, 2026

tidb: document analyze v1 removal pingcap/docs-cn#21599

Open

13 tasks

qiancai reviewed Apr 29, 2026

View reviewed changes

Comment thread sql-statements/sql-statement-show-analyze-status.md Outdated

Comment thread statistics.md Outdated

Comment thread statistics.md Outdated

Comment thread system-variables.md Outdated

Comment thread system-variables.md Outdated

qiancai and others added 2 commits April 29, 2026 18:15

minor wording updates

aa61fdd

Update statistics.md

4c20e7e

Co-authored-by: Grace Cai <qqzczy@126.com>

Oreoxmt reviewed May 20, 2026

View reviewed changes

Oreoxmt approved these changes May 20, 2026

View reviewed changes

ti-chi-bot Bot added lgtm and removed needs-1-more-lgtm Indicates a PR needs 1 more LGTM. labels May 20, 2026

	> Starting from v9.0.0, TiDB no longer support using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. The following example shows the current `ANALYZE` behavior with Statistics Version 2.
	> Starting from v9.0.0, TiDB no longer supports using Statistics Version 1 (`tidb_analyze_version = 1`) for new statistics collection. The following example shows the `ANALYZE` behavior with Statistics Version 2.

		- For TiDB Self-Managed, the default value of this variable changed from `1` to `2` starting from v5.3.0.
		- For TiDB Cloud, the default value of this variable changed from `1` to `2` starting from v6.5.0.

Conversation

0xPoe commented Mar 30, 2026

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!

gemini-code-assist Bot commented Mar 30, 2026

Uh oh!

0xPoe left a comment

Choose a reason for hiding this comment

Uh oh!

ti-chi-bot Bot commented Mar 31, 2026

Uh oh!

qiancai left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

ti-chi-bot Bot commented Apr 28, 2026

Uh oh!

0xPoe left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

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 left a comment

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!

5 participants