Redis的slot迁移

短命女 2022-11-26 08:49 248阅读 0赞

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

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

<table> 
 <thead> 
  <tr> 
   <th align="left">CLUSTER SETSLOT 8 IMPORTING src-A-node-id</th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

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

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

<table> 
 <thead> 
  <tr> 
   <th align="left">CLUSTER SETSLOT 8 MIGRATING dst-B-node-id</th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

命令“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）：

<table> 
 <thead> 
  <tr> 
   <th align="left">CLUSTER GETKEYSINSLOT slot count</th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

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

<table> 
 <thead> 
  <tr> 
   <th align="left">MIGRATE dest-host dest-port key|"" destination-db timeout [COPY] [REPLACE] [AUTH password] [KEYS key [key …]]</th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

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

迁移单个key格式：

<table> 
 <thead> 
  <tr> 
   <th align="left">MIGRATE dest-host dest-port key destination-db timeout [COPY] [REPLACE] [AUTH password]</th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

或者：

<table> 
 <thead> 
  <tr> 
   <th align="left">MIGRATE dest-host dest-port “” destination-db timeout [COPY] [REPLACE] [AUTH password] KEYS key</th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

迁移多个keys格式：

<table> 
 <thead> 
  <tr> 
   <th align="left">MIGRATE dest-host dest-port “” destination-db timeout [COPY] [REPLACE] [AUTH password] [KEYS key [key …]]</th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

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指定的节点：

<table> 
 <thead> 
  <tr> 
   <th align="left">CLUSTER SETSLOT NODE </th> 
  </tr> 
 </thead> 
 <tbody></tbody> 
</table>

执行“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 STABLE”。

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

**跨集群迁移：**  
可使用命令“redis-cli --cluster import”将数据从一个redis集群迁到另一个redis集群。

[https_redis.io_commands_cluster-setslot]: https://redis.io/commands/cluster-setslot
[https_github.com_eyjian_redis-tools_blob_master_move_redis_slot.sh]: https://github.com/eyjian/redis-tools/blob/master/move_redis_slot.sh