From 2182627c2a165e6738bb6371f95ae71651bdde84 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 29 Apr 2026 09:08:22 +0000 Subject: [PATCH 1/4] Auto-sync: Update Chinese docs from English PR Synced from: https://github.com/pingcap/docs/pull/21873 Target PR: https://github.com/pingcap/docs-cn/pull/21598 AI Provider: azure Co-authored-by: github-actions[bot] --- TOC.md | 1 + sql-statements/sql-statement-overview.md | 259 ++++++++++++------ sql-statements/sql-statement-refresh-stats.md | 94 +++++++ 3 files changed, 272 insertions(+), 82 deletions(-) create mode 100644 sql-statements/sql-statement-refresh-stats.md diff --git a/TOC.md b/TOC.md index d121472adc69..36ff2303acf4 100644 --- a/TOC.md +++ b/TOC.md @@ -739,6 +739,7 @@ - [`PREPARE`](/sql-statements/sql-statement-prepare.md) - [`QUERY WATCH`](/sql-statements/sql-statement-query-watch.md) - [`RECOVER TABLE`](/sql-statements/sql-statement-recover-table.md) + - [`刷新统计信息`](/sql-statements/sql-statement-refresh-stats.md) - [`RENAME USER`](/sql-statements/sql-statement-rename-user.md) - [`RENAME TABLE`](/sql-statements/sql-statement-rename-table.md) - [`REPLACE`](/sql-statements/sql-statement-replace.md) diff --git a/sql-statements/sql-statement-overview.md b/sql-statements/sql-statement-overview.md index 26befe8ebe1d..266186d6f110 100644 --- a/sql-statements/sql-statement-overview.md +++ b/sql-statements/sql-statement-overview.md @@ -9,44 +9,44 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## Schema 管理与数据定义语句 (DDL) -| SQL 语句 | 描述 | -|----------|------| -| [`ALTER DATABASE`](/sql-statements/sql-statement-alter-database.md) | 修改数据库。 | -| [`ALTER SEQUENCE`](/sql-statements/sql-statement-alter-sequence.md) | 修改序列对象。 | -| [`ALTER TABLE ... ADD COLUMN`](/sql-statements/sql-statement-add-column.md) | 在已有表中添加列。 | -| [`ALTER TABLE ... ADD INDEX`](/sql-statements/sql-statement-add-index.md) | 在已有表中添加索引。 | -| [`ALTER TABLE ... ALTER INDEX`](/sql-statements/sql-statement-alter-index.md) | 修改索引定义。 | -| [`ALTER TABLE ... CHANGE COLUMN`](/sql-statements/sql-statement-change-column.md) | 修改列定义。 | -| [`ALTER TABLE ... COMPACT`](/sql-statements/sql-statement-alter-table-compact.md) | 对表进行数据整理。 | -| [`ALTER TABLE ... DROP COLUMN`](/sql-statements/sql-statement-drop-column.md) | 从表中删除列。 | -| [`ALTER TABLE ... MODIFY COLUMN`](/sql-statements/sql-statement-modify-column.md) | 修改列定义。 | -| [`ALTER TABLE ... RENAME INDEX`](/sql-statements/sql-statement-rename-index.md) | 重命名索引。 | -| [`ALTER TABLE`](/sql-statements/sql-statement-alter-table.md) | 修改表定义。 | -| [`CREATE DATABASE`](/sql-statements/sql-statement-create-database.md) | 创建新数据库。 | -| [`CREATE INDEX`](/sql-statements/sql-statement-create-index.md) | 在表上创建新索引。 | -| [`CREATE SEQUENCE`](/sql-statements/sql-statement-create-sequence.md) | 创建新序列对象。 | -| [`CREATE TABLE LIKE`](/sql-statements/sql-statement-create-table-like.md) | 复制已有表的定义，但不复制任何数据。 | -| [`CREATE TABLE`](/sql-statements/sql-statement-create-table.md) | 创建新表。 | -| [`CREATE VIEW`](/sql-statements/sql-statement-create-view.md) | 创建新视图。 | -| [`DROP DATABASE`](/sql-statements/sql-statement-drop-database.md) | 删除已有数据库。 | -| [`DROP INDEX`](/sql-statements/sql-statement-drop-index.md) | 从表中删除索引。 | -| [`DROP SEQUENCE`](/sql-statements/sql-statement-drop-sequence.md) | 删除序列对象。 | -| [`DROP TABLE`](/sql-statements/sql-statement-drop-table.md) | 删除已有表。 | -| [`DROP VIEW`](/sql-statements/sql-statement-drop-view.md) | 删除已有视图。 | -| [`RENAME TABLE`](/sql-statements/sql-statement-rename-table.md) | 重命名表。 | -| [`SHOW COLUMNS FROM`](/sql-statements/sql-statement-show-columns-from.md) | 显示表的列。 | -| [`SHOW CREATE DATABASE`](/sql-statements/sql-statement-show-create-database.md) | 显示数据库的 `CREATE` 语句。 | -| [`SHOW CREATE SEQUENCE`](/sql-statements/sql-statement-show-create-sequence.md) | 显示序列的 `CREATE` 语句。 | -| [`SHOW CREATE TABLE`](/sql-statements/sql-statement-show-create-table.md) | 显示表的 `CREATE` 语句。 | -| [`SHOW DATABASES`](/sql-statements/sql-statement-show-databases.md) | 显示当前用户有权限访问的数据库列表。 | -| [`SHOW FIELDS FROM`](/sql-statements/sql-statement-show-fields-from.md) | 显示表的列。 | -| [`SHOW INDEXES`](/sql-statements/sql-statement-show-indexes.md) | 显示表的索引。 | -| [`SHOW SCHEMAS`](/sql-statements/sql-statement-show-schemas.md) | `SHOW DATABASES` 的别名，显示当前用户有权限访问的数据库列表。 | -| [`SHOW TABLE NEXT_ROW_ID`](/sql-statements/sql-statement-show-table-next-rowid.md) | 显示表中下一个行的 ID。 | -| [`SHOW TABLE REGIONS`](/sql-statements/sql-statement-show-table-regions.md) | 显示 TiDB 中表的 Region 信息。 | -| [`SHOW TABLE STATUS`](/sql-statements/sql-statement-show-table-status.md) | 显示 TiDB 中表的各种统计信息。 | -| [`SHOW TABLES`](/sql-statements/sql-statement-show-tables.md) | 显示数据库中的表。 | -| [`TRUNCATE`](/sql-statements/sql-statement-truncate.md) | 清空表中的所有数据。 | +| SQL 语句 | 描述 | +| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | +| [`ALTER DATABASE`](/sql-statements/sql-statement-alter-database.md) | 修改数据库。 | +| [`ALTER SEQUENCE`](/sql-statements/sql-statement-alter-sequence.md) | 修改序列对象。 | +| [`ALTER TABLE ... ADD COLUMN`](/sql-statements/sql-statement-add-column.md) | 在已有表中添加列。 | +| [`ALTER TABLE ... ADD INDEX`](/sql-statements/sql-statement-add-index.md) | 在已有表中添加索引。 | +| [`ALTER TABLE ... ALTER INDEX`](/sql-statements/sql-statement-alter-index.md) | 修改索引定义。 | +| [`ALTER TABLE ... CHANGE COLUMN`](/sql-statements/sql-statement-change-column.md) | 修改列定义。 | +| [`ALTER TABLE ... COMPACT`](/sql-statements/sql-statement-alter-table-compact.md) | 对表进行数据整理。 | +| [`ALTER TABLE ... DROP COLUMN`](/sql-statements/sql-statement-drop-column.md) | 从表中删除列。 | +| [`ALTER TABLE ... MODIFY COLUMN`](/sql-statements/sql-statement-modify-column.md) | 修改列定义。 | +| [`ALTER TABLE ... RENAME INDEX`](/sql-statements/sql-statement-rename-index.md) | 重命名索引。 | +| [`ALTER TABLE`](/sql-statements/sql-statement-alter-table.md) | 修改表定义。 | +| [`CREATE DATABASE`](/sql-statements/sql-statement-create-database.md) | 创建新数据库。 | +| [`CREATE INDEX`](/sql-statements/sql-statement-create-index.md) | 在表上创建新索引。 | +| [`CREATE SEQUENCE`](/sql-statements/sql-statement-create-sequence.md) | 创建新序列对象。 | +| [`CREATE TABLE LIKE`](/sql-statements/sql-statement-create-table-like.md) | 复制已有表的定义，但不复制任何数据。 | +| [`CREATE TABLE`](/sql-statements/sql-statement-create-table.md) | 创建新表。 | +| [`CREATE VIEW`](/sql-statements/sql-statement-create-view.md) | 创建新视图。 | +| [`DROP DATABASE`](/sql-statements/sql-statement-drop-database.md) | 删除已有数据库。 | +| [`DROP INDEX`](/sql-statements/sql-statement-drop-index.md) | 从表中删除索引。 | +| [`DROP SEQUENCE`](/sql-statements/sql-statement-drop-sequence.md) | 删除序列对象。 | +| [`DROP TABLE`](/sql-statements/sql-statement-drop-table.md) | 删除已有表。 | +| [`DROP VIEW`](/sql-statements/sql-statement-drop-view.md) | 删除已有视图。 | +| [`RENAME TABLE`](/sql-statements/sql-statement-rename-table.md) | 重命名表。 | +| [`SHOW COLUMNS FROM`](/sql-statements/sql-statement-show-columns-from.md) | 显示表的列。 | +| [`SHOW CREATE DATABASE`](/sql-statements/sql-statement-show-create-database.md) | 显示数据库的 `CREATE` 语句。 | +| [`SHOW CREATE SEQUENCE`](/sql-statements/sql-statement-show-create-sequence.md) | 显示序列的 `CREATE` 语句。 | +| [`SHOW CREATE TABLE`](/sql-statements/sql-statement-show-create-table.md) | 显示表的 `CREATE` 语句。 | +| [`SHOW DATABASES`](/sql-statements/sql-statement-show-databases.md) | 显示当前用户有权限访问的数据库列表。 | +| [`SHOW FIELDS FROM`](/sql-statements/sql-statement-show-fields-from.md) | 显示表的列。 | +| [`SHOW INDEXES`](/sql-statements/sql-statement-show-indexes.md) | 显示表的索引。 | +| [`SHOW SCHEMAS`](/sql-statements/sql-statement-show-schemas.md) | `SHOW DATABASES` 的别名，显示当前用户有权限访问的数据库列表。 | +| [`SHOW TABLE NEXT_ROW_ID`](/sql-statements/sql-statement-show-table-next-rowid.md) | 显示表中下一个行的 ID。 | +| [`SHOW TABLE REGIONS`](/sql-statements/sql-statement-show-table-regions.md) | 显示 TiDB 中表的 Region 信息。 | +| [`SHOW TABLE STATUS`](/sql-statements/sql-statement-show-table-status.md) | 显示 TiDB 中表的各种统计信息。 | +| [`SHOW TABLES`](/sql-statements/sql-statement-show-tables.md) | 显示数据库中的表。 | +| [`TRUNCATE`](/sql-statements/sql-statement-truncate.md) | 清空表中的所有数据。 | ## 数据操作语句 (DML) @@ -74,67 +74,94 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## 预处理语句 -| SQL 语句 | 描述 | -|----------|------| +| SQL 语句 | 描述 | +| ------------------------------------------------------ | -------------------------------------------------------- | | [`DEALLOCATE`](/sql-statements/sql-statement-deallocate.md) | 释放预处理语句以释放相关资源。 | -| [`EXECUTE`](/sql-statements/sql-statement-execute.md) | 使用特定参数值执行预处理语句。 | -| [`PREPARE`](/sql-statements/sql-statement-prepare.md) | 创建包含占位符的预处理语句。 | +| [`EXECUTE`](/sql-statements/sql-statement-execute.md) | 使用特定参数值执行预处理语句。 | +| [`PREPARE`](/sql-statements/sql-statement-prepare.md) | 创建包含占位符的预处理语句。 | ## 管理语句 -| SQL 语句 | 描述 | -|----------|------| -| [`ADMIN ALTER DDL JOBS`](/sql-statements/sql-statement-admin-alter-ddl.md) | 修改单个正在运行的 DDL 作业的相关参数。 | -| [`ADMIN CANCEL DDL`](/sql-statements/sql-statement-admin-cancel-ddl.md) | 取消 DDL 作业。 | -| [`ADMIN CHECK [TABLE\|INDEX]`](/sql-statements/sql-statement-admin-check-table-index.md) | 检查表或索引的完整性。 | -| [`ADMIN CHECKSUM TABLE`](/sql-statements/sql-statement-admin-checksum-table.md) | 计算表的校验和。 | -| [`ADMIN CLEANUP INDEX`](/sql-statements/sql-statement-admin-cleanup.md) | 清理表中的索引。 | -| [`ADMIN PAUSE DDL`](/sql-statements/sql-statement-admin-pause-ddl.md) | 暂停 DDL 作业。 | -| [`ADMIN RESUME DDL`](/sql-statements/sql-statement-admin-resume-ddl.md) | 恢复 DDL 作业。 | -| [`ADMIN SHOW DDL [JOBS\|JOB QUERIES]`](/sql-statements/sql-statement-admin-show-ddl.md) | 显示 DDL 作业信息或 DDL 对应的查询语句。 | -| [`ADMIN`](/sql-statements/sql-statement-admin.md) | 执行各种管理任务。 | -| [`FLUSH TABLES`](/sql-statements/sql-statement-flush-tables.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)，在 TiDB 中没有实际用途。 | -| [`SET `](/sql-statements/sql-statement-set-variable.md) | 修改系统变量或用户变量。 | -| [`SET [NAMES\|CHARACTER SET]`](/sql-statements/sql-statement-set-names.md) | 设置字符集和排序规则。 | -| [`SPLIT REGION`](/sql-statements/sql-statement-split-region.md) | 将 Region 切分为更小的 Region。 | + + +| SQL 语句 | 描述 | +| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | +| [`ADMIN ALTER DDL JOBS`](/sql-statements/sql-statement-admin-alter-ddl.md) | 修改单个正在运行的 DDL 作业的相关参数。 | +| [`ADMIN CANCEL DDL`](/sql-statements/sql-statement-admin-cancel-ddl.md) | 取消 DDL 作业。 | +| [`ADMIN CHECK [TABLE\|INDEX]`](/sql-statements/sql-statement-admin-check-table-index.md) | 检查表或索引的完整性。 | +| [`ADMIN CHECKSUM TABLE`](/sql-statements/sql-statement-admin-checksum-table.md) | 计算表的校验和。 | +| [`ADMIN CLEANUP INDEX`](/sql-statements/sql-statement-admin-cleanup.md) | 清理表中的索引。 | +| [`ADMIN PAUSE DDL`](/sql-statements/sql-statement-admin-pause-ddl.md) | 暂停 DDL 作业。 | +| [`ADMIN RESUME DDL`](/sql-statements/sql-statement-admin-resume-ddl.md) | 恢复 DDL 作业。 | +| [`ADMIN SHOW DDL [JOBS\|JOB QUERIES]`](/sql-statements/sql-statement-admin-show-ddl.md) | 显示 DDL 作业信息或 DDL 对应的查询语句。 | +| [`ADMIN`](/sql-statements/sql-statement-admin.md) | 执行各种管理任务。 | +| [`FLUSH TABLES`](/sql-statements/sql-statement-flush-tables.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)，在 TiDB 中没有实际用途。 | +| [`SET `](/sql-statements/sql-statement-set-variable.md) | 修改系统变量或用户变量。 | +| [`SET [NAMES\|CHARACTER SET]`](/sql-statements/sql-statement-set-names.md) | 设置字符集和排序规则。 | +| [`SPLIT REGION`](/sql-statements/sql-statement-split-region.md) | 将 Region 切分为更小的 Region。 | + + + + + +| SQL 语句 | 描述 | +| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | +| [`ADMIN ALTER DDL JOBS`](/sql-statements/sql-statement-admin-alter-ddl.md) | 修改单个正在运行的 DDL 作业的相关参数。 | +| [`ADMIN CANCEL DDL`](/sql-statements/sql-statement-admin-cancel-ddl.md) | 取消 DDL 作业。 | +| [`ADMIN CHECK [TABLE\|INDEX]`](/sql-statements/sql-statement-admin-check-table-index.md) | 检查表或索引的完整性。 | +| [`ADMIN CHECKSUM TABLE`](/sql-statements/sql-statement-admin-checksum-table.md) | 计算表的校验和。 | +| [`ADMIN CLEANUP INDEX`](/sql-statements/sql-statement-admin-cleanup.md) | 清理表中的索引。 | +| [`ADMIN PAUSE DDL`](/sql-statements/sql-statement-admin-pause-ddl.md) | 暂停 DDL 作业。 | +| [`ADMIN RECOVER INDEX`](/sql-statements/sql-statement-admin-recover.md) | 基于冗余索引恢复一致性。 | +| [`ADMIN RESUME DDL`](/sql-statements/sql-statement-admin-resume-ddl.md) | 恢复 DDL 作业。 | +| [`ADMIN SHOW DDL [JOBS\|JOB QUERIES]`](/sql-statements/sql-statement-admin-show-ddl.md) | 显示 DDL 作业信息或 DDL 对应的查询语句。 | +| [`ADMIN`](/sql-statements/sql-statement-admin.md) | 执行各种管理任务。 | +| [`FLUSH TABLES`](/sql-statements/sql-statement-flush-tables.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)，在 TiDB 中没有实际用途。 | +| [`SET `](/sql-statements/sql-statement-set-variable.md) | 修改系统变量或用户变量。 | +| [`SET [NAMES\|CHARACTER SET]`](/sql-statements/sql-statement-set-names.md) | 设置字符集和排序规则。 | +| [`SPLIT REGION`](/sql-statements/sql-statement-split-region.md) | 将 Region 切分为更小的 Region。 | + + ## 数据导入和导出 -| SQL 语句 | 描述 | -|----------|------| -| [`CANCEL IMPORT JOB`](/sql-statements/sql-statement-cancel-import-job.md) | 取消正在进行的导入任务。 | -| [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md) | 通过 TiDB Lightning 的[物理导入模式](/tidb-lightning/tidb-lightning-physical-import-mode.md)将数据导入到表中。 | -| [`LOAD DATA`](/sql-statements/sql-statement-load-data.md) | 从 Amazon S3 或 Google Cloud Storage 加载数据到表中。 | -| [`SHOW IMPORT JOB`](/sql-statements/sql-statement-show-import-job.md) | 显示导入任务的状态。 | +| SQL 语句 | 描述 | +| -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | +| [`CANCEL IMPORT JOB`](/sql-statements/sql-statement-cancel-import-job.md) | 取消正在进行的导入任务。 | +| [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md) | 通过 TiDB Lightning 的[物理导入模式](https://docs.pingcap.com/tidb/stable/tidb-lightning-physical-import-mode)将数据导入到表中。 | +| [`LOAD DATA`](/sql-statements/sql-statement-load-data.md) | 从 Amazon S3 或 Google Cloud Storage 加载数据到表中。 | +| [`SHOW IMPORT JOB`](/sql-statements/sql-statement-show-import-job.md) | 显示导入任务的状态。 | ## 备份和恢复 -| SQL 语句 | 描述 | -|----------|------| -| [`BACKUP`](/sql-statements/sql-statement-backup.md) | 对 TiDB 集群执行分布式备份操作。 | -| [`FLASHBACK CLUSTER`](/sql-statements/sql-statement-flashback-cluster.md) | 将集群恢复到特定的时间点。 | -| [`FLASHBACK DATABASE`](/sql-statements/sql-statement-flashback-database.md) | 恢复被 `DROP` 语句删除的数据库及其数据。 | -| [`FLASHBACK TABLE`](/sql-statements/sql-statement-flashback-table.md) | 恢复被 `DROP` 或 `TRUNCATE` 操作删除的表及其数据。 | -| [`RECOVER TABLE`](/sql-statements/sql-statement-recover-table.md) | 恢复被删除的表及其数据。 | -| [`RESTORE`](/sql-statements/sql-statement-restore.md) | 从备份中恢复数据库。 | -| [`SHOW BACKUPS`](/sql-statements/sql-statement-show-backups.md) | 显示备份任务。 | -| [`SHOW RESTORES`](/sql-statements/sql-statement-show-backups.md) | 显示恢复任务。 | +| SQL 语句 | 描述 | +| ---------------------------------------------------------------------- | -------------------------------------------------------------------- | +| [`BACKUP`](/sql-statements/sql-statement-backup.md) | 对 TiDB 集群执行分布式备份操作。 | +| [`FLASHBACK CLUSTER`](/sql-statements/sql-statement-flashback-cluster.md) | 将集群恢复到特定的时间点。 | +| [`FLASHBACK DATABASE`](/sql-statements/sql-statement-flashback-database.md) | 恢复被 `DROP` 语句删除的数据库及其数据。 | +| [`FLASHBACK TABLE`](/sql-statements/sql-statement-flashback-table.md) | 恢复被 `DROP` 或 `TRUNCATE` 操作删除的表及其数据。 | +| [`RECOVER TABLE`](/sql-statements/sql-statement-recover-table.md) | 恢复被删除的表及其数据。 | +| [`RESTORE`](/sql-statements/sql-statement-restore.md) | 从备份中恢复数据库。 | +| [`SHOW BACKUPS`](/sql-statements/sql-statement-show-backups.md) | 显示备份任务。 | +| [`SHOW RESTORES`](/sql-statements/sql-statement-show-backups.md) | 显示恢复任务。 | ## 放置策略 -| SQL 语句 | 描述 | -|----------|------| -| [`ALTER PLACEMENT POLICY`](/sql-statements/sql-statement-alter-placement-policy.md) | 修改放置策略。 | -| [`ALTER RANGE`](/sql-statements/sql-statement-alter-range.md) | 修改放置策略的范围。 | -| [`CREATE PLACEMENT POLICY`](/sql-statements/sql-statement-create-placement-policy.md) | 创建新的放置策略。 | -| [`DROP PLACEMENT POLICY`](/sql-statements/sql-statement-drop-placement-policy.md) | 删除现有放置策略。 | +| SQL 语句 | 描述 | +| ------------------------------------------------------------------------------------------ | --------------------------------------------- | +| [`ALTER PLACEMENT POLICY`](/sql-statements/sql-statement-alter-placement-policy.md) | 修改放置策略。 | +| [`ALTER RANGE`](/sql-statements/sql-statement-alter-range.md) | 修改放置策略的范围。 | +| [`CREATE PLACEMENT POLICY`](/sql-statements/sql-statement-create-placement-policy.md) | 创建新的放置策略。 | +| [`DROP PLACEMENT POLICY`](/sql-statements/sql-statement-drop-placement-policy.md) | 删除现有放置策略。 | | [`SHOW CREATE PLACEMENT POLICY`](/sql-statements/sql-statement-show-create-placement-policy.md) | 显示放置策略的 `CREATE` 语句。 | -| [`SHOW PLACEMENT FOR`](/sql-statements/sql-statement-show-placement-for.md) | 显示指定表的放置策略。 | -| [`SHOW PLACEMENT LABELS`](/sql-statements/sql-statement-show-placement-labels.md) | 显示可用的放置标签。 | -| [`SHOW PLACEMENT`](/sql-statements/sql-statement-show-placement.md) | 显示放置规则。 | +| [`SHOW PLACEMENT FOR`](/sql-statements/sql-statement-show-placement-for.md) | 显示指定表的放置策略。 | +| [`SHOW PLACEMENT LABELS`](/sql-statements/sql-statement-show-placement-labels.md) | 显示可用的放置标签。 | +| [`SHOW PLACEMENT`](/sql-statements/sql-statement-show-placement.md) | 显示放置规则。 | ## 资源组 + + | SQL 语句 | 描述 | |----------|------| | [`ALTER RESOURCE GROUP`](/sql-statements/sql-statement-alter-resource-group.md) | 修改资源组。 | @@ -145,6 +172,21 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`SET RESOURCE GROUP`](/sql-statements/sql-statement-set-resource-group.md) | 设置资源组。 | | [`SHOW CREATE RESOURCE GROUP`](/sql-statements/sql-statement-show-create-resource-group.md) | 显示资源组的 `CREATE` 语句。 | + + + + +| SQL 语句 | 描述 | +|----------|------| +| [`ALTER RESOURCE GROUP`](/sql-statements/sql-statement-alter-resource-group.md) | 修改资源组。 | +| [`CREATE RESOURCE GROUP`](/sql-statements/sql-statement-create-resource-group.md) | 创建新的资源组。 | +| [`DROP RESOURCE GROUP`](/sql-statements/sql-statement-drop-resource-group.md) | 删除资源组。 | +| [`QUERY WATCH`](/sql-statements/sql-statement-query-watch.md) | 管理 Runaway Queries 监控列表。 | +| [`SET RESOURCE GROUP`](/sql-statements/sql-statement-set-resource-group.md) | 设置资源组。 | +| [`SHOW CREATE RESOURCE GROUP`](/sql-statements/sql-statement-show-create-resource-group.md) | 显示资源组的 `CREATE` 语句。 | + + + ## 效用语句 | SQL 语句 | 描述 | @@ -158,6 +200,8 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## 显示语句 + + | SQL 语句 | 描述 | |----------|------| | [`SHOW BUILTINS`](/sql-statements/sql-statement-show-builtins.md) | 列出内置函数。 | @@ -168,8 +212,26 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`SHOW VARIABLES`](/sql-statements/sql-statement-show-variables.md) | 显示系统变量。 | | [`SHOW WARNINGS`](/sql-statements/sql-statement-show-warnings.md) | 显示先前已执行语句中的警告和注意。 | + + + + +| SQL 语句 | 描述 | +|----------|------| +| [`SHOW BUILTINS`](/sql-statements/sql-statement-show-builtins.md) | 列出内置函数。 | +| [`SHOW CHARACTER SET`](/sql-statements/sql-statement-show-character-set.md) | 列出字符集。 | +| [`SHOW COLLATIONS`](/sql-statements/sql-statement-show-collation.md) | 列出排序规则。 | +| [`SHOW ERRORS`](/sql-statements/sql-statement-show-errors.md) | 显示先前已执行语句中的错误。 | +| [`SHOW STATUS`](/sql-statements/sql-statement-show-status.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)。TiDB Cloud 提供 [Monitoring](https://docs.pingcap.com/tidbcloud/monitor-tidb-cluster) 来集中收集大多数指标，而不是使用 `SHOW STATUS`。 | +| [`SHOW VARIABLES`](/sql-statements/sql-statement-show-variables.md) | 显示系统变量。 | +| [`SHOW WARNINGS`](/sql-statements/sql-statement-show-warnings.md) | 显示先前已执行语句中的警告和注意。 | + + + ## 实例管理 + + | SQL 语句 | 描述 | |----------|------| | [`ALTER INSTANCE`](/sql-statements/sql-statement-alter-instance.md) | 修改实例。 | @@ -182,6 +244,22 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`SHOW PROFILES`](/sql-statements/sql-statement-show-profiles.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)，目前返回结果为空。 | | [`SHUTDOWN`](/sql-statements/sql-statement-shutdown.md) | 停止客户端连接的 TiDB 实例，而不是整个 TiDB 集群。 | + + + + +| SQL 语句 | 描述 | +|----------|------| +| [`ALTER INSTANCE`](/sql-statements/sql-statement-alter-instance.md) | 修改实例。 | +| [`FLUSH STATUS`](/sql-statements/sql-statement-flush-status.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)。TiDB Cloud 提供 [Monitoring](https://docs.pingcap.com/tidbcloud/monitor-tidb-cluster) 来集中收集大多数指标，而不是使用 `SHOW STATUS`。 | +| [`KILL`](/sql-statements/sql-statement-kill.md) | 终止当前 TiDB 集群中任意一个 TiDB 实例的连接。 | +| [`SHOW ENGINES`](/sql-statements/sql-statement-show-engines.md) | 显示可用的存储引擎。 | +| [`SHOW PLUGINS`](/sql-statements/sql-statement-show-plugins.md) | 显示已安装的插件。 | +| [`SHOW PROCESSLIST`](/sql-statements/sql-statement-show-processlist.md) | 显示连接到相同 TiDB 服务器的当前会话。 | +| [`SHOW PROFILES`](/sql-statements/sql-statement-show-profiles.md) | 显示查询性能分析信息。用于提供 [MySQL 兼容性](/mysql-compatibility.md)。目前仅返回空结果。 | + + + ## 锁定语句 | SQL 语句 | 描述 | @@ -215,11 +293,27 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## TiCDC + + | SQL 语句 | 描述 | |----------|------| | [`ADMIN [SET\|SHOW\|UNSET] BDR ROLE`](/sql-statements/sql-statement-admin-bdr-role.md) | 管理 BDR 角色。 | | [`SHOW MASTER STATUS`](/sql-statements/sql-statement-show-master-status.md) | 显示集群中当前最新的 TSO。 | + + + + +> **注意：** +> +> [TiCDC](https://docs.pingcap.com/tidb/stable/ticdc-overview) 和 [TiDB Binlog](https://docs-archive.pingcap.com/tidb/v8.3/tidb-binlog-overview) 是用于将 TiDB Self-Managed 的数据复制到上游的工具。大多数用于 TiCDC 和 TiDB Binlog 的 SQL 语句不适用于 TiDB Cloud。对于 TiDB Cloud，你可以改用 [TiDB Cloud console](https://tidbcloud.com) 中的 [Changefeed](https://docs.pingcap.com/tidbcloud/changefeed-overview) 功能来流式传输数据。 + +| SQL 语句 | 描述 | +|----------|------| +| [`SHOW MASTER STATUS`](/sql-statements/sql-statement-show-master-status.md) | 显示集群中当前最新的 TSO。 | + + + ## 统计信息和执行计划管理 | SQL 语句 | 描述 | @@ -230,6 +324,7 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`DROP STATS`](/sql-statements/sql-statement-drop-stats.md) | 删除表的统计信息。 | | [`EXPLAIN ANALYZE`](/sql-statements/sql-statement-explain-analyze.md) | 工作方式类似于 `EXPLAIN`，但主要区别在于 `EXPLAIN ANALYZE` 会执行语句。 | | [`LOAD STATS`](/sql-statements/sql-statement-load-stats.md) | 将统计信息加载到 TiDB 中。 | +| [`REFRESH STATS`](/sql-statements/sql-statement-refresh-stats.md) | 将持久化的统计信息重新加载到内存中，适用于特定表或整个集群。 | | [`SHOW ANALYZE STATUS`](/sql-statements/sql-statement-show-analyze-status.md) | 显示统计信息收集任务。 | | [`SHOW BINDINGS`](/sql-statements/sql-statement-show-bindings.md) | 显示已创建的 SQL 绑定。 | | [`SHOW COLUMN_STATS_USAGE`](/sql-statements/sql-statement-show-column-stats-usage.md) | 显示列统计信息的最近一次使用时间和收集时间。 | diff --git a/sql-statements/sql-statement-refresh-stats.md b/sql-statements/sql-statement-refresh-stats.md new file mode 100644 index 000000000000..56e9d5e530af --- /dev/null +++ b/sql-statements/sql-statement-refresh-stats.md @@ -0,0 +1,94 @@ +--- +title: REFRESH STATS +summary: 了解如何为特定表或整个 TiDB 集群将统计信息重新加载到内存中。 +--- + +# REFRESH STATS + +`REFRESH STATS` 将持久化的优化器统计信息从 TiDB 系统表重新加载到内存中。该语句主要用于统计信息已通过外部方式恢复的场景（例如，通过 [BR](/br/br-use-overview.md)），或者当你需要在不重新运行 `ANALYZE` 的情况下协调内存中的统计信息时。 + +当你运行 `REFRESH STATS` 时，TiDB 会复用在启动时自动触发的统计信息初始化例程。你可以为单个表、所选数据库中的所有表或整个集群重新加载统计信息，并可选择执行轻量级（`LITE`）或完整（`FULL`）初始化。 + +> **Warning:** +> +> 该语句是为 BR 的内部恢复工作流设计的，BR 会在需要时自动运行它。 +> +> - 除非你正在调试内存中的统计信息，否则**不要**手动执行该语句，并且绝不要将其作为例行操作的一部分在生产集群上运行。 +> - **不要**在相同的表上并发执行该语句，因为这可能导致不可预期的行为。 + +## Synopsis + +```ebnf+diagram +RefreshStatsStmt ::= + 'REFRESH' 'STATS' RefreshTargetList RefreshMode? ClusterOption? + +RefreshTargetList ::= + RefreshTarget (',' RefreshTarget)* + +RefreshTarget ::= + TableName + | SchemaWildcard + | GlobalWildcard + +TableName ::= + Identifier ('.' Identifier)? + +SchemaWildcard ::= + Identifier '.' '*' + +GlobalWildcard ::= + '*' '.' '*' + +RefreshMode ::= + 'FULL' + | 'LITE' + +ClusterOption ::= + 'CLUSTER' +``` + +## Options + +- **Targets (`RefreshTargetList`)**： + - `table_name` 刷新当前数据库中的一个表。 + - `db_name.table_name` 刷新一个带完整限定名的表。 + - `db_name.*` 刷新指定数据库中的所有表。 + - `*.*` 刷新集群中的所有表。 +- **`FULL`**：将完整统计信息（例如直方图、TopN 和 CMSketch）加载到内存中，等同于在本次操作中将 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 设置为 `false`。当你需要立即获得完整统计信息时，请使用此选项。 +- **`LITE`**：执行轻量级初始化，等同于 `lite-init-stats = true`，这会跳过加载直方图和其他较重的结构体，直到实际需要时再加载。 +- **`CLUSTER`**：将刷新请求广播到每个 TiDB server。不带此选项时，只有接收该语句的 TiDB 节点会重新加载其内存中的统计信息。 +- **Default mode**：如果既未指定 `FULL` 也未指定 `LITE`，TiDB 将使用当前的 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 值。 + +## Examples + +- 在已连接的 TiDB 节点上刷新单个表的统计信息： + + ```sql + REFRESH STATS orders; + ``` + +- 以轻量级初始化方式刷新 `sales` 中的所有表： + + ```sql + REFRESH STATS sales.* LITE; + ``` + +- 强制每个 TiDB 节点为整个集群加载完整统计信息： + + ```sql + REFRESH STATS *.* FULL CLUSTER; + ``` + +## Privileges + +要执行 `REFRESH STATS`，你必须拥有 `RESTORE_ADMIN` 权限，或者拥有每个目标表上的 `SELECT` 权限。如果你的权限不足，TiDB 会返回错误并退出该语句的执行。 + +## MySQL compatibility + +`REFRESH STATS` 是 TiDB 特有的扩展，不属于 MySQL 的一部分。 + +## See also + +- [Statistics](/statistics.md) +- [`ANALYZE TABLE`](/sql-statements/sql-statement-analyze-table.md) +- [`LOCK STATS`](/sql-statements/sql-statement-lock-stats.md) \ No newline at end of file From 637ca9bd81ae51a8fe7889b4868f30b281f913f3 Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 6 May 2026 16:51:05 +0800 Subject: [PATCH 2/4] Update sql-statement-overview.md --- sql-statements/sql-statement-overview.md | 94 ------------------------ 1 file changed, 94 deletions(-) diff --git a/sql-statements/sql-statement-overview.md b/sql-statements/sql-statement-overview.md index 266186d6f110..49a62e7161ad 100644 --- a/sql-statements/sql-statement-overview.md +++ b/sql-statements/sql-statement-overview.md @@ -82,28 +82,6 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## 管理语句 - - -| SQL 语句 | 描述 | -| ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | -| [`ADMIN ALTER DDL JOBS`](/sql-statements/sql-statement-admin-alter-ddl.md) | 修改单个正在运行的 DDL 作业的相关参数。 | -| [`ADMIN CANCEL DDL`](/sql-statements/sql-statement-admin-cancel-ddl.md) | 取消 DDL 作业。 | -| [`ADMIN CHECK [TABLE\|INDEX]`](/sql-statements/sql-statement-admin-check-table-index.md) | 检查表或索引的完整性。 | -| [`ADMIN CHECKSUM TABLE`](/sql-statements/sql-statement-admin-checksum-table.md) | 计算表的校验和。 | -| [`ADMIN CLEANUP INDEX`](/sql-statements/sql-statement-admin-cleanup.md) | 清理表中的索引。 | -| [`ADMIN PAUSE DDL`](/sql-statements/sql-statement-admin-pause-ddl.md) | 暂停 DDL 作业。 | -| [`ADMIN RESUME DDL`](/sql-statements/sql-statement-admin-resume-ddl.md) | 恢复 DDL 作业。 | -| [`ADMIN SHOW DDL [JOBS\|JOB QUERIES]`](/sql-statements/sql-statement-admin-show-ddl.md) | 显示 DDL 作业信息或 DDL 对应的查询语句。 | -| [`ADMIN`](/sql-statements/sql-statement-admin.md) | 执行各种管理任务。 | -| [`FLUSH TABLES`](/sql-statements/sql-statement-flush-tables.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)，在 TiDB 中没有实际用途。 | -| [`SET `](/sql-statements/sql-statement-set-variable.md) | 修改系统变量或用户变量。 | -| [`SET [NAMES\|CHARACTER SET]`](/sql-statements/sql-statement-set-names.md) | 设置字符集和排序规则。 | -| [`SPLIT REGION`](/sql-statements/sql-statement-split-region.md) | 将 Region 切分为更小的 Region。 | - - - - - | SQL 语句 | 描述 | | ----------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | [`ADMIN ALTER DDL JOBS`](/sql-statements/sql-statement-admin-alter-ddl.md) | 修改单个正在运行的 DDL 作业的相关参数。 | @@ -112,7 +90,6 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`ADMIN CHECKSUM TABLE`](/sql-statements/sql-statement-admin-checksum-table.md) | 计算表的校验和。 | | [`ADMIN CLEANUP INDEX`](/sql-statements/sql-statement-admin-cleanup.md) | 清理表中的索引。 | | [`ADMIN PAUSE DDL`](/sql-statements/sql-statement-admin-pause-ddl.md) | 暂停 DDL 作业。 | -| [`ADMIN RECOVER INDEX`](/sql-statements/sql-statement-admin-recover.md) | 基于冗余索引恢复一致性。 | | [`ADMIN RESUME DDL`](/sql-statements/sql-statement-admin-resume-ddl.md) | 恢复 DDL 作业。 | | [`ADMIN SHOW DDL [JOBS\|JOB QUERIES]`](/sql-statements/sql-statement-admin-show-ddl.md) | 显示 DDL 作业信息或 DDL 对应的查询语句。 | | [`ADMIN`](/sql-statements/sql-statement-admin.md) | 执行各种管理任务。 | @@ -121,8 +98,6 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`SET [NAMES\|CHARACTER SET]`](/sql-statements/sql-statement-set-names.md) | 设置字符集和排序规则。 | | [`SPLIT REGION`](/sql-statements/sql-statement-split-region.md) | 将 Region 切分为更小的 Region。 | - - ## 数据导入和导出 | SQL 语句 | 描述 | @@ -160,8 +135,6 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## 资源组 - - | SQL 语句 | 描述 | |----------|------| | [`ALTER RESOURCE GROUP`](/sql-statements/sql-statement-alter-resource-group.md) | 修改资源组。 | @@ -172,21 +145,6 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`SET RESOURCE GROUP`](/sql-statements/sql-statement-set-resource-group.md) | 设置资源组。 | | [`SHOW CREATE RESOURCE GROUP`](/sql-statements/sql-statement-show-create-resource-group.md) | 显示资源组的 `CREATE` 语句。 | - - - - -| SQL 语句 | 描述 | -|----------|------| -| [`ALTER RESOURCE GROUP`](/sql-statements/sql-statement-alter-resource-group.md) | 修改资源组。 | -| [`CREATE RESOURCE GROUP`](/sql-statements/sql-statement-create-resource-group.md) | 创建新的资源组。 | -| [`DROP RESOURCE GROUP`](/sql-statements/sql-statement-drop-resource-group.md) | 删除资源组。 | -| [`QUERY WATCH`](/sql-statements/sql-statement-query-watch.md) | 管理 Runaway Queries 监控列表。 | -| [`SET RESOURCE GROUP`](/sql-statements/sql-statement-set-resource-group.md) | 设置资源组。 | -| [`SHOW CREATE RESOURCE GROUP`](/sql-statements/sql-statement-show-create-resource-group.md) | 显示资源组的 `CREATE` 语句。 | - - - ## 效用语句 | SQL 语句 | 描述 | @@ -200,8 +158,6 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## 显示语句 - - | SQL 语句 | 描述 | |----------|------| | [`SHOW BUILTINS`](/sql-statements/sql-statement-show-builtins.md) | 列出内置函数。 | @@ -212,26 +168,8 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`SHOW VARIABLES`](/sql-statements/sql-statement-show-variables.md) | 显示系统变量。 | | [`SHOW WARNINGS`](/sql-statements/sql-statement-show-warnings.md) | 显示先前已执行语句中的警告和注意。 | - - - - -| SQL 语句 | 描述 | -|----------|------| -| [`SHOW BUILTINS`](/sql-statements/sql-statement-show-builtins.md) | 列出内置函数。 | -| [`SHOW CHARACTER SET`](/sql-statements/sql-statement-show-character-set.md) | 列出字符集。 | -| [`SHOW COLLATIONS`](/sql-statements/sql-statement-show-collation.md) | 列出排序规则。 | -| [`SHOW ERRORS`](/sql-statements/sql-statement-show-errors.md) | 显示先前已执行语句中的错误。 | -| [`SHOW STATUS`](/sql-statements/sql-statement-show-status.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)。TiDB Cloud 提供 [Monitoring](https://docs.pingcap.com/tidbcloud/monitor-tidb-cluster) 来集中收集大多数指标，而不是使用 `SHOW STATUS`。 | -| [`SHOW VARIABLES`](/sql-statements/sql-statement-show-variables.md) | 显示系统变量。 | -| [`SHOW WARNINGS`](/sql-statements/sql-statement-show-warnings.md) | 显示先前已执行语句中的警告和注意。 | - - - ## 实例管理 - - | SQL 语句 | 描述 | |----------|------| | [`ALTER INSTANCE`](/sql-statements/sql-statement-alter-instance.md) | 修改实例。 | @@ -244,22 +182,6 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | [`SHOW PROFILES`](/sql-statements/sql-statement-show-profiles.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)，目前返回结果为空。 | | [`SHUTDOWN`](/sql-statements/sql-statement-shutdown.md) | 停止客户端连接的 TiDB 实例，而不是整个 TiDB 集群。 | - - - - -| SQL 语句 | 描述 | -|----------|------| -| [`ALTER INSTANCE`](/sql-statements/sql-statement-alter-instance.md) | 修改实例。 | -| [`FLUSH STATUS`](/sql-statements/sql-statement-flush-status.md) | 用于提供 [MySQL 兼容性](/mysql-compatibility.md)。TiDB Cloud 提供 [Monitoring](https://docs.pingcap.com/tidbcloud/monitor-tidb-cluster) 来集中收集大多数指标，而不是使用 `SHOW STATUS`。 | -| [`KILL`](/sql-statements/sql-statement-kill.md) | 终止当前 TiDB 集群中任意一个 TiDB 实例的连接。 | -| [`SHOW ENGINES`](/sql-statements/sql-statement-show-engines.md) | 显示可用的存储引擎。 | -| [`SHOW PLUGINS`](/sql-statements/sql-statement-show-plugins.md) | 显示已安装的插件。 | -| [`SHOW PROCESSLIST`](/sql-statements/sql-statement-show-processlist.md) | 显示连接到相同 TiDB 服务器的当前会话。 | -| [`SHOW PROFILES`](/sql-statements/sql-statement-show-profiles.md) | 显示查询性能分析信息。用于提供 [MySQL 兼容性](/mysql-compatibility.md)。目前仅返回空结果。 | - - - ## 锁定语句 | SQL 语句 | 描述 | @@ -293,27 +215,11 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My ## TiCDC - - | SQL 语句 | 描述 | |----------|------| | [`ADMIN [SET\|SHOW\|UNSET] BDR ROLE`](/sql-statements/sql-statement-admin-bdr-role.md) | 管理 BDR 角色。 | | [`SHOW MASTER STATUS`](/sql-statements/sql-statement-show-master-status.md) | 显示集群中当前最新的 TSO。 | - - - - -> **注意：** -> -> [TiCDC](https://docs.pingcap.com/tidb/stable/ticdc-overview) 和 [TiDB Binlog](https://docs-archive.pingcap.com/tidb/v8.3/tidb-binlog-overview) 是用于将 TiDB Self-Managed 的数据复制到上游的工具。大多数用于 TiCDC 和 TiDB Binlog 的 SQL 语句不适用于 TiDB Cloud。对于 TiDB Cloud，你可以改用 [TiDB Cloud console](https://tidbcloud.com) 中的 [Changefeed](https://docs.pingcap.com/tidbcloud/changefeed-overview) 功能来流式传输数据。 - -| SQL 语句 | 描述 | -|----------|------| -| [`SHOW MASTER STATUS`](/sql-statements/sql-statement-show-master-status.md) | 显示集群中当前最新的 TSO。 | - - - ## 统计信息和执行计划管理 | SQL 语句 | 描述 | From 0ef5df606a15c461f9e520cd9b3d8b05a8612020 Mon Sep 17 00:00:00 2001 From: qiancai Date: Wed, 6 May 2026 17:21:57 +0800 Subject: [PATCH 3/4] revise translation --- sql-statements/sql-statement-overview.md | 2 +- sql-statements/sql-statement-refresh-stats.md | 58 +++++++++---------- 2 files changed, 30 insertions(+), 30 deletions(-) diff --git a/sql-statements/sql-statement-overview.md b/sql-statements/sql-statement-overview.md index 49a62e7161ad..a252ae4e1701 100644 --- a/sql-statements/sql-statement-overview.md +++ b/sql-statements/sql-statement-overview.md @@ -103,7 +103,7 @@ TiDB 使用的 SQL 语句旨在遵循 ISO/IEC SQL 标准，并在必要时对 My | SQL 语句 | 描述 | | -------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- | | [`CANCEL IMPORT JOB`](/sql-statements/sql-statement-cancel-import-job.md) | 取消正在进行的导入任务。 | -| [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md) | 通过 TiDB Lightning 的[物理导入模式](https://docs.pingcap.com/tidb/stable/tidb-lightning-physical-import-mode)将数据导入到表中。 | +| [`IMPORT INTO`](/sql-statements/sql-statement-import-into.md) | 通过 TiDB Lightning 的[物理导入模式](/tidb-lightning/tidb-lightning-physical-import-mode.md)将数据导入到表中。 | | [`LOAD DATA`](/sql-statements/sql-statement-load-data.md) | 从 Amazon S3 或 Google Cloud Storage 加载数据到表中。 | | [`SHOW IMPORT JOB`](/sql-statements/sql-statement-show-import-job.md) | 显示导入任务的状态。 | diff --git a/sql-statements/sql-statement-refresh-stats.md b/sql-statements/sql-statement-refresh-stats.md index 56e9d5e530af..49e7ffd508aa 100644 --- a/sql-statements/sql-statement-refresh-stats.md +++ b/sql-statements/sql-statement-refresh-stats.md @@ -1,22 +1,22 @@ --- title: REFRESH STATS -summary: 了解如何为特定表或整个 TiDB 集群将统计信息重新加载到内存中。 +summary: 了解如何将指定表或整个 TiDB 集群的统计信息重新加载到内存中。 --- # REFRESH STATS -`REFRESH STATS` 将持久化的优化器统计信息从 TiDB 系统表重新加载到内存中。该语句主要用于统计信息已通过外部方式恢复的场景（例如，通过 [BR](/br/br-use-overview.md)），或者当你需要在不重新运行 `ANALYZE` 的情况下协调内存中的统计信息时。 +`REFRESH STATS` 用于将 TiDB 系统表中持久化的优化器统计信息重新加载到内存中。该语句主要适用于以下场景：统计信息已通过外部方式恢复（例如通过 [BR](/br/br-use-overview.md) 恢复），或者需要在不重新执行 `ANALYZE` 的情况下同步内存中的统计信息。 -当你运行 `REFRESH STATS` 时，TiDB 会复用在启动时自动触发的统计信息初始化例程。你可以为单个表、所选数据库中的所有表或整个集群重新加载统计信息，并可选择执行轻量级（`LITE`）或完整（`FULL`）初始化。 +当你执行 `REFRESH STATS` 时，TiDB 会复用启动时自动触发的统计信息初始化流程。你可以重新加载单个表、指定数据库中的所有表，或者整个集群的统计信息，并可以选择执行轻量级（`LITE`）初始化或完整（`FULL`）初始化。 -> **Warning:** +> **警告：** > -> 该语句是为 BR 的内部恢复工作流设计的，BR 会在需要时自动运行它。 -> -> - 除非你正在调试内存中的统计信息，否则**不要**手动执行该语句，并且绝不要将其作为例行操作的一部分在生产集群上运行。 -> - **不要**在相同的表上并发执行该语句，因为这可能导致不可预期的行为。 +> 该语句是为 BR 的内部恢复流程设计的，BR 会在需要时自动执行它。 +> +> - 除非你正在排查内存中的统计信息问题，否则**不要**手动执行该语句；同时，请不要在生产集群中将该语句作为常规操作执行。 +> - **不要**对同一张表并发执行该语句，否则可能导致非预期行为。 -## Synopsis +## 语法图 ```ebnf+diagram RefreshStatsStmt ::= @@ -47,48 +47,48 @@ ClusterOption ::= 'CLUSTER' ``` -## Options +## 选项 -- **Targets (`RefreshTargetList`)**： - - `table_name` 刷新当前数据库中的一个表。 - - `db_name.table_name` 刷新一个带完整限定名的表。 - - `db_name.*` 刷新指定数据库中的所有表。 - - `*.*` 刷新集群中的所有表。 -- **`FULL`**：将完整统计信息（例如直方图、TopN 和 CMSketch）加载到内存中，等同于在本次操作中将 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 设置为 `false`。当你需要立即获得完整统计信息时，请使用此选项。 -- **`LITE`**：执行轻量级初始化，等同于 `lite-init-stats = true`，这会跳过加载直方图和其他较重的结构体，直到实际需要时再加载。 -- **`CLUSTER`**：将刷新请求广播到每个 TiDB server。不带此选项时，只有接收该语句的 TiDB 节点会重新加载其内存中的统计信息。 -- **Default mode**：如果既未指定 `FULL` 也未指定 `LITE`，TiDB 将使用当前的 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 值。 +- **Targets（`RefreshTargetList`）**： + - `table_name`：刷新当前数据库中的指定表。 + - `db_name.table_name`：刷新指定数据库中的指定表。。 + - `db_name.*`：刷新指定数据库中的所有表。 + - `*.*`：刷新集群中的所有表。 +- **`FULL`**：将完整的统计信息（例如直方图、TopN 和 CMSketch）加载到内存中，等同于针对本次操作将 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 设置为 `false`。当你需要立即获得完整统计信息时，可使用该选项。 +- **`LITE`**：执行轻量级初始化，等同于设置 `lite-init-stats = true`。该模式会跳过直方图和其他较重的数据结构的加载，直到真正需要时才进行加载。 +- **`CLUSTER`**：将刷新请求发送到所有 TiDB 服务器。如果不指定该选项，则只有接收到该语句的 TiDB 节点会重新加载其内存中的统计信息。 +- **默认模式**：如果既未指定 `FULL`，也未指定 `LITE`，TiDB 会使用 [`lite-init-stats`](/tidb-configuration-file.md#lite-init-stats-new-in-v710) 的当前值。 -## Examples +## 示例 -- 在已连接的 TiDB 节点上刷新单个表的统计信息： +- 刷新当前连接的 TiDB 节点上单个表的统计信息： ```sql REFRESH STATS orders; ``` -- 以轻量级初始化方式刷新 `sales` 中的所有表： +- 以轻量级初始化刷新 `sales` 中的所有表： ```sql REFRESH STATS sales.* LITE; ``` -- 强制每个 TiDB 节点为整个集群加载完整统计信息： +- 强制所有 TiDB 节点加载整个集群的完整统计信息： ```sql REFRESH STATS *.* FULL CLUSTER; ``` -## Privileges +## 权限 -要执行 `REFRESH STATS`，你必须拥有 `RESTORE_ADMIN` 权限，或者拥有每个目标表上的 `SELECT` 权限。如果你的权限不足，TiDB 会返回错误并退出该语句的执行。 +要执行 `REFRESH STATS`，你必须拥有 `RESTORE_ADMIN` 权限，或者拥有每个目标表上的 `SELECT` 权限。如果你的权限不足，TiDB 会返回错误并中止该语句的执行。 -## MySQL compatibility +## MySQL 兼容性 -`REFRESH STATS` 是 TiDB 特有的扩展，不属于 MySQL 的一部分。 +`REFRESH STATS` 是 TiDB 特有的扩展，不属于 MySQL。 -## See also +## 另请参阅 -- [Statistics](/statistics.md) +- [统计信息](/statistics.md) - [`ANALYZE TABLE`](/sql-statements/sql-statement-analyze-table.md) - [`LOCK STATS`](/sql-statements/sql-statement-lock-stats.md) \ No newline at end of file From 9a21954ec52593b2af53f31350ab59a586c4d76d Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Thu, 7 May 2026 09:20:16 +0800 Subject: [PATCH 4/4] Update sql-statements/sql-statement-refresh-stats.md --- sql-statements/sql-statement-refresh-stats.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sql-statements/sql-statement-refresh-stats.md b/sql-statements/sql-statement-refresh-stats.md index 49e7ffd508aa..00418ec907e4 100644 --- a/sql-statements/sql-statement-refresh-stats.md +++ b/sql-statements/sql-statement-refresh-stats.md @@ -13,8 +13,8 @@ summary: 了解如何将指定表或整个 TiDB 集群的统计信息重新加 > > 该语句是为 BR 的内部恢复流程设计的，BR 会在需要时自动执行它。 > -> - 除非你正在排查内存中的统计信息问题，否则**不要**手动执行该语句；同时，请不要在生产集群中将该语句作为常规操作执行。 -> - **不要**对同一张表并发执行该语句，否则可能导致非预期行为。 +> - 除非你正在排查内存中的统计信息问题，否则**请勿**手动执行该语句；同时，请不要在生产集群中将该语句作为常规操作执行。 +> - **请勿**对同一张表并发执行该语句，否则可能导致非预期行为。 ## 语法图