本文共 5922 字，大约阅读时间需要 19 分钟。

目录

---

键管理

• 按照单个键、遍历键、数据库管理三个维度对一些通用命令进行介绍

单个键管理

• 针对单个键的命令，前面介绍了例如type、del、object、exists、expire等。

键重命名：rename key newkey

• 例如现有一个键值对，键为python，值为jedis：

127.0.0.1:6379> get python"jedis"

• 下面操作将键python重命名为java：

127.0.0.1:6379> set python jedisOK127.0.0.1:6379> rename python javaOK127.0.0.1:6379> get python(nil)127.0.0.1:6379> get java"jedis"

• 如果在rename之前，键java已经存在，那么它的值也将被覆盖，如下所示：

127.0.0.1:6379> set a bOK127.0.0.1:6379> set c dOK127.0.0.1:6379> rename a cOK127.0.0.1:6379> get a(nil)127.0.0.1:6379> get c"b"

• 为了防止被强行rename，Redis提供了renamenx命令，确保只有newKey不存在时候才被覆盖
  • 例如下面操作renamenx时，newkey=python已经存在，返回结果是0代表没有完成重命名，所以键java和python的值没变：

127.0.0.1:6379> set java jedisOK127.0.0.1:6379> set python redis-pyOK127.0.0.1:6379> renamenx java python(integer) 0127.0.0.1:6379> get java"jedis"127.0.0.1:6379> get python"redis-py"

• 重命名命令有两点需要注意：
  • 由于重命名键期间会执行del命令删除旧的键，如果键对应的值比较大，会存在阻塞Redis的可能性
  • 如果rename和renamenx中的key和newkey如果是相同的，在Redis3.2和之前版本返回结果略有不同
    • Redis3.2中会返回OK：

127.0.0.1:6379> rename key keyOK

• Redis3.2之前的版本会提示错误：

127.0.0.1:6379> rename key key(error) ERR source and destination objects are the same

随机返回一个键：randomkey

• 下面示例中，当前数据库有1000个键值对，randomkey命令会随机从中挑选一个键：

127.0.0.1:6379> dbsize1000127.0.0.1:6379> randomkey"hello"127.0.0.1:6379> randomkey"jedis"

键过期

• 可以自动将带有过期时间的键删除，在许多应用场景都非常有帮助。
  • 除了expire、ttl命令，还有expireat、pexpire、pexpireat、pttl、persist等一系列命令，下面分别进行说明：

expire key seconds

• 键在seconds秒后过期
• 下面为键hello设置了10秒的过期时间，然后通过ttl观察它的过期剩余时间（单位：秒），随着时间的推移，ttl逐渐变小，最终变为-2：

127.0.0.1:6379> set hello worldOK127.0.0.1:6379> expire hello 10(integer) 1#还剩7秒127.0.0.1:6379> ttl hello(integer) 7...#还剩0秒127.0.0.1:6379> ttl hello(integer) 0#返回结果为-2，说明键hello已经被删除127.0.0.1:6379> ttl hello(integer) -2

ttl 和 pttl

• ttl命令和pttl都可以查询键的剩余过期时间，但是pttl精度更高可以达到毫秒级别，有3种返回值

大于等于0的整数	键剩余的过期时间（ttl是秒，pttl是毫秒）
-1	键没有设置过期时间
-2	键不存在

expireat key timestamp

• 键在秒级时间戳timestamp后过期
• expireat命令可以设置键的秒级过期时间戳
• 例如如果需要将键hello在2016-08-0100：00：00（秒级时间戳为1469980800）过期，可以执行如下操作：

127.0.0.1:6379> expireat hello 1469980800(integer) 1

• 除此之外，Redis2.6版本后提供了毫秒级的过期方案：
  • pexpire key milliseconds：键在milliseconds毫秒后过期。
  • pexpireat key milliseconds-timestamp 键在毫秒级时间戳timestamp后过期。
• 但无论是使用过期时间还是时间戳，秒级还是毫秒级，在Redis内部最终使用的都是pexpireat。

注意事项

• 如果expire key的键不存在，返回结果为0

127.0.0.1:6379> expire not_exist_key 30(integer) 0

• 如果过期时间为负值，键会立即被删除，犹如使用del命令一样：

127.0.0.1:6379> set hello worldOK127.0.0.1:6379> expire hello -2(integer) 1127.0.0.1:6379> get hello(nil)

• persist命令可以将键的过期时间清除：

127.0.0.1:6379> hset key f1 v1(integer) 1127.0.0.1:6379> expire key 50(integer) 1127.0.0.1:6379> ttl key(integer) 46127.0.0.1:6379> persist key(integer) 1127.0.0.1:6379> ttl key(integer) -1

• 对于字符串类型键，执行set命令会去掉过期时间，这个问题很容易被忽视。
  • 如下是Redis源码中，set命令的函数setKey，可以看到最后执行了removeExpire（db，key）函数去掉了过期时间：

void setKey(redisDb *db, robj *key, robj *val) {    if (lookupKeyWrite(db,key) == NULL) {        dbAdd(db,key,val);    } else {        dbOverwrite(db,key,val);    }    incrRefCount(val);    // 去掉过期时间    removeExpire(db,key);    signalModifiedKey(db,key);}

• 下面的例子证实了set会导致过期时间失效，因为ttl变为-1：

127.0.0.1:6379> expire hello 50(integer) 1127.0.0.1:6379> ttl hello(integer) 46127.0.0.1:6379> set hello worldOK127.0.0.1:6379> ttl hello(integer) -1

• Redis不支持二级数据结构（例如哈希、列表）内部元素的过期功能
  • 如不能对列表类型的一个元素做过期时间设置。
• setex命令作为set+expire的组合，不但是原子执行，同时减少了一次网络通讯的时间。

迁移键

• 迁移键功能非常重要，因为有时候我们只想把部分数据由一个Redis迁移到另一个Redis（例如从生产环境迁移到测试环境）
  • Redis发展历程中提供了move、dump+restore、migrate三组迁移键的方法，它们的实现方式以及使用的场景不太相同，下面分别介绍。

move：move key db

• 如图所示，用于内部进行数据迁移，Redis内部可以有多个数据库，彼此在数据上是相互隔离的，move key db就是把指定的键从源数据库移动到目标数据库中，多数据库功能不建议在生产环境使用，所以这个命令知道即可。

dump+restore：dump keyrestore key ttl value

• 可以实现在不同的Redis实例之间进行数据迁移的功能，整个迁移的过程分为两步：
  • 在源Redis上，dump命令会将键值序列化，格式采用的是RDB格式。
  • 在目标Redis上，restore命令将上面序列化的值进行复原，其中ttl参数代表过期时间，如果ttl=0代表没有过期时间。
• 整个过程如下图所示

• 有两点需要注意：
  • 整个迁移过程并非原子性的，而是通过客户端分步完成的
  • 迁移过程是开启了两个客户端连接，所以dump的结果不是在源Redis和目标Redis之间进行传输，
• 下面用一个例子演示完整过程。
  • 1）在源Redis上执行dump：

redis-source> set hello worldOKredis-source> dump hello"\x00\x05world\x06\x00\x8f<T\x04%\xfcNQ"

• 2）在目标Redis上执行restore：

redis-target> get hello(nil)redis-target> restore hello 0 "\x00\x05world\x06\x00\x8f<T\x04%\xfcNQ"OKredis-target> get hello"world"

• 上面2步对应的伪代码如下：

Redis sourceRedis = new Redis("sourceMachine", 6379);Redis targetRedis = new Redis("targetMachine", 6379);targetRedis.restore("hello", 0, sourceRedis.dump(key));

migrate

migrate host port key|"" destination-db timeout [copy] [replace] [keys key [key ..

• 用在Redis实例间进行数据迁移的，实际上migrate命令就是将dump、restore、del三个命令进行组合，从而简化了操作流程。
• migrate命令具有原子性，而且从Redis3.0.6版本以后已经支持迁移多个键的功能，有效地提高了迁移效率，migrate在水平扩容中起到重要作用。
• 整个过程如图所示，实现过程和dump+restore基本类似，但是有3点不太相同：
  • 第一，整个过程是原子执行的，不需要在多个Redis实例上开启客户端的，只需要在源Redis上执行migrate命令即可。
  • 第二，migrate命令的数据传输直接在源Redis和目标Redis上完成的。
  • 第三，目标Redis完成restore后会发送OK给源Redis，源Redis接收后会根据migrate对应的选项来决定是否在源Redis上删除对应的键。

• 参数说明

host	目标Redis的IP地址
port	目标Redis的端口
key|""：	在 Redis3.0.6 版本之前， migrate 只支持迁移一个键，所以此处是 要迁移的键，但 Redis3.0.6 版本之后支持迁移多个键，如果当前需要迁移多 个键，此处为空字符串 "" 。
destination-db	目标 Redis 的数据库索引，例如要迁移到 0 号数据库，这 里就写 0 。
timeout	迁移的超时时间（单位为毫秒）
[copy]	如果添加此选项，迁移后并不删除源键
[replace]	如果添加此选项，migrate 不管目标 Redis 是否存在该键都会 正常迁移进行数据覆盖。
[keys key[key...]]	迁移多个键，例如要迁移 key1 、 key2 、 key3 ，此处填 写 “keys key1 key2 key3” 。

• 演示migrate命令
  • 为了方便演示源Redis使用6379端口，目标Redis使用6380端口
  • 现要将源Redis的键hello迁移到目标Redis中，会分为如下几种情况：
    • 情况1：源Redis有键hello，目标Redis没有：

127.0.0.1:6379> migrate 127.0.0.1 6380 hello 0 1000OK

• 情况2：源Redis和目标Redis都有键hello：

127.0.0.1:6379> get hello"world"127.0.0.1:6380> get hello"redis"

• 如果migrate命令没有加replace选项会收到错误提示，如果加了replace会返回OK表明迁移成功：

127.0.0.1:6379> migrate 127.0.0.1 6379 hello 0 1000(error) ERR Target instance replied with error: BUSYKEY Target key name already exists.127.0.0.1:6379> migrate 127.0.0.1 6379 hello 0 1000 replaceOK

• 情况3：源Redis没有键hello。
  • 如下所示，此种情况会收到nokey的提示：

127.0.0.1:6379> migrate 127.0.0.1 6380 hello 0 1000NOKEY

• Redis3.0.6版本以后迁移多个键的功能：
• 源Redis批量添加多个键

127.0.0.1:6379> mset key1 value1 key2 value2 key3 value3OK

• 源Redis执行如下命令完成多个键的迁移：

127.0.0.1:6379> migrate 127.0.0.1 6380 "" 0 5000 keys key1 key2 key3OK

move、dump+restore、migrate三个命令比较

【注】：参考《Redis开发与运维》