redis命令-key操作

DEL

RENAME

RENAMENX

DEL

语法：DEL key [key ...]
功能：删除给定的一个或多个 key 。
可用版本：>= 1.0.0
时间复杂度：O(N)， N 为被删除的 key 的数量。删除单个列表、集合、有序集合或哈希表类型的 key ，时间复杂度为O(M)， M 为以上数据结构内的元素数量。
返回值：被删除 key 的数量。

RENAME

语法：RENAME key newkey
功能：将 key 改名为 newkey 。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：改名成功时提示 OK ，失败时候返回一个错误。当 key 和 newkey 相同，或者 key 不存在时，返回一个错误。当 newkey 已经存在时， RENAME 命令将覆盖旧值。

RENAMENX

语法：RENAMENX key newkey
功能：将 key 改名为 newkey 。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：如果 newkey 已经存在，返回 0 。如果 newkey 已经存在，返回 0 。

EXPIRE

语法：EXPIRE key seconds
功能：为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：设置成功返回 1 。当 key 不存在或者不能为 key 设置生存时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的生存时间)，返回 0 。

说明

为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。

在 Redis 中，带有生存时间的 key 被称为『易失的』(volatile)。

SET,GETSET,INCR，RENAME等修改命令，不会修改过期时间。

使用 PERSIST 命令可以在不删除 key 的情况下，移除 key 的生存时间，让 key 重新成为一个『持久的』(persistent) key 。

可以对一个已经带有生存时间的 key 执行 EXPIRE 命令，新指定的生存时间会取代旧的生存时间。

在 Redis 2.4 版本中，过期时间的延迟在 1 秒钟之内 ,在新的 Redis 2.6 版本中，延迟被降低到 1 毫秒之内。

EXPIREAT

语法：EXPIREAT key timestamp
功能：为给定 key 设置生存时间，当 key 过期时(生存时间为 0 )，它会被自动删除。命令接受的时间参数是 UNIX 时间戳(unix timestamp)
可用版本：>= 1.2.0
时间复杂度：O(1)
返回值：如果生存时间设置成功，返回 1 。当 key 不存在或没办法设置生存时间，返回 0 。

EXPIREAT cache 1355292000  #后3位是000，到秒级

PEXPIRE

语法：PEXPIRE key milliseconds
功能：以毫秒为单位设置 key 的生存时间
可用版本：>= 2.6.0
时间复杂度：O(1)
返回值：设置成功返回 1 。key 不存在或设置失败，返回 0

PEXPIREAT

语法：PEXPIREAT key milliseconds-timestamp
功能：以毫秒为单位设置 key 的过期 unix 时间戳
可用版本：>= 2.6.0
时间复杂度：O(1)
返回值：设置成功返回 1 。key 不存在或设置失败，返回 0

PEXPIREAT mykey 1555555555005    #到毫秒级

TTL

语法：TTL key
功能：以秒为单位，返回给定 key 的剩余生存时间(TTL, time to live)。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：当 key 不存在时，返回 -2 。当 key 存在但没有设置剩余生存时间时，返回 -1 。否则，以秒为单位，返回 key 的剩余生存时间。

PTTL

语法：PTTL key
功能：以毫秒为单位，返回给定 key 的剩余生存时间(TTL, time to live)。
可用版本：>= 2.6.0
时间复杂度：O(1)
返回值：当 key 不存在时，返回 -2 。当 key 存在但没有设置剩余生存时间时，返回 -1 。否则，以毫秒为单位，返回 key 的剩余生存时间。

PERSIST

语法：PERSIST key
功能：移除给定 key 的生存时间，将这个 key 从『易失的』(带生存时间 key )转换成『持久的』(一个不带生存时间、永不过期的 key )。
可用版本：>= 2.2.0
时间复杂度：O(1)
返回值：当生存时间移除成功时，返回 1 .如果 key 不存在或 key 没有设置生存时间，返回 0 。

EXISTS

语法：EXISTS key
功能：检查给定 key 是否存在。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：若 key 存在，返回 1 ，否则返回 0 。

KEYS

语法：KEYS pattern
功能：检查给定 key 是否存在。
可用版本：>= 1.0.0
时间复杂度：O(N)， N 为数据库中 key 的数量。
返回值：符合给定模式的 key 列表。

*匹配所有字符

?匹配单个字符

[ae]匹配字符列表

特殊符号用 \ 隔开

KEYS 的速度非常快，但在一个大的数据库中使用它仍然可能造成性能问题，如果你需要从一个数据集中查找特定的 key ，你最好还是用 Redis 的集合结构(set)来代替。

MOVE

语法：move key db
功能：将当前数据库的 key 移动到给定的数据库 db 当中。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：若 key 存在，返回 1 ，否则返回 0 。

如果当前数据库(源数据库)和给定数据库(目标数据库)有相同名字的给定 key ，或者 key 不存在于当前数据库，那么 MOVE 没有任何效果。

因此，也可以利用这一特性，将 MOVE 当作锁(locking)原语(primitive)。

RANDOMKEY

语法：RANDOM KEY
功能：从当前数据库中随机返回(不删除)一个 key 。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：当数据库不为空时，返回一个 key 。当数据库为空时，返回 nil 。

OBJECT

语法：OBJECT subcommand [arguments [arguments]]
功能：OBJECT 命令允许从内部察看给定 key 的 Redis 对象。
可用版本：>= 2.2.3
时间复杂度：O(1)
返回值：REFCOUNT 和 IDLETIME 返回数字。ENCODING 返回相应的编码类型。

OBJECT 命令允许从内部察看给定 key 的 Redis 对象。

它通常用在除错(debugging)或者了解为了节省空间而对 key 使用特殊编码的情况。

当将Redis用作缓存程序时，你也可以通过 OBJECT 命令中的信息，决定 key 的驱逐策略(eviction policies)。

OBJECT 命令有多个子命令：

OBJECT REFCOUNT <key> 返回给定 key 引用所储存的值的次数。此命令主要用于除错。
OBJECT ENCODING <key> 返回给定 key 锁储存的值所使用的内部表示(representation)。
OBJECT IDLETIME <key> 返回给定 key 自储存以来的空转时间(idle，没有被读取也没有被写入)，以秒为单位。

对象可以以多种方式编码：

字符串可以被编码为 raw (一般字符串)或 int (用字符串表示64位数字是为了节约空间)。
列表可以被编码为 ziplist 或 linkedlist 。 ziplist 是为节约大小较小的列表空间而作的特殊表示。
集合可以被编码为 intset 或者 hashtable 。 intset 是只储存数字的小集合的特殊表示。
哈希表可以编码为 zipmap 或者 hashtable 。 zipmap 是小哈希表的特殊表示。
有序集合可以被编码为 ziplist 或者 skiplist 格式。 ziplist 用于表示小的有序集合，而 skiplist 则用于表示任何大小的有序集合。

假如你做了什么让 Redis 没办法再使用节省空间的编码时(比如将一个只有 1 个元素的集合扩展为一个有 100 万个元素的集合)，特殊编码类型(specially encoded types)会自动转换成通用类型(general type)。

TYPE

语法：TYPE key
功能：返回 key 所储存的值的类型。
可用版本：>= 1.0.0
时间复杂度：O(1)
返回值：none (key不存在)，string (字符串)，list (列表)，set (集合)，zset (有序集)，hash (哈希表)

SORT

SORT key [BY pattern] [LIMIT offset count] [GET pattern [GET pattern ...]] [ASC | DESC] [ALPHA] [STORE destination]

返回或保存给定列表、集合、有序集合 key 中经过排序的元素。

排序默认以数字作为对象，值被解释为双精度浮点数，然后进行比较。

一般 SORT 用法

最简单的 SORT 使用方法是 SORT key 和 SORT key DESC ：

SORT key 返回键值从小到大排序的结果。
SORT key DESC 返回键值从大到小排序的结果。

假设 today_cost 列表保存了今日的开销金额，那么可以用 SORT 命令对它进行排序：

SCAN

SCAN cursor [MATCH pattern] [COUNT count]

SCAN 命令及其相关的 SSCAN 命令、 HSCAN 命令和 ZSCAN 命令都用于增量地迭代（incrementally iterate）一集元素（a collection of elements）：

SCAN 命令用于迭代当前数据库中的数据库键。
SSCAN 命令用于迭代集合键中的元素。
HSCAN 命令用于迭代哈希键中的键值对。
ZSCAN 命令用于迭代有序集合中的元素（包括元素成员和元素分值）。

以上列出的四个命令都支持增量式迭代，它们每次执行都只会返回少量元素，所以这些命令可以用于生产环境，而不会出现像 KEYS 命令、 SMEMBERS 命令带来的问题 —— 当 KEYS 命令被用于处理一个大的数据库时，又或者 SMEMBERS 命令被用于处理一个大的集合键时，它们可能会阻塞服务器达数秒之久。

不过，增量式迭代命令也不是没有缺点的：举个例子，使用 SMEMBERS 命令可以返回集合键当前包含的所有元素，但是对于 SCAN 这类增量式迭代命令来说，因为在对键进行增量式迭代的过程中，键可能会被修改，所以增量式迭代命令只能对被返回的元素提供有限的保证（offer limited guarantees about the returned elements）。

因为 SCAN 、 SSCAN 、 HSCAN 和 ZSCAN 四个命令的工作方式都非常相似，所以这个文档会一并介绍这四个命令，但是要记住：

SSCAN 命令、 HSCAN 命令和 ZSCAN 命令的第一个参数总是一个数据库键。
而 SCAN 命令则不需要在第一个参数提供任何数据库键 —— 因为它迭代的是当前数据库中的所有数据库键。

SCAN 命令的基本用法

SCAN 命令是一个基于游标的迭代器（cursor based iterator）： SCAN 命令每次被调用之后，都会向用户返回一个新的游标，用户在下次迭代时需要使用这个新游标作为 SCAN 命令的游标参数，以此来延续之前的迭代过程。

当 SCAN 命令的游标参数被设置为 0 时，服务器将开始一次新的迭代，而当服务器向用户返回值为 0 的游标时，表示迭代已结束。

DUMP

语法：DUMP key
功能：序列化给定 key ，并返回被序列化的值。
可用版本：>= 2.6.0
时间复杂度：查找给定键的复杂度为 O(1) ，对键进行序列化的复杂度为 O(N*M) ，其中 N 是构成 key 的 Redis 对象的数量，而 M 则是这些对象的平均大小。
返回值：如果 key 不存在，那么返回 nil 。否则，返回序列化之后的值。

序列化生成的值有以下几个特点：

它带有 64 位的校验和，用于检测错误， RESTORE 在进行反序列化之前会先检查校验和。
值的编码格式和 RDB 文件保持一致。
RDB 版本会被编码在序列化值当中，如果因为 Redis 的版本不同造成 RDB 格式不兼容，那么 Redis 会拒绝对这个值进行反序列化操作。

序列化的值不包括任何生存时间信息。

RESTORE

语法：RESTORE key ttl serialized-value
功能：反序列化给定的序列化值，并将它和给定的 key 关联。
可用版本：>= 2.6.0
时间复杂度：查找给定键的复杂度为 O(1) ，对键进行反序列化的复杂度为 O(N*M) ，其中 N 是构成 key 的 Redis 对象的数量，而 M 则是这些对象的平均大小。
返回值：如果反序列化成功那么返回 OK ，否则返回一个错误。

说明：

参数 ttl 以毫秒为单位为 key 设置生存时间；如果 ttl 为 0 ，那么不设置生存时间。

RESTORE 在执行反序列化之前会先对序列化值的 RDB 版本和数据校验和进行检查，如果 RDB 版本不相同或者数据不完整的话，那么 RESTORE 会拒绝进行反序列化，并返回一个错误。

时间复杂度：

查找给定键的复杂度为 O(1) ，对键进行反序列化的复杂度为 O(N*M) ，其中 N 是构成 key 的 Redis 对象的数量，而 M 则是这些对象的平均大小。

有序集合(sorted set)的反序列化复杂度为 O(N*M*log(N)) ，因为有序集合每次插入的复杂度为 O(log(N)) 。

如果反序列化的对象是比较小的字符串，那么复杂度为 O(1) 。

示例：

RESTORE greeting-again 0 "\x00\x15hello, dumping world!\x06\x00E\xa0Z\x82\xd8r\xc1\xde"

MIGRATE

语法：MIGRATE host port key destination-db timeout [COPY] [REPLACE]
功能：将 key 原子性地从当前实例传送到目标实例的指定数据库上，一旦传送成功， key 保证会出现在目标实例上，而当前实例上的 key 会被删除。
可用版本：>= 2.6.0
时间复杂度：O(N)
返回值：迁移成功时返回 OK ，否则返回相应的错误。

这个命令是一个原子操作，它在执行的时候会阻塞进行迁移的两个实例，直到以下任意结果发生：迁移成功，迁移失败，等到超时。

命令的内部实现是这样的：它在当前实例对给定 key 执行 DUMP 命令，将它序列化，然后传送到目标实例，目标实例再使用 RESTORE 对数据进行反序列化，并将反序列化所得的数据添加到数据库中；当前实例就像目标实例的客户端那样，只要看到 RESTORE 命令返回 OK ，它就会调用 DEL 删除自己数据库上的 key 。

timeout 参数以毫秒为格式，指定当前实例和目标实例进行沟通的最大间隔时间。这说明操作并不一定要在 timeout 毫秒内完成，只是说数据传送的时间不能超过这个 timeout 数。

MIGRATE 命令需要在给定的时间规定内完成 IO 操作。如果在传送数据时发生 IO 错误，或者达到了超时时间，那么命令会停止执行，并返回一个特殊的错误： IOERR 。

当 IOERR 出现时，有以下两种可能：

key 可能存在于两个实例
key 可能只存在于当前实例

唯一不可能发生的情况就是丢失 key ，因此，如果一个客户端执行 MIGRATE 命令，并且不幸遇上 IOERR 错误，那么这个客户端唯一要做的就是检查自己数据库上的 key 是否已经被正确地删除。

如果有其他错误发生，那么 MIGRATE 保证 key 只会出现在当前实例中。（当然，目标实例的给定数据库上可能有和 key 同名的键，不过这和 MIGRATE 命令没有关系）。

可选项：

COPY ：不移除源实例上的 key 。
REPLACE ：替换目标实例上已存在的 key 。

时间复杂度：

这个命令在源实例上实际执行 DUMP 命令和 DEL 命令，在目标实例执行 RESTORE 命令，查看以上命令的文档可以看到详细的复杂度说明。

key 数据在两个实例之间传输的复杂度为 O(N) 。