Redis的slot迁移

 

官方参考：https://redis.io/commands/cluster-setslot。示例：将值为8的slot从源节点A迁移到目标节点B。

1) 在目标节点B上执行，从节点A导入slot到节点B：

CLUSTER SETSLOT 8 IMPORTING src-A-node-id

 

对于迁移的slot，正常访问返回MOVED；但如果在正常访问之前先执行ASKING，则能正常处理该slot。

 

2) 在源节点A上执行，将节点A上的slot迁移到节点B

CLUSTER SETSLOT 8 MIGRATING dst-B-node-id

 

命令“SETSLOT slot MIGRATING”将slot标记为正在迁移（MIGRATING）状态。如果访问的key在源节点上存在，则正常访问；如果访问的key在源节点上不存在，则返回ASK重定向到目标节点。

如果是操作多个keys，则情况有些复杂。如果全不存在或者全存在，则和操作单key相同。但如果是部分存在，部分不存在，则返回错误“TRYAGAIN”。

 

注意，上列步骤1和2的执行顺序不能颠倒，目的是让目标节点先准备好接受ASK重定向命令（The order of step 1 and 2 is important. We want the destination node to be ready to accept ASK redirections when the source node is configured to redirect.）。

 

3) 迁移数据/数据迁移

如果是一个空集群，则这一步可以跳过省去，因为此时还没有任何需要迁移的数据。前面的步骤1和步骤2只影响新的keys，并不会自动迁移已有的keys。

已有的keys需用命令MIGRATE迁移，借助命令“CLUSTER GETKEYSINSLOT”可知道slot有哪些keys。

在源节点上执行获得需要迁移的keys（参数“count”指标一次返回多少个keys）：

CLUSTER GETKEYSINSLOT slot count

 

在源节点上执行命令MIGRATE迁移keys：

MIGRATE dest-host dest-port key|"" destination-db timeout [COPY] [REPLACE] [AUTH password] [KEYS key [key ...]]

 

命令“MIGRATE”的参数dest-host和dest-port为目标节点的IP和端口号，参数“REPLACE”表示覆盖目标节点相同的keys，而“COPY”不会删除源节点上的keys。

 

迁移单个key格式：

MIGRATE dest-host dest-port key destination-db timeout [COPY] [REPLACE] [AUTH password]

 

或者：

MIGRATE dest-host dest-port "" destination-db timeout [COPY] [REPLACE] [AUTH password] KEYS key

 

迁移多个keys格式：

MIGRATE dest-host dest-port "" destination-db timeout [COPY] [REPLACE] [AUTH password] [KEYS key [key ...]]

 

AUTH用于指定访问密码，从Redis-6.0开始，新增支持AUTH2。参数timeout用于指定超时时长，单位毫秒。

如果是一个集群对另一个集群，必须保证保证目标节点是key对应的节点。对于集群间迁移，如果多keys需保证对应的slots都在目标节点上，否则报错“CROSSSLOT Keys in request don't hash to the same slot”。

如果版本号不同，则还会遇到错误“ERR Target instance replied with error: ERR DUMP payload version or checksum are wrong”。

 

4) 完成迁移

上述操作只是将slot标记为迁移状态，完成迁移还需要执行（在源node和目标node上执行），将slot指派给dst-node-id指定的节点：

CLUSTER SETSLOT <slot> NODE <dst-node-id>

 

执行“NODE”会产生新的配置，实际上可在所有master节点上执行“NODE”，这样避免了新的配置在集群中传播，加快了配置的更新，官方说明可参见“Cluster live reconfiguration”一节。

 

重复执行“NODE”，会报错“ERR I'm already the owner of hash slot 1703”。

“NODE”命令中的dst-node-id为目标节点的Node ID，取消迁移和导入使用“CLUSTER SETSLOT <slot> STABLE”。

 

手动完成上列4步操作繁琐且容易出错，如有需要可直接使用现在的迁移工具https://github.com/eyjian/redis-tools/blob/master/move_redis_slot.sh。

 

附：跨集群的数据迁移可使用命令“redis-cli --cluster import”。