Redis教程

aws-redis数据非实时迁移

本文主要是介绍aws-redis数据非实时迁移,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

一、背景

因为一套环境要迁移到aws redis上,原本打算采用rdb上传到s3中,然后在创建新集群的时候使用s3种子的方式将rdb文件加载到新的集群中,这样比较方便快捷,但是遇到了两个问题,问题一是在大的rdb文件应用时会出现创建失败,问题二是这种方法没有办法实时同步,无法达到想要的平滑切换的效果

二、使用工具

工具名:redis-shake

1.下载

下载地址:https://github.com/alibaba/RedisShake/tags

 wget https://github.com/alibaba/RedisShake/releases/download/release-v2.0.3-20200724/redis-shake-v2.0.3.tar.gz

2.解压

tar xzf redis-shake-v2.0.3.tar.gz

3.编辑配置文件

cd redis-shake-v2.0.3
vim redis-shake.conf

4.配置文件详解

参数名解释
source.type根据源库(自建数据库)的架构选择,取值:standalone:主从架构。cluster:集群架构。
source.address源库的连接地址和端口号,连接地址和端口号之间使用英文冒号(:)分隔。
source.password_raw源库的密码,如果源库未设置密码,无需填写
target.type同source.type
target.address同source.address
target.password_raw同source.password_raw
target.db将源库中所有库的数据都迁移至目标库的指定库中,取值范围为0~15。说明 默认值为-1,表示不启用该功能。
key_exists当源库中的Key与目标库中的Key相同时,采取的数据写入策略,取值:rewrite:覆盖写入至目标库。none:默认值,停止运行Redis-shake程序并提示冲突的Key。ignore:直接跳过当前迁移的Key,保留目标库的数据,继续执行数据迁移
filter.db.whitelist需要迁移的库名,多个库名间用英文分号(;)分隔,默认为空,即迁移所有库。例:0;1
filter.db.blacklist不需要迁移的库名(即黑名单),多个库名间用英文分号(;)分隔。默认为空,即不设置黑名单。例:0;1
parallelRedis-shake执行迁移的并发线程数,适当调大该值可提高同步性能

5.配置文件示例

# 单点
source.type = standalone
source.address = redis_ip:redis_port
# password of db/proxy. even if type is sentinel.
source.password_raw = password
# 集群
target.type = cluster
target.address = redis_ip:redis_port;redis_ip:redis_port;redis_ip:redis_port
# 如果没有密码则可以不用填
target.password_raw =
key_exists = rewrite

6.错误及解决方案

6.1
**Q:同步时候出现报错**
2021/07/23 09:27:33 [PANIC] read error, please check source redis log or network
[error]: EOF
[stack]:
    1   /Users/tongyao.lty/Work/RedisShake/src/redis-shake/common/utils.go:930
            redis-shake/common.Iocopy
    0   /Users/tongyao.lty/Work/RedisShake/src/redis-shake/dbSync/syncBegin.go:92
            redis-shake/dbSync.(*DbSyncer).runIncrementalSync

查看源端redis日志
events=rw cmd=psync scheduled to be closed ASAP for overcoming of output buffer limits.

解决办法:
config set client-output-buffer-limit 'normal 0 0 0 slave 0 0 0 pubsub 268435456 67108864 60'


github上的问题解答:https://github.com/alibaba/RedisShake/wiki/常见问题?spm=a2c4g.11186623.2.28.42012b83tcBOfH#2-报错问题解决
6.2
Q: 是否支持断点续传?
A: 目前支持主从版和部分集群版,具体请查看wiki上相应的文档。

6.3
Q: 对于某些云上redis,比如部分云厂商不支持sync/psync权限,如何进行迁移?
A: 从v1.4版本开始,我们支持了rump模式进行扫描迁移,可以应对sync/psync权限没有开放的场景。该种模式只支持全量,不支持增量。具体请参考wiki上的使用文档。

6.4
Q: 为什么我的源端主从有0-15,一共16个逻辑db,而同步到目的端的集群版就只有db0了?
A: 因为集群版只支持db0,所以db1-15的数据都不会同步到目的端。


6.5
Q: 如何过滤lua脚本?
A: 从v1.6.9版本开始,用户可以设置filter.lua参数进行过滤,具体请参考配置文件的说明。而在5.0的redis版本中,所有的lua都会转换为事务操作,就不能被过滤了。

6.6
Q: 如果启用过滤key的功能?
A: 用户可以设定filter.key.whitelist让指定前缀的key通过,也可以指定filter.key.blacklist让指定前缀的key不通过,其余的通过。注意这2个参数只能最多指定其中一个。例如,filter.key.whitelist = abc;xxx;efg会让abc,abc1,xxxyyyy通过,而kkk,mmm都不会通过。

6.7
Q: RedisShake是否支持codis和twemproxy?
A: 支持。不过请设置big_key_threshold = 1,以及启用filter.lua = true。

6.8
Q: 如何控制同步的并发数?
A: 用户可以通过source.rdb.parallel参数控制同步的并发数,比如source.rdb.parallel = 4表示一次只会通过4个全量,只有当其中一个全量同步完成以后,才会开启新的一个全量同步。举个例子,比如源端有8个分片,设置4的话表示同一时刻只会同步4个,假如第1个全量完成了(restore模式完成或者sync模式进入增量),那么会开启第5个全量同步,以此类推直到所有的都完成或者进入增量同步。

6.9
Q: 是否支持db映射,比如源端的db2同步到目的端的db10?
A: 不支持,目前只支持所有源端db同步到目的端一个db,比如设置target.db = 10,那么所有源端的逻辑db都会同步到目的端的db10。


6.10

Q: decode Redis resp failed. [error]: EOF
A: 如果用户源端从slave上进行拉取的,而源端master跟slave的连接断开了,那么从slave拉取就会失败。

6.11
Q: [PANIC] read sync response = ''. EOF
A: 用户需要检查源端redis节点的日志,通常来说,是源端已经save rdb期间,拒绝掉新来的psync请求,可能发生在某些redis版本。用户需要等待一段时间再重试。

6.12
Q: -ERR Can\'t SYNC while not connected with my master
A: 参见上面这个EOF的问题。

6.13
Q: target key name is busy
A: 目的端对应的key已经存在。解决方法有如下三种,可任选其一:
删除目的端报错的key。
启用key_exists = rewrite(源端Key覆盖目的端,v1.6.27版本开始支持,在v1.6.27之前是rewrite = true)
启用key_exists = ignore(忽略报错的key,v1.6.27版本开始支持)

6.14
Q: -ERR Unable to perform background save
A: 请检查源端redis日志,源端bgsave失败,通常是内存不够了,或者磁盘写入失败。

6.15
Q: OOM command not allowed when used memory > 'maxmemory'
A: 写入到目的端的时候,内存超过原来规格。

6.16
Q: [PANIC] parse rdb entry error, if the err is :EOF, please check that if the src db log has client outout buffer oom, if so set output buffer larger
A: 请检查源端redis日志,通常是全量同步过久或者增量过大,导致output buffer打满。通常解决办法有如下几种:

增大shake全量同步的并发度,调高parallel。
修改增大源端output buffer的大小, 通过修改output-buffer-limit参数。(建议采用这种方式)
在业务低峰期再进行同步。


6.17
Q: restore command error key:xxx err:-ERR server closed connection
A: 意味着目的端把连接给关闭了,如果是写的key过大导致的,可以降低big_key_threshold对key进行拆分。


6.18
Q: [PANIC] auth failed[-ERR unknown command '']
A: 设置source.auth_type = auth和target.auth_type = auth。这个问题在v2.6.26版本已经修复掉了,参加:https://github.com/alibaba/RedisShake/issues/237


6.19
Q: ERR redis tempory failure
A: 对于某些集群版,比如阿里云,如果后台db节点发生过主从切换,会报错这个。


6.20
Q: Error: NOSCRIPT No matching script. Please use EVAL
A: 这个通常发生在目的端。这个错误表示对应的lua脚本已经丢失了。在redis版本v4.0.4以后这个问题不会出现,在4.0.4以前,源端连接的是slave节点,是可能会出现这个问题的。解决方法如下选一:
源端升级到4.0.4以后的版本
源端连接master。
手动在目的端添加缺失的lua脚本
源端启用redis.replicate_commands()

6.21
Q: checksum validation failed
A: 源端redis禁用了checksum选项,可以通过config set rdbchecksum进行开启。


6.22
Q: ERR 'EVAL' command keys must in the same slot
A: lua脚本操作的key不位于同一个slot,通常出现在目的端为集群版的情况。用户可以自己修改Lua脚本,或者将涉及到的key通过hashtag等手段划到一个slot内部。


6.23
Q: Conf.Options check failed: get target redis version failed[EOF]
A: 对于某些版本比如twemproxy,不支持获取目的端的redis版本。用户可以通过设置target.version强制设定目的端版本。


6.24
Q: ERR syntax error
A: 通常出现在目的端redis版本小于源端redis的版本,所以部分数据格式不兼容。


6.25
Q: [xxx] redis address should be all masters or all slaves, master:[xxx], slave[xxx]
A: 如果用户输入的是集群版,需要只输入master或者只slave,指定的角色不能既有master又有slave。参加issue#149



6.26
Q: do dump with failed[EOF]
A: 源端redis断开连接,用户需要检查源端redis的日志情况。通常是某个key过大,比如超过了512M(没有办法解决),或者output buffer打满导致的。


6.27
Q: Error: CROSSSLOT Keys in request don\'t hash to the same slot
A: 这个表示后用户的单次请求里面的key没有分发到一个slot,而这个是redis集群本身的强约束。在redis-shakev1.6.27开始,放开了部分命令的约束,从一个slot放开到一个分片db。


6.28
Q: ERR DUMP payload version or checksum are wrong
A: 通常出现在rump模式,源端版本大于目的端版本,比如源端是4.0,目的端2.8,某些数据结构格式已经修改导致无法同步。用户可以设置big_key_threshold = 1绕过这个限制。


6.29
Q: [PANIC] restore command response = \'ECONNTIMEOUT: dial tcp xxx:1000: connect: cannot assign requested address', should be 'OK'
A: 本机端口耗尽了,需要排查一下原因。


6.30
Q: ERR syntax error
A: 同样出现在源端版本大于目的端版本的情况,比如源端是4.0,目的端2.8。


6.31
Q: run ChooseNodeWithCmd failed[transaction command[xxxx] key[yyyyy] not hashed in the same slot]
A: 事务中的key需要分发到一个slot里面,通常出现在源端形态和目的端不一致(比如源端是主从,目的端是集群),或者源端集群版的slot分布和目的端不一致。


6.32
Q: return error[ERR Bad data format], ignore it and try to split the value
A: 同样出现在源端版本大于目的端版本的情况,比如源端是4.0,目的端2.8。用户可以设置big_key_threshold = 1绕过这个限制。


6.33
Q: lua同步报错?
A: 常见报错如下:
ERR bad lua script for redis cluster, first parameter of redis.call/redis.pcall must be a single literal string
\"-ERR bad lua script for redis cluster, all the keys that the script uses should be passed using the KEYS array\r\n"`
\"-ERR for redis cluster, eval/evalsha number of keys can\'t be negative or zero\r\n\"
"-ERR eval/evalsha command keys must in same slot\r\n"
出现在目的端为阿里云集群版的情况。基本上的问题都是用户没有按照集群版的规范编写lua脚本,通常发生在主从变配到集群的时候,目前redis-shake版本已经支持对导入出错的lua进行过滤
云上redis-shake版本请在配置文件中设置"filter.lua = 2"再重启redis-shake即可,通常还需要再加上"rewrite = true"。
开源redis-shake版本请设置filter.lua = true,通常还需要加上rewrite = true(1.6.27以前的版本),或者key_exists = rewrite(1.6.27及以后的版本)。
Q: ERR unknown command 'ISCAN'

A: 这个是用户配置项里面添加了scan.special_cloud = aliyun_cloud选项,这个选项是只针对阿里云的集群版的,如果源端是主从版,请去掉该选项。

6.34

Q: ERR command replconf not support for your account

A: 源端如果是阿里云的版本会报错这个,对于主从版需要在控制台申请复制权限,用申请到的密码贴到source.password_raw里面;对于集群版,目前还不支持复制权限,所以用户只能使用rump模式进行全量的扫描迁移,不支持增量。
这篇关于aws-redis数据非实时迁移的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!