大网数据广告活动
数据库部署与 SQL 参考

TiDB 中文参考:SHOW AFFINITY

· 52CE 我爱测

# SHOW AFFINITY 从 v8.5.5 和 v9.0.0 版本开始引入 语句用于查看配置了 选项的表的亲和性调度信息,以及 PD 当前记录的目标副本分布。 ## 语法图 支持使用 或 子句过滤表名。 ## 示例 以下示例创建两个启用了亲和性调度的表,并查看其调度信息: 输出结果示例如下: 各列含义如下: - 、 :PD 为该表或分区记录的目标 Leader 副本和 Voter 副本所在的 TiKV Store ID。如果亲和性

SHOW AFFINITY 从 v8.5.5 和 v9.0.0 版本开始引入

SHOW AFFINITY 语句用于查看配置了 AFFINITY 选项的表的亲和性调度信息,以及 PD 当前记录的目标副本分布。

语法图

ShowAffinityStmt ::=
    "SHOW" "AFFINITY" ShowLikeOrWhereOpt

SHOW AFFINITY 支持使用 LIKE 或 WHERE 子句过滤表名。

示例

以下示例创建两个启用了亲和性调度的表,并查看其调度信息:

CREATE TABLE t1 (a INT) AFFINITY = 'table';
CREATE TABLE tp1 (a INT) AFFINITY = 'partition' PARTITION BY HASH(a) PARTITIONS 2;

SHOW AFFINITY;

输出结果示例如下:

+---------+------------+----------------+-----------------+------------------+----------+--------------+----------------------+
| Db_name | Table_name | Partition_name | Leader_store_id | Voter_store_ids  | Status   | Region_count | Affinity_region_count|
+---------+------------+----------------+-----------------+------------------+----------+--------------+----------------------+
| test    | t1         | NULL           | 1               | 1,2,3            | Stable   |            8 |                    8 |
| test    | tp1        | p0             | 4               | 4,5,6            | Preparing|            4 |                    2 |
| test    | tp1        | p1             | 4               | 4,5,6            | Preparing|            3 |                    2 |
+---------+------------+----------------+-----------------+------------------+----------+--------------+----------------------+

各列含义如下:

  • Leader_store_id、Voter_store_ids:PD 为该表或分区记录的目标 Leader 副本和 Voter 副本所在的 TiKV Store ID。如果亲和性分组尚未确定目标副本位置或 schedule.affinity-schedule-limit 为 0,则显示为 NULL。
  • Status:表示当前亲和性调度的状态。可能的取值如下:
    • Pending:PD 尚未对该表或分区进行亲和性调度(比如未确定 Leader 或 Voter 时)。
    • Preparing:PD 正在调度 Region 以满足亲和性要求。
    • Stable:所有 Region 已达到目标分布。
  • Region_count:当前在该亲和性组中的 Region 数量。
  • Affinity_region_count:当前已满足亲和性副本分布要求的 Region 数量。
    • 当 Affinity_region_count 小于 Region_count 时,表示仍有部分 Region 尚未完成基于亲和性的副本调度。
    • 当 Affinity_region_count 等于 Region_count 时,表示基于亲和性的 Region 副本迁移调度已完成,也就意味着所有 Region 的分布已经满足亲和性要求,但并不代表相关 Region 的合并操作已完成。

MySQL 兼容性

该语句是 TiDB 对 MySQL 语法的扩展。

另请参阅

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。