Skip to content

Update system-variable tidb_schema_cache_size (#22691) #22693

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 3 commits into from
Apr 3, 2026
+1 −0
Merged

Update system-variable tidb_schema_cache_size (#22691) #22693

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
7a7db51
Update system-variables.md
Frank945946 Apr 3, 2026
595ba42
Update system-variables.md
hfxsd Apr 3, 2026
80fe090
Update system-variables.md
hfxsd Apr 3, 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
1 change: 1 addition & 0 deletions system-variables.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5628,6 +5628,7 @@
- Before TiDB v8.4.0, the default value of this variable is `0`.
- Starting from TiDB v8.4.0, the default value is `536870912`. When you upgrade from an earlier version to v8.4.0 or later, the old value set in the earlier version is used.
- This variable controls the size of the schema cache in TiDB. The unit is byte. Setting this variable to `0` means the cache limit feature is disabled. To enable this feature, you need to set a value within the range `[67108864, 9223372036854775807]`. TiDB will use this value as the maximum available memory limit and apply the Least Recently Used (LRU) algorithm to cache the required tables, effectively reducing the memory used by schema information.
- If your cluster contains a large number of partitioned tables, or if you frequently perform DDL operations on partitioned tables (such as `TRUNCATE` or `DROP PARTITION`), it is recommended that you set this variable to `0`.

Check warning on line 5631 in system-variables.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": "system-variables.md", "range": {"start": {"line": 5631, "column": 28}}}, "severity": "INFO"}
### tidb_schema_version_cache_limit <span class="version-mark">New in v7.4.0</span>
Expand Down
Loading