将GeminiDB Redis迁移到Redis

GeminiDB Redis

• 本地自建Codis集群（开源Codis 3.0及以上版本）
• ECS自建Codis集群（开源Codis 3.0及以上版本）

• 本地自建Redis单机版（2.8.x、3.0.x、3.2.x、4.0.x、5.0.x版本）
• ECS自建Redis单机版（2.8.x、3.0.x、3.2.x、4.0.x、5.0.x版本）
• 本地自建Redis主备版（4.0.x、5.0.x版本）
• ECS自建Redis主备版（4.0.x、5.0.x版本）
• GeminiDB Redis

迁移对象范围

• 迁移对象选择维度：仅支持全部迁移。
• 支持的迁移对象：
  • 支持String，Hash，List，Set，Sorted Set类型迁移。
  • 不支持Lua脚本和事务的迁移。
  • 不支持Stream，Exhash ，Bloomfilter类型迁移。
  • 不支持自定义类型。
  • 不支持迁移目标库不支持的命令。

任务启动前须知

• 源数据库要求：
  • 源库必须是本云GeminiDB Redis实例。
  • 一个GeminiDB Redis实例只能同时作为一个DRS任务的源端数据库。
  • 源数据库GeminiDB Redis内核版本（gemini version）为4.2.0及以上。
  • 源库存在数据的数据库序号，需要小于目标库的最大序号，比如源库10号库存在数据，则目标库最大序号需要大于或等于10。
  • 创建全量+增量任务，需要支持PSYNC命令。
  • 源数据库GeminiDB Redis需要开启复制功能。

    set config set enable-replication 1。

  • notify-keyspace-events 配置项开启通知过期事件互斥，如需使用迁移功能，需关闭 通知过期事件的功能.
• 目标数据库要求：
  • 迁移前目标库建议为空。
  • 目标数据库实例必须有足够的存储空间。
  • 如果目标库是Redis 5.0主备版，目标库测试连接请填写主节点、从节点、哨兵节点的所有IP和对应端口，且主从节点和哨兵节点的密码必须设置成一致。
  • 如果目标库是Redis 4.0主备版，且主从节点设置了requirepass参数（有密码），DRS此时把主备Redis当成单机版Redis，暂不支持目标库发生主备倒换场景，目标库测试连接请只填写主节点IP和端口。
  • 如果目标库是Redis 4.0主备版，且主从节点没有设置requirepass参数（无密码），可以支持目标库发生主备倒换场景，目标库测试连接请填写主节点、从节点、哨兵节点的所有IP和对应端口。
• 其他使用须知：
  • 全量+增量任务使用解析RDB的方式读取数据。
  • 如果源库GeminiDB Redis复制功能超时时间repl-timeout过小（当前默认是3600s），可以适当进行扩大，防止任务失败时间过长，导致任务无法续传。
  • 迁移过程中，如果源库GeminiDB Redis增配导致任务失败，需要重置任务。且为保障数据一致性，在重置任务前，建议先清空已迁移至目标的数据。（任务增量中且源库内核版本（gemini version）6.3.0及以上无需重置）
  • 迁移过程中，不支持源库GeminiDB Redis减配，如果源库需要减配，请重新创建迁移任务。（任务增量中且源库内核版本（gemini version）6.3.0及以上无需重置）
  • 对于List对象，由于在调用PSYNC进行重传时，不会对目标端已有的数据进行清空，可能导致出现重复数据。
  • 源库GeminiDB Redis为主备版时，不支持在源库执行包含多个key的命令（例如mset等），否则可能因为key不在同一个slot或者涉及多个slot，导致报错：CROSSSLOT Keys in request don't hash to the same slot。

全量迁移阶段须知

• 迁移过程中，不允许修改连接源和目标数据库的密码，或修改源和目标数据库的端口号。
• 迁移过程中，不允许对正在迁移中的目标数据库进行修改操作。

增量迁移阶段须知

• 迁移过程中，不允许修改连接源和目标数据库的密码，或修改源和目标数据库的端口号。
• 迁移过程中，不允许对正在迁移中的目标数据库进行修改操作。