Skip to content

tidb: add skip-init-stats config #21766

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

Merged
ti-chi-bot merged 11 commits into from
Apr 24, 2026
Merged

tidb: add skip-init-stats config #21766

Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
3b8fb62
tidb: add skip-init-stats config
0xPoe Sep 11, 2025
d391e06
fix: highlight
0xPoe Sep 11, 2025
1c65776
fix: add warning
0xPoe Sep 11, 2025
0afba05
Update tidb-configuration-file.md
0xPoe Sep 11, 2025
7c17bf1
Update tidb-configuration-file.md
0xPoe Sep 11, 2025
41f6572
Update tidb-configuration-file.md
0xPoe Sep 11, 2025
9b37333
Update tidb-configuration-file.md
0xPoe Sep 11, 2025
3af783b
Update tidb-configuration-file.md
0xPoe Sep 22, 2025
3b1d10a
Update tidb-configuration-file.md
0xPoe Sep 22, 2025
3cc56f6
Merge branch 'master' into pr/21766
qiancai Apr 24, 2026
ed3be12
Update tidb-configuration-file.md
qiancai Apr 24, 2026
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
10 changes: 10 additions & 0 deletions tidb-configuration-file.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -637,6 +637,16 @@
+ When the value of `force-init-stats` is `true`, TiDB needs to wait until statistics initialization is finished before providing services upon startup. Note that if there are a large number of tables and partitions and the value of [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) is `false`, setting `force-init-stats` to `true` might prolong the time it takes for TiDB to start providing services.
+ When the value of `force-init-stats` is `false`, TiDB can still provide services before statistics initialization is finished, but the optimizer uses pseudo statistics to make decisions, which might result in suboptimal execution plans.

### skip-init-stats <span class="version-mark">New in v9.0.0</span>

> **Warning:**
>
> This configuration item is for maintenance purposes only. Do not enable it on TiDB nodes that handle regular workloads.

+ Controls whether to skip statistics initialization during TiDB startup.
+ Default value: `false`
+ When the value of `skip-init-stats` is `true`, TiDB skips statistics initialization during startup and does not load statistics afterward. It is useful if you need to start TiDB quickly without waiting for statistics initialization, especially when there are a large number of tables and partitions. However, it is intended for maintenance only. In most cases, do not set this configuration item to `true`; otherwise, the optimizer might generate suboptimal execution plans due to missing statistics.

Check warning on line 648 in tidb-configuration-file.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[PingCAP.Ambiguous] Consider using a clearer word than 'a large number of' because it may cause confusion.

Raw Output:
{"message": "[PingCAP.Ambiguous] Consider using a clearer word than 'a large number of' because it may cause confusion.", "location": {"path": "tidb-configuration-file.md", "range": {"start": {"line": 648, "column": 262}}}, "severity": "INFO"}

### `enable-async-batch-get` <span class="version-mark">New in v8.5.5 and v9.0.0</span>

+ Controls whether TiDB uses asynchronous mode to execute the Batch Get operator. Using asynchronous mode can reduce goroutine overhead and provide better performance. Generally, there is no need to modify this configuration item.
Expand Down
Loading