将Redis迁移到GeminiDB Redis

• 本地自建官方开源单机或主备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版本）

迁移对象范围

• 迁移对象选择维度：支持选择库级。
• 支持的迁移对象：
  • 支持String，Hash，List，Set，Sorted Set类型迁移。
  • 支持Lua脚本迁移（单全量任务不支持）。
  • 不支持事务的迁移。
  • 不支持Stream，BitMap，HyperLogLog，GEO类型迁移。
  • 不支持自定义类型。
  • 不支持迁移目标库GeminiDB Redis不支持的命令。

任务启动前须知

• 源数据库对象要求：
  • 创建全量+增量任务，需要支持PSYNC命令。
• 目标数据库对象要求：
  • 目标库必须是本云GeminiDB Redis实例。
  • 迁移前目标库GeminiDB Redis实例必须为空。
  • 目标数据库实例版本要高于或等于源数据库版本。
• 其他使用须知：
  • 单全量任务使用SCAN方式读取数据。
  • 全量+增量任务使用解析RDB的方式读取数据。
  • 源库不支持PSYNC命令的情况下，请使用单全量模式迁移。
  • 源库支持PSYNC命令，请使用全量+增量模式迁移。
  • 单全量任务不支持迁移过期时间。
  • 单全量任务不支持Lua脚本迁移。
  • 迁移Lua脚本时，源库需要同时有其它数据，否则无法解析出RDB中的Lua脚本，导致Lua脚本迁移失败。
  • 源库为自建单机版Redis时，增量阶段支持append，blpop，brpop，decr，decrby，del，expire，expireat，flushall，flushdb，getset，hdel，hincrby，hincrbyfloat，hmset，hset，hsetnx，incr，incrby，incrbyfloat，linsert，lpop，lpush，lpushx，lrem，lset，ltrim，move，mset，msetnx，multi，persist，pexpire，pexpireat，psetex，publish，rename，rpop，rpush，rpushx，sadd，select，set，setbit，setex，setnx，setrange，smove，spop，srem，zadd，zincrby，zrem，zremrangebylex，zremrangebyrank，zremrangebyscore。
  • 源库为单机版Redis时，由于GeminiDB Redis只允许单个命令操作单个slot，若在源库执行包含多个key的命令操作时，key不在同一个slot或涉及多个slot，会出现报错：CROSSSLOT Keys in request don't hash to the same slot。
  • DRS不会对目标库进行FLUSH等高危操作，所以对于List列表类型数据，可能出现重复的数据。
  • 为保障增量迁移有效进行，建议迁移前，评估源库Redis参数，将源库的配置文件redis.conf中repl-backlog-size参数的值适当调大。
  • 迁移过程中，如果自建Redis发生扩缩容（例如增加或者减少分片）、规格变配（例如扩大内存），则需要重新配置迁移任务。且为保证数据一致性，在重新配置任务前，建议先清空已迁移至目标GeminiDB Redis的数据。
  • 如果源库中的某些Key设置了过期（expire）策略，由于可能存在Key已过期但未被及时删除的情况，所以在目标库中查看Key数量（例如通过info命令查看）时会比源库的Key数量少。为保障数据的一致性，建议设置延长Key的过期时间。

全量迁移阶段须知

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

增量迁移阶段须知

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