SHOW PLACEMENT

SHOW PLACEMENT 汇总了所有放置策略 (placement policy)，并用统一的形式呈现相关信息。

本语句返回结果中的 Scheduling_State 列标识了 Placement Driver (PD) 在当前对象上的调度进度，有以下可能结果：

  • PENDING: PD 没有进行调度。可能的原因之一是放置规则虽然语法上正确，但集群拓扑并不满足。比如指定 FOLLOWERS=4 但只有 3 个可用作 follower 的 TiKV 实例。
  • INPROGRESS: PD 正在进行调度。
  • SCHEDULED: PD 调度完成。

语法图

ShowStmt

SHOW PLACEMENT - 图1

  1. ShowStmt ::=
  2.     "SHOW" "PLACEMENT" ShowLikeOrWhere?

示例

  1. CREATE PLACEMENT POLICY p1 PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1" FOLLOWERS=4;
  2. CREATE TABLE t1 (a INT) PLACEMENT POLICY=p1;
  3. SHOW PLACEMENT;
  1. Query OK, 0 rows affected (0.01 sec)
  3. Query OK, 0 rows affected (0.00 sec)
  5. +---------------+----------------------------------------------------------------------+------------------+
  6. | Target        | Placement                                                            | Scheduling_State |
  7. +---------------+----------------------------------------------------------------------+------------------+
  8. | POLICY p1     | PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1" FOLLOWERS=4 | NULL             |
  9. | DATABASE test | PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1" FOLLOWERS=4 | INPROGRESS       |
  10. | TABLE test.t1 | PRIMARY_REGION="us-east-1" REGIONS="us-east-1,us-west-1" FOLLOWERS=4 | INPROGRESS       |
  11. +---------------+----------------------------------------------------------------------+------------------+
  12. 4 rows in set (0.00 sec)

MySQL 兼容性

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

另请参阅