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”。