sql-statement-change-pump.md

title	summary	aliases
CHANGE PUMP	TiDB 数据库中 CHANGE PUMP 的使用概况。	/docs-cn/dev/sql-statements/sql-statement-change-pump/

CHANGE PUMP

CHANGE PUMP 语句用于修改集群中 Pump 的状态信息。

注意：

Pump 在正常运行时会自动上报状态到 PD，仅在 Pump 处于异常情况导致实际状态与 PD 中保存的状态信息不一致时，使用该语句修改 PD 中存储的 Pump 状态信息。

示例

{{< copyable "sql" >}}

SHOW PUMP STATUS;

+--------|----------------|--------|--------------------|---------------------|
| NodeID |     Address    | State  |   Max_Commit_Ts    |    Update_Time      |
+--------|----------------|--------|--------------------|---------------------|
| pump1  | 127.0.0.1:8250 | Online | 408553768673342237 | 2019-04-30 00:00:01 |
+--------|----------------|--------|--------------------|---------------------|
| pump2  | 127.0.0.2:8250 | Online | 408553768673342335 | 2019-05-01 00:00:02 |
+--------|----------------|--------|--------------------|---------------------|
2 rows in set (0.00 sec)

可以看出 pump1 已经超过一天没有更新状态，该 Pump 处于异常状态，但是 State 仍然为 Online，使用 CHANGE PUMP 将该 Pump 状态修改为 paused：

{{< copyable "sql" >}}

CHANGE PUMP TO NODE_STATE ='paused' FOR NODE_ID 'pump1';

Query OK, 0 rows affected (0.01 sec)

{{< copyable "sql" >}}

SHOW PUMP STATUS;

+--------|----------------|--------|--------------------|---------------------|
| NodeID |     Address    | State  |   Max_Commit_Ts    |    Update_Time      |
+--------|----------------|--------|--------------------|---------------------|
| pump1  | 127.0.0.1:8250 | Paused | 408553768673342237 | 2019-04-30 00:00:01 |
+--------|----------------|--------|--------------------|---------------------|
| pump2  | 127.0.0.2:8250 | Online | 408553768673342335 | 2019-05-01 00:00:02 |
+--------|----------------|--------|--------------------|---------------------|
2 rows in set (0.00 sec)

MySQL 兼容性

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

另请参阅

• SHOW PUMP STATUS
• SHOW DRAINER STATUS
• CHANGE DRAINER STATUS