您可以使用redis-shake的sync模式将自建Redis迁移至云数据库Redis版。

说明 自建Codis/Redis集群上云请参见Codis/Redis集群版通过redis-shake迁移上云

前提条件

  • 已创建作为迁移目的端的云数据库Redis版实例;
  • 已创建用于运行redis-shake的ECS实例,且ECS实例为64位Linux系统;
  • ECS实例可以访问目的Redis实例;

背景信息

redis-shake是阿里云自研的开源工具,支持对Redis数据进行解析(decode)、恢复(restore)、备份(dump)、同步(sync/rump)。在sync模式下,redis-shake使用SYNCPSYNC命令将数据从源端Redis同步到目的端Redis,支持全量数据同步和增量数据同步,增量同步在全量同步完成后自动开始。该模式支持自建Redis上云、自建Redis与云数据库Redis版的同步以及自建Redis之间的同步等场景。本文以使用sync模式将自建Redis上云为例进行说明。

说明
  • sync模式下源端Redis需支持SYNCPSYNC命令。如源端为云数据库Redis版,需使用有复制权限的账号连接Redis。
  • sync模式支持跨版本同步,如2.8版本实例与4.0版本实例同步。
  • 云数据库Redis集群版目前无法作为sync模式的源端。
  • 如需了解更多redis-shake相关信息,请参见redis-shake Github主页FAQ

操作步骤

  1. 登录可以连接云数据库Redis版实例(目的端Redis)的ECS。
  2. 在ECS中下载redis-shake
    说明 建议您下载最新发布的版本。
  3. 解压redis-shake.tar.gz
    # tar -xvf redis-shake.tar.gz
    说明 解压获得的redis-shake为64位Linux系统所需的二进制文件,redis-shake.conf为redis-shake的配置文件,您将在下个步骤对其进行修改。
  4. 修改redis-shake.conf配置文件,sync模式涉及的主要参数说明如下。
    表 1. redis-shake sync模式参数说明
    参数 说明 示例
    source.address 源Redis的连接地址与服务端口。 xxx.xxx.1.10:6379
    source.password_raw 源Redis的连接密码。 SourcePass233
    说明 如源端Redis为云数据库Redis版实例,需使用支持复制权限的账号连接,此时该参数值格式为account:password
    target.address 目的Redis的连接地址与服务端口。 r-bp1xxxxxxxxxxxxx.redis.rds.aliyuncs.com:6379
    target.password_raw 目的Redis的连接密码,此处为云数据库Redis版实例的密码。 TargetPass233
    rewrite 如果目的Redis有与RDB文件中相同的key,是否覆盖,可选值:
    • true(覆盖);
    • false(不覆盖)。
    说明 默认为true,建议对目的Redis中的有效数据进行完善的备份再执行恢复。如设置为false且存在数据冲突则会出现异常提示。
    true
    target.db

    设置待迁移的数据在目的Redis中的逻辑数据库名。

    例如,要将所有数据迁移到目的Redis中的DB10,则需将此参数的值设置为10。

    当该值设置为-1时,逻辑数据库名在源Redis和目的Redis中的名称相同,即源Redis中的DB0将被迁移至目的Redis中的DB0,DB1将被迁移至DB1,以此类推。

    0
    parallel RDB文件同步中使用的并发线程数,用于提高同步性能。
    说明
    • 最小值为1;
    • 最大值取决于服务器性能;
    • 推荐值为64。
    64
  5. 使用如下命令进行迁移。
    # ./redis-shake -type=sync -conf=redis-shake.conf
    说明 此命令需在二进制文件redis-shake和配置文件redis-shake.conf所在的目录中执行,否则请在命令中指定正确的文件路径。
  6. 查看同步日志确认同步状态,当出现sync rdb done时,全量同步已经完成,同步进入增量阶段。
    图 1. 同步日志

    使用redis-shake迁移Redis的示例
    说明
    • sync rdb done之后的日志中,若+forward=0,则此时源端没有新的数据写入,同步链路中没有增量数据正在传输,您可以以此为依据选择适当的时机将业务对接到云数据库Redis版。
    • 迁移完成后,您可以使用redis-full-check进行数据校验,确保两端数据一致,详细步骤请参见校验迁移后的数据