跳到主要内容
版本:0.6

Region migration

Region 迁移允许用户在 Datanode 间移动 Region 数据。

注意

该功能仅在 GreptimeDB 集群模式下可用,并且需要满足以下条件

  • 使用 Kafka WAL
  • 使用共享存储 (例如:AWS S3)

我们无法在任何上述以外的情况下使用 Region 迁移。

寻找 MetaSrv leader

首先我们需要找 MetaSrv Leader 节点,Region 迁移需要在 MetaSrv Leader 上执行。

curl {YOUR_META_SRV_SERVER}:3002/admin/leader
# 10.244.0.157:3002

查询 Region 分布

随后我们需要查询一下表的 Region 分布,这里我们使用上一步获取的 MetaSrv Leader 的地址(YOUR_META_SRV_LEADER_SERVER) 。

curl {YOUR_META_SRV_LEADER_SERVER}:3002/admin/route?table_id={TABLE_ID}

# "{\"type\":\"physical\",\"region_routes\":[{\"region\":{\"id\":4668629450752,\"name\":\"\",\"partition\":{\"column_list\":[],\"value_list\":[\"\\\"MaxValue\\\"\"]},\"attrs\":{}},\"leader_peer\":{\"id\":2,\"addr\":\"greptimedb-datanode-2.greptimedb-datanode.my-greptimedb:4001\"},\"follower_peers\":[]}],\"version\":2}"

例如:我们有以下的 Region 分布

region idleader_peerleader_peer_id
4668629450752greptimedb-datanode-2.greptimedb-datanode.my-greptimedb:40012

选择 Region 迁移的目标节点

Warning

当起始节点等于目标节点时,Region 迁移不会被执行

如果你通过 GreptimeDB operator 部署 DB 集群,Datanode 的 peer_id 总是从 0 开始递增。例如,DB 集群有 3 个 Datanode,则 peer_id 应为 0,1,2。 最后,你可以通过以下 HTTP 请求发起 Region 迁移请求:

curl "{YOUR_META_SRV_LEADER_SERVER}:3002/admin/region-migration?region_id={REGION_ID}&from_peer_id={FROM_PEER_ID}&to_peer_id={TO_PEER_ID}&replay_timeout=5m"
OptionDescriptionRequired
region_idRegion IdRequired
from_peer_id迁移起始节点(Datanode) 的 peer id。Required
to_peer_id迁移目标节点(Datanode) 的 peer id。Required
replay_timeout迁移时回放数据的超时时间,例如:1h30m10sRequired