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

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
+10 −0
Open

tidb: add skip-init-stats config #21766

Changes from 2 commits
Commits
Show all changes
9 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
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
6 changes: 6 additions & 0 deletions tidb-configuration-file.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -633,6 +633,12 @@
+ 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>

+ 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. This configuration item is useful when you want to quickly start TiDB without waiting for statistics initialization, especially when there are a large number of tables and partitions. **However, this is a very special scenario. In most cases, please never set this configuration item to `true`, otherwise the optimizer might generate suboptimal execution plans due to the lack of statistics.**

Check warning on line 640 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": 640, "column": 246}}}, "severity": "INFO"}

## opentracing

Configuration items related to opentracing.
Expand Down
Loading