Redis 常用命令

Redis 命令用于在 redis 服务上执行操作。

要在 redis 服务上执行命令需要一个 redis 客户端。Redis 客户端在我们之前下载的的 redis 的安装包中。

键(key)

Redis 键命令用于管理 redis 的键。

命令	注解	返回值
DEL key	该命令用于在 key 存在时删除 key。	被删除 key 的数量。
DUMP key	序列化给定 key ，并返回被序列化的值。	如果 key 不存在，那么返回 nil 。 否则，返回序列化之后的值。
EXISTS key	检查给定 key 是否存在。	若 key 存在返回 1 ，否则返回 0 。
EXPIRE key seconds	为给定 key 设置过期时间。	设置成功返回 1 。 当 key 不存在或者不能为 key 设置过期时间时(比如在低于 2.1.3 版本的 Redis 中你尝试更新 key 的过期时间)返回 0 。
EXPIREAT key timestamp	EXPIREAT 的作用和 EXPIRE 类似，都用于为 key 设置过期时间。 不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。	同上
PEXPIRE key milliseconds	设置 key 的过期时间以毫秒计。	同上
PEXPIREAT key milliseconds-timestamp	设置 key 过期时间的时间戳(unix timestamp) 以毫秒计	同上
KEYS pattern	查找所有符合给定模式( pattern)的 key	同上
MOVE key db	将当前数据库的 key 移动到给定的数据库 db 当中。	移动成功返回 1 ，失败则返回 0
PERSIST key	移除 key 的过期时间，key 将持久保持。	当过期时间移除成功时，返回 1 。 如果 key 不存在或 key 没有设置过期时间，返回 0 。
PTTL key	以毫秒为单位返回 key 的剩余的过期时间。	当 key 不存在时，返回 -2 。 当 key 存在但没有设置剩余生存时间时，返回 -1 。 否则，以毫秒为单位，返回 key 的剩余生存时间。
TTL key	以秒为单位，返回给定 key 的剩余生存时间(TTL, time to live)。	同上
RANDOMKEY	从当前数据库中随机返回一个 key 。	当数据库不为空时，返回一个 key 。 当数据库为空时，返回 nil 。
RENAME key newkey	修改 key 的名称	改名成功时提示 OK ，失败时候返回一个错误。当 OLD_KEY_NAME 和 NEW_KEY_NAME 相同，或者 OLD_KEY_NAME 不存在时，返回一个错误。 当 NEW_KEY_NAME 已经存在时， RENAME 命令将覆盖旧值。
RENAMENX key newkey	仅当 newkey 不存在时，将 key 改名为 newkey 。	修改成功时，返回 1 。 如果 NEW_KEY_NAME 已经存在，返回 0 。
TYPE key	返回 key 所储存的值的类型。	返回 key 的数据类型，数据类型有： none (key不存在) string (字符串) list (列表) set (集合) zset (有序集) hash (哈希表)

字符串(String)

Redis 字符串数据类型的相关命令用于管理 redis 字符串值

命令	注解	返回值
SET key value	设置指定 key 的值	在 Redis 2.6.12 以前版本， SET 命令总是返回 OK 。 从 Redis 2.6.12 版本开始， SET 在设置操作成功完成时，才返回 OK 。
GET key	获取指定 key 的值。	设置指定 key 的值
GETRANGE key start end	返回 key 中字符串值的子字符	截取得到的子字符串。
GETSET key value	将给定 key 的值设为 value ，并返回 key 的旧值(old value)。	字符串值指定偏移量上的位(bit)。 当偏移量 OFFSET 比字符串值的长度大，或者 key 不存在时，返回 0 。
GETBIT key offset	对 key 所储存的字符串值，获取指定偏移量上的位(bit)。	同上
MGET key1 [key2..]	获取所有(一个或多个)给定 key 的值。	一个包含所有给定 key 的值的列表。
SETBIT key offset value	对 key 所储存的字符串值，设置或清除指定偏移量上的位(bit)。	指定偏移量原来储存的位。
SETEX key seconds value	将值 value 关联到 key ，并将 key 的过期时间设为 seconds (以秒为单位)。	设置成功时返回 OK 。
SETNX key value	只有在 key 不存在时设置 key 的值。	设置成功，返回 1 。 设置失败，返回 0 。
SETRANGE key offset value	用 value 参数覆写给定 key 所储存的字符串值，从偏移量 offset 开始。	被修改后的字符串长度。
STRLEN key	返回 key 所储存的字符串值的长度。	字符串值的长度。 当 key 不存在时，返回 0。
MSET key value [key value …]	同时设置一个或多个 key-value 对。	总是返回 OK 。
MSETNX key value [key value …]	同时设置一个或多个 key-value 对，当且仅当所有给定 key 都不存在。	当所有 key 都成功设置，返回 1 。 如果所有给定 key 都设置失败(至少有一个 key 已经存在)，那么返回 0 。
PSETEX key milliseconds value	这个命令和 SETEX 命令相似，但它以毫秒为单位设置 key 的生存时间，而不是像 SETEX 命令那样，以秒为单位。	设置成功时返回 OK 。
INCR key	将 key 中储存的数字值增一。	执行 INCR 命令之后 key 的值。
INCRBY key increment	将 key 所储存的值加上给定的增量值（increment） 。	加上指定的增量值之后， key 的值。
INCRBYFLOAT key increment	将 key 所储存的值加上给定的浮点增量值（increment） 。	执行命令之后 key 的值。
DECR key	将 key 中储存的数字值减一。	执行命令之后 key 的值。
DECRBY key decrement	key 所储存的值减去给定的减量值（decrement） 。	减去指定减量值之后， key 的值。
APPEND key value	如果 key 已经存在并且是一个字符串， APPEND 命令将 value 追加到 key 原来的值的末尾。	追加指定值之后， key 中字符串的长度。

哈希(Hash)

Redis hash 是一个string类型的field和value的映射表，hash特别适合用于存储对象。

Redis 中每个 hash 可以存储 232 - 1 键值对（40多亿）。

命令	注解	返回值
HDEL key field2 [field2]	删除一个或多个哈希表字段	被成功删除字段的数量，不包括被忽略的字段。
HEXISTS key field	查看哈希表 key 中，指定的字段是否存在。	如果哈希表含有给定字段，返回 1 。 如果哈希表不含有给定字段，或 key 不存在，返回 0 。
HGET key field	获取存储在哈希表中指定字段的值。	返回给定字段的值。如果给定的字段或 key 不存在时，返回 nil 。
HGETALL key	获取在哈希表中指定 key 的所有字段和值	以列表形式返回哈希表的字段及字段值。 若 key 不存在，返回空列表。
HINCRBY key field increment	为哈希表 key 中的指定字段的整数值加上增量 increment 。	执行 HINCRBY 命令之后，哈希表中字段的值。
HINCRBYFLOAT key field increment	为哈希表 key 中的指定字段的浮点数值加上增量 increment 。	执行 Hincrbyfloat 命令之后，哈希表中字段的值。
HKEYS key	获取所有哈希表中的字段	包含哈希表中所有字段的列表。 当 key 不存在时，返回一个空列表。
HLEN key	获取哈希表中字段的数量	哈希表中字段的数量。 当 key 不存在时，返回 0 。
HMGET key field1 [field2]	获取所有给定字段的值	一个包含多个给定字段关联值的表，表值的排列顺序和指定字段的请求顺序一样。
HMSET key field1 value1 [field2 value2 ]	同时将多个 field-value (域-值)对设置到哈希表 key 中。	如果命令执行成功，返回 OK 。
HSET key field value	将哈希表 key 中的字段 field 的值设为 value 。	如果字段是哈希表中的一个新建字段，并且值设置成功，返回 1 。 如果哈希表中域字段已经存在且旧值已被新值覆盖，返回 0 。
HSETNX key field value	只有在字段 field 不存在时，设置哈希表字段的值。	设置成功，返回 1 。 如果给定字段已经存在且没有操作被执行，返回 0 。
HVALS key	获取哈希表中所有值	一个包含哈希表中所有值的表。 当 key 不存在时，返回一个空表。
HSCAN key cursor [MATCH pattern] [COUNT count]	迭代哈希表中的键值对。	迭代哈希表中的键值对。 当 key 不存在时，返回一个空表。

列表(List)

Redis列表是简单的字符串列表，按照插入顺序排序。你可以添加一个元素导列表的头部（左边）或者尾部（右边）

一个列表最多可以包含 232 - 1 个元素 (4294967295, 每个列表超过40亿个元素)。

命令	注解	返回值
BLPOP key1 [key2 ] timeout	移出并获取列表的第一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。	如果列表为空，返回一个 nil 。 否则，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。
BRPOP key1 [key2 ] timeout	移出并获取列表的最后一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。	假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。 反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。
BRPOPLPUSH source destination timeout	从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它； 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。	假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。 反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。
LINDEX key index	通过索引获取列表中的元素	列表中下标为指定索引值的元素。 如果指定索引值不在列表的区间范围内，返回 nil 。
LINSERT key BEFORE/AFTER pivot value	在列表的元素前或者后插入元素	如果命令执行成功，返回插入操作完成之后，列表的长度。 如果没有找到指定元素 ，返回 -1 。 如果 key 不存在或为空列表，返回 0 。
LLEN key	获取列表长度	列表的长度。
LPOP key	移出并获取列表的第一个元素	列表的第一个元素。 当列表 key 不存在时，返回 nil 。
LPUSH key value1 [value2]	将一个或多个值插入到列表头部	执行 LPUSH 命令后，列表的长度。
LPUSHX key value	将一个或多个值插入到已存在的列表头部	LPUSHX 命令执行之后，列表的长度。
LRANGE key start stop	获取列表指定范围内的元素	一个列表，包含指定区间内的元素。
LREM key count value	移除列表元素	被移除元素的数量。 列表不存在时返回 0 。
LSET key index value	通过索引设置列表元素的值	操作成功返回 ok ，否则返回错误信息。
LTRIM key start stop	对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。	命令执行成功时，返回 ok 。
RPOP key	移除并获取列表最后一个元素	列表的最后一个元素。 当列表不存在时，返回 nil 。
RPOPLPUSH source destination	移除列表的最后一个元素，并将该元素添加到另一个列表并返回	被弹出的元素。
RPUSH key value1 [value2]	在列表中添加一个或多个值	执行 RPUSH 操作后，列表的长度。
RPUSHX key value	为已存在的列表添加值	执行 Rpushx 操作后，列表的长度。

集合(Set)

Redis的Set是string类型的无序集合。集合成员是唯一的，这就意味着集合中不能出现重复的数据。

Redis 中 集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是O(1)。

集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。

命令	注解	返回值
SADD key member1 [member2]	向集合添加一个或多个成员	被添加到集合中的新元素的数量，不包括被忽略的元素。
SCARD key	获取集合的成员数	集合的数量。 当集合 key 不存在时，返回 0 。
SDIFF key1 [key2]	返回给定所有集合的差集	包含差集成员的列表。
SDIFFSTORE destination key1 [key2]	返回给定所有集合的差集并存储在 destination 中	结果集中的元素数量。
SINTER key1 [key2]	返回给定所有集合的交集	交集成员的列表。
SINTERSTORE destination key1 [key2]	返回给定所有集合的交集并存储在 destination 中	交集成员的列表。
SISMEMBER key member	判断 member 元素是否是集合 key 的成员	如果成员元素是集合的成员，返回 1 。 如果成员元素不是集合的成员，或 key 不存在，返回 0 。
SMEMBERS key	返回集合中的所有成员	集合中的所有成员。
SMOVE source destination member	将 member 元素从 source 集合移动到 destination 集合	如果成员元素被成功移除，返回 1 。 如果成员元素不是 source 集合的成员，并且没有任何操作对 destination 集合执行，那么返回 0 。
SPOP key	移除并返回集合中的一个随机元素	被移除的随机元素。 当集合不存在或是空集时，返回 nil 。
SRANDMEMBER key [count]	返回集合中一个或多个随机数	只提供集合 key 参数时，返回一个元素；如果集合为空，返回 nil 。 如果提供了 count 参数，那么返回一个数组；如果集合为空，返回空数组。
SREM key member1 [member2]	移除集合中一个或多个成员	被成功移除的元素的数量，不包括被忽略的元素。
SUNION key1 [key2]	返回所有给定集合的并集	并集成员的列表。
SUNIONSTORE destination key1 [key2]	所有给定集合的并集存储在 destination 集合中	结果集中的元素数量。
SSCAN key cursor [MATCH pattern] [COUNT count]	迭代集合中的元素	数组列表。

有序集合(sorted set)

Redis 有序集合和集合一样也是string类型元素的集合,且不允许重复的成员。

不同的是每个元素都会关联一个double类型的分数。redis正是通过分数来为集合中的成员进行从小到大的排序。

有序集合的成员是唯一的,但分数(score)却可以重复。

集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是O(1)。 集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。

命令	注解	返回值
ZADD key score1 member1 [score2 member2]	向有序集合添加一个或多个成员，或者更新已存在成员的分数	被成功添加的新成员的数量，不包括那些被更新的、已经存在的成员。
ZCARD key	获取有序集合的成员数	当 key 存在且是有序集类型时，返回有序集的基数。 当 key 不存在时，返回 0 。
ZCOUNT key min max	计算在有序集合中指定区间分数的成员数	分数值在 min 和 max 之间的成员的数量。
ZINCRBY key increment member	有序集合中对指定成员的分数加上增量 increment	member 成员的新分数值，以字符串形式表示。
ZINTERSTORE destination numkeys key [key …]	计算给定的一个或多个有序集的交集并将结果集存储在新的有序集合 key 中	保存到目标结果集的的成员数量。
ZLEXCOUNT key min max	在有序集合中计算指定字典区间内成员数量	指定区间内的成员数量。
ZRANGE key start stop [WITHSCORES]	通过索引区间返回有序集合成指定区间内的成员	指定区间内，带有分数值(可选)的有序集成员的列表。
ZRANGEBYLEX key min max [LIMIT offset count]	通过字典区间返回有序集合的成员	指定区间内的元素列表。
ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT]	通过分数返回有序集合指定区间内的成员	指定区间内，带有分数值(可选)的有序集成员的列表。
ZRANK key member	返回有序集合中指定成员的索引	如果成员是有序集 key 的成员，返回 member 的排名。 如果成员不是有序集 key 的成员，返回 nil 。
ZREM key member [member …]	移除有序集合中的一个或多个成员	被成功移除的成员的数量，不包括被忽略的成员。
ZREMRANGEBYLEX key min max	移除有序集合中给定的字典区间的所有成员	被成功移除的成员的数量，不包括被忽略的成员。
ZREMRANGEBYRANK key start stop	移除有序集合中给定的排名区间的所有成员	被移除成员的数量。
ZREMRANGEBYSCORE key min max	移除有序集合中给定的分数区间的所有成员	被移除成员的数量。
ZREVRANGE key start stop [WITHSCORES]	返回有序集中指定区间内的成员，通过索引，分数从高到底	指定区间内，带有分数值(可选)的有序集成员的列表。
ZREVRANGEBYSCORE key max min [WITHSCORES]	返回有序集中指定分数区间内的成员，分数从高到低排序	指定区间内，带有分数值(可选)的有序集成员的列表。
ZREVRANK key member	返回有序集合中指定成员的排名，有序集成员按分数值递减(从大到小)排序	如果成员是有序集 key 的成员，返回成员的排名。 如果成员不是有序集 key 的成员，返回 nil 。
ZSCORE key member	返回有序集中，成员的分数值	成员的分数值，以字符串形式表示。
ZUNIONSTORE destination numkeys key [key …]	计算给定的一个或多个有序集的并集，并存储在新的 key 中	保存到 destination 的结果集的成员数量。
ZSCAN key cursor [MATCH pattern] [COUNT count]	迭代有序集合中的元素（包括元素成员和元素分值）	返回的每个元素都是一个有序集合元素，一个有序集合元素由一个成员（member）和一个分值（score）组成。

参考资料

Redis中文官方网站 : http://www.redis.cn/

Redis 菜鸟教程 ： http://www.runoob.com/redis/redis-tutorial.html

Redis 命令参考 : http://doc.redisfans.com/