Redis 到 AWS ElastiCache

选择对端数据库：

AWS ElastiCache

数据链路

基本功能

功能	说明
全量迁移、增量同步一体化	通过执行 PSYNC 指令同步数据, 可选历史数据初始化
回溯位点	支持通过修改位点，重新初始化历史数据
部署形态支持	支持 单节点、Sentinel、分片集群 Redis
指令支持	当前支持以下指令(不断增加丰富): SET, SETNX, SETEX, APPEND, GETSET, HSET, HSETNX, MSET, HMSET DEL, HDEL, UnLink INCR, INCRBY, HINCRBY, DECR, DECRBY LPUSH, RPUSH, LSET, LINSERT, LREM, LPOP, RPOP, LTRIM SADD, ZADD, ZREM, ZREMRANGEBYSCORE, SREM, ZINCRBY, ZREMRANGEBYRANK, ZREMRANGEBYLEX EXPIRE, PExpire, RENAME, Eval, PUBLISH

高级功能

功能	说明
缓存失效时间	支持设置数据到 Redis 后缓存失效时间（单位：秒）
Redis 双向同步	支持全量迁移、增量同步双向防循环，文档：Redis 双向数据同步
Redis 双向同步指令支持	当前双向同步支持以下指令(不断增加丰富): SET, SETNX, SETEX, APPEND, GETSET, HSET, HSETNX, MSET, HMSET DEL, HDEL, UnLink INCR, INCRBY, HINCRBY LPUSH, RPUSH, LSET, LINSERT, LREM, LPOP, RPOP, LTRIM SADD, ZADD, ZREM, ZREMRANGEBYSCORE, SREM, ZREMRANGEBYRANK, ZREMRANGEBYLEX EXPIRE, PExpire, Eval, PUBLISH

限制和注意点

限制项	说明
主备切换兼容性	Redis 3.x 因使用早期版本的 PSYNC , 主备切换适配较差，存在丢数据风险
复制 backlog 设置	Redis 默认复制参数 repl-backlog-size 过小, 如数据同步延迟过大，可能触发 FULL SYNC 全量初始化。需调大此参数

使用示例

标题	详情
Redis 双向数据同步	文档：Redis 双向数据同步

---

源端数据源

前置条件

条件	说明
指令准备	可执行 PSYNC 指令 (托管云服务可能不支持该指令)
网络准备	迁移同步节点（sidecar）可连接 Redis 各节点和 Sentinel 节点（如果有）

任务参数

参数名称	说明
dbHeartbeatIntervalSec	发送 PING 指令的间隔时间
deCycle	双向同步过滤开关，过滤带防循环事件的增量事件
deCycleMode	双向同步过滤事件模式：GET_KEY 代表 查询 标记模式，DEL_KEY 代表 删除 标记模式，TX_SIGN 代表 事务 标记模式
enableDbMapping	Redis 启用 DB 映射，需要保证源端和目标端实例 DB 数量相等
deCycleEventExpireSec	防循环事件写入对端后的过期时间, <0 则不过期
extractorQueueSize	暂存的 Redis 事件的队列大小
inputStreamBufferSize	接收 Redis 响应的字节流 buffer 大小
connAndSoTimeoutMs	TCP 链接参数 SO_TIMEOUT
receiveBufferSize	TCP 链接参数 SO_RCVBUF
sendBufferSize	TCP 链接参数 SO_SNDBUF
isSentinel	true 代表 Redis Sentinel 集群，false 则代表 单机或分片集群
sentinelUser	连接 Sentinel 的用户名
sentinelPassword	连接 Sentinel 的密码
sentinelMasterName	Redis Sentinel 配置中指定的 Master Name
enableWriteDeReplay	Redis 增量非幂等指令时，是否开启防重放逻辑

Tips: 通用参数配置请参考 通用参数及功能

---

目标端数据源

前置条件

条件	说明
网络准备	迁移同步节点（sidecar）可连接 Redis/AWS ElastiCache 各节点和 Sentinel 节点（如果有）

任务参数

参数名称	说明
isSentinel	true 代表 Redis Sentinel 集群，false 则代表 单机或分片集群
sentinelUser	连接 Sentinel 的用户名
sentinelPassword	连接 Sentinel 的密码
sentinelMasterName	Redis Sentinel 配置中指定的 Master Name
secondsToExpire	通过 set 指令写入对端数据的 过期时间，-1 则不做限制

Tips: 通用参数配置请参考 通用参数及功能