schema-cache: update doc for schema cache #19263
Open
+3
−1
Conversation
This file contains 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
Signed-off-by: wjhuang2016 <[email protected]>
|
[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.
Needs approval from an approver in each of these files:
Approvers can indicate their approval by writing |
ti-chi-bot
bot
added
missing-translation-status
Frank945946
reviewed
Dec 11, 2024
| @@ -13,11 +13,13 @@ summary: TiDB 对于 schema 信息采用基于 LRU 的缓存机制，在大量 | |||
|
|
|||
| ## 最佳实践 | |||
|
|
|||
| - 在大量数据库和表的场景下（例如 10 万以上的数据库和表数量）或者当数据库和表的数量大到影响系统性能时，建议打开 schema 缓存特性。 | |||
| - 在大量数据库和表的场景下（例如 10 万以上的数据库和表数量）或者当数据库和表的数量大到影响系统性能时，建议打开 schema 缓存特性。以下的最佳实践主要针对该场景。在数据库和表数量较少时，可以忽略这一特性。 | |||
| - 可以通过观测 TiDB 监控中 **Schema load** 下的子面板 **Infoschema v2 Cache Operation** 来查看 schema 缓存的命中率。如果命中率较低，可以调大 [`tidb_schema_cache_size`](/system-variables.md#tidb_schema_cache_size-从-v800-版本开始引入)。 | |||
There was a problem hiding this comment.
Suggested change
| - 可以通过观测 TiDB 监控中 **Schema load** 下的子面板 **Infoschema v2 Cache Operation** 来查看 schema 缓存的命中率。如果命中率较低，可以调大 [`tidb_schema_cache_size`](/system-variables.md#tidb_schema_cache_size-从-v800-版本开始引入)。 | |
| - 可以通过观测 TiDB 监控中 **Schema load** 下的子面板 **Infoschema v2 Cache Operation** 来查看 schema 缓存的命中率。如果命中率较低（一般低于 70% 时对 QPS 和延迟会有明显的影响），如果业务对 QPS 和延迟比较敏感，建议调大 [`tidb_schema_cache_size`](/system-variables.md#tidb_schema_cache_size-从-v800-版本开始引入)，并保持命中率在 85% 以上。 |
| @@ -13,11 +13,13 @@ summary: TiDB 对于 schema 信息采用基于 LRU 的缓存机制，在大量 | |||
|
|
|||
| ## 最佳实践 | |||
|
|
|||
| - 在大量数据库和表的场景下（例如 10 万以上的数据库和表数量）或者当数据库和表的数量大到影响系统性能时，建议打开 schema 缓存特性。 | |||
| - 在大量数据库和表的场景下（例如 10 万以上的数据库和表数量）或者当数据库和表的数量大到影响系统性能时，建议打开 schema 缓存特性。以下的最佳实践主要针对该场景。在数据库和表数量较少时，可以忽略这一特性。 | |||
There was a problem hiding this comment.
Suggested change
| - 在大量数据库和表的场景下（例如 10 万以上的数据库和表数量）或者当数据库和表的数量大到影响系统性能时，建议打开 schema 缓存特性。以下的最佳实践主要针对该场景。在数据库和表数量较少时，可以忽略这一特性。 | |
| - 在大量数据库和表的场景下（例如 10 万以上的数据库和表数量）或者当数据库和表的数量大到影响系统性能时，建议打开 schema 缓存特性。以下的最佳实践主要针对该场景。在数据库和表数量较少时，可以忽略以下设置。 |
| - 可以通过观测 TiDB 监控中 **Schema load** 下的子面板 **Infoschema v2 Cache Operation** 来查看 schema 缓存的命中率。如果命中率较低，可以调大 [`tidb_schema_cache_size`](/system-variables.md#tidb_schema_cache_size-从-v800-版本开始引入)。 | ||
| - 可以通过观测 TiDB 监控中 **Schema load** 下的子面板 **Infoschema v2 Cache Size** 来查看当前使用的 schema 缓存的大小。 | ||
| - 建议关闭 [`performance.force-init-stats`](/tidb-configuration-file.md#force-init-stats-从-v657-和-v710-版本开始引入) 以减少 TiDB 的启动时间。 | ||
| - 如果需要创建大量的表（例如 10 万张以上），建议将参数 [`split-table`](/tidb-configuration-file.md#split-table) 设置为 `false` 以减少 Region 数量，从而降低 TiKV 的内存。 | ||
| - 在使用 stale read 功能时，如果使用的 schema 太老，可能会导致全量加载历史的 schema，对性能有很大影响。可以通过调大 [`tidb_schema_version_cache_limit`](/system-variables.md#tidb_schema_version_cache_limit-从-v740-版本开始引入) 来缓解这一问题。 | ||
| - 在访问涉及数据库和表的系统表时，最好指定数据库和表，避免读取大量的元数据，导致影响性能甚至 TiDB OOM。 |
There was a problem hiding this comment.
Suggested change
| - 在访问涉及数据库和表的系统表时，最好指定数据库和表，避免读取大量的元数据，导致影响性能甚至 TiDB OOM。 | |
| - 在访问 INFORMATION_SCHEMA 中的系统视图时，如果视图包含库名或表名字段，建议在查询条件中明确指定数据库名和表名，以避免读取过多元数据，进而影响查询性能，甚至导致 TiDB 内存溢出（OOM）问题。 |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
First-time contributors' checklist
What is changed, added or deleted? (Required)
Which TiDB version(s) do your changes apply to? (Required)
Tips for choosing the affected version(s):
By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.
For details, see tips for choosing the affected versions (in Chinese).
What is the related PR or file link(s)?
Do your changes match any of the following descriptions?