一、权限要求
ALTER INSTANCE TRANSFER LEADER 需要当前用户具备SUPER权限。
二、语法
ALTER INSTANCE TRANSFER LEADER {RG | REP_GROUP} rep_group_id TO [NODE] new_leader_node [FORCE];
三、参数说明
| 参数 | 是否必选 | 说明 |
| rep_group_id | 必选 | 指定要转移领导节点的复制组 ID。 |
| new_leader_node | 必选 | 指定新的领导节点。 |
| FORCE | 可选 | 表示强制转移领导权。 |
四、示例
1. 查询 RG1792的leader_node_name信息。
如下所示， leader_node_name为node-tdsql3-86ea1ffe-002。
tdsql>select * from INFORMATION_SCHEMA.META_CLUSTER_RGS where rep_group_id=1792 \\G*************************** 1. row *************************** rep_group_id: 1792 data_space_type: DATA_SPACE_TYPE_SYSTEM rep_group_state: RG_STATE_L_WORKING meta_version: 36 member_version: 0 key_range_version: 36 quorum: 3 member_node_names: [node-tdsql3-86ea1ffe-001, node-tdsql3-86ea1ffe-002, node-tdsql3-86ea1ffe-003] leader_node_name: node-tdsql3-86ea1ffe-002 last_leader_report_time: 2024-08-20 11:30:07.277221 create_time: 2024-08-19 14:56:47.692831 parent_rep_group_id: 0 rep_group_stats_approximate_size: 9722004 rep_group_stats_approximate_keys: 3826 rep_group_log_info_current_term: 9 rep_group_log_info_committed_index: 30704 rep_group_log_info_consecutive_applied_index: 30704 rep_group_log_info_last_snapshot_index: 30683 rep_group_log_info_first_index: 2 rep_group_log_info_last_index: 30704 rep_group_log_info_disk_index: 30704 rep_group_log_info_applied_index: 30704rep_group_log_info_raft_log_sync_delay_seconds: 111 row in set (0.02 sec)
2. 将复制组1792的领导节点转移到node-tdsql3-86ea1ffe-003。
tdsql>ALTER INSTANCE TRANSFER LEADER RG 1792 TO 'node-tdsql3-86ea1ffe-003';Query OK, 0 rows affected (0.01 sec)job_id: 17373
3. 再次查看 RG1792的leader_node_name信息。
如下所示， 领导节点已转移到node-tdsql3-86ea1ffe-003。
tdsql>select * from INFORMATION_SCHEMA.META_CLUSTER_RGS where rep_group_id=1792 \\G*************************** 1. row *************************** rep_group_id: 1792 data_space_type: DATA_SPACE_TYPE_SYSTEM rep_group_state: RG_STATE_L_WORKING meta_version: 36 member_version: 0 key_range_version: 36 quorum: 3 member_node_names: [node-tdsql3-86ea1ffe-001, node-tdsql3-86ea1ffe-002, node-tdsql3-86ea1ffe-003] leader_node_name: node-tdsql3-86ea1ffe-003 last_leader_report_time: 2024-08-20 11:30:46.123801 create_time: 2024-08-19 14:56:47.692831 parent_rep_group_id: 0 rep_group_stats_approximate_size: 9727537 rep_group_stats_approximate_keys: 3837 rep_group_log_info_current_term: 10 rep_group_log_info_committed_index: 30719 rep_group_log_info_consecutive_applied_index: 30719 rep_group_log_info_last_snapshot_index: 30663 rep_group_log_info_first_index: 2 rep_group_log_info_last_index: 30719 rep_group_log_info_disk_index: 30719 rep_group_log_info_applied_index: 30719rep_group_log_info_raft_log_sync_delay_seconds: 21 row in set (0.01 sec)