Redis 键值对

1. 介绍¶

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

1.1 语法¶

COMMAND KEY_NAME

1.2 命令¶

Redis keys 命令

序号	命令	描述
1	del key	该命令用于在 key 存在时删除 key
2	dump key	序列化给定 key ，并返回被序列化的值
3	EXISTS key	检查给定 key 是否存在。
4	EXPIRE key seconds	为给定 key 设置过期时间，以秒计
5	EXPIREAT key timestamp	EXPIREAT 的作用和 EXPIRE 类似，都用于为 key 设置过期时间。不同在于 EXPIREAT 命令接受的时间参数是 UNIX 时间戳(unix timestamp)。
6	PEXPIRE key milliseconds	设置 key 的过期时间以毫秒计。
7	PEXPIREAT key milliseconds-timestamp	设置 key 过期时间的时间戳(unix timestamp) 以毫秒计
8	KEYS pattern	查找所有符合给定模式( pattern)的 key 。
9	MOVE key db	将当前数据库的 key 移动到给定的数据库 db 当中。
10	PERSIST key	移除 key 的过期时间，key 将持久保持。
11	PTTL key	以毫秒为单位返回 key 的剩余的过期时间。
12	TTL key	以秒为单位，返回给定 key 的剩余生存时间(TTL, time to live)。
13	RANDOMKEY	从当前数据库中随机返回一个 key 。
14	RENAME key newkey	修改 key 的名称
15	RENAMENX key newkey	仅当 newkey 不存在时，将 key 改名为 newkey 。
16	TYPE key	返回 key 所储存的值的类型。

1.3 实例¶

root@manage01:/home/loocha# redis-cli
127.0.0.1:6379> AUTH cmz
OK
127.0.0.1:6379> keys *     # 查看所有key
1) "k1"
127.0.0.1:6379> set k2 v2
(error) NOAUTH Authentication required.
127.0.0.1:6379> auth cmz   # 认证
OK
127.0.0.1:6379> keys *
1) "k1"
127.0.0.1:6379> del k1    # 删除k1
(integer) 1
127.0.0.1:6379> keys *
(empty list or set)
127.0.0.1:6379> set k1 v1
OK
127.0.0.1:6379> get v1
(nil)
127.0.0.1:6379> DUMP k1
"\x00\x02v1\t\x00\x8f\x17\xe1\x92\x9f\xd6\x1a\xea"
127.0.0.1:6379> EXISTS k1   # 判断k1是否存在
(integer) 1  
127.0.0.1:6379> EXISTS k12
(integer) 0
127.0.0.1:6379> EXPIRE k1 10
(integer) 1
127.0.0.1:6379> keys *
1) "k1"

# 等待十秒
127.0.0.1:6379> keys *
(empty list or set)
127.0.0.1:6379> set k1 v1
OK
127.0.0.1:6379> EXPIRE k1 100
(integer) 1
127.0.0.1:6379> TTL k1
(integer) 95
127.0.0.1:6379> RANDOMKEY
"k1"
127.0.0.1:6379> set k2 v2
OK
127.0.0.1:6379> set 3 v3
OK
127.0.0.1:6379> RANDOMKEY
"3"
127.0.0.1:6379> RANDOMKEY
"k1"
127.0.0.1:6379> RANDOMKEY
"k2"
127.0.0.1:6379> mv 3 k3
(error) ERR unknown command `mv`, with args beginning with: `3`, `k3`,
127.0.0.1:6379> keys *
1) "3"
2) "k2"
3) "k1"

2. 字符串(String)¶

2.1 语法¶

Redis 字符串数据类型的相关命令用于管理 redis 字符串值，基本语法如下：

COMMAND KEY_NAME

2.2 命令¶

Redis 字符串命令

序号	命令	描述
1	SET key value	设置指定 key 的值
2	GET key	获取指定 key 的值。
3	GETRANGE key start end	返回 key 中字符串值的子字符
4	GETSET key value	将给定 key 的值设为 value ，并返回 key 的旧值(old value)。
5	GETBIT key offset	对 key 所储存的字符串值，获取指定偏移量上的位(bit)。
6	MGET key1 [key2..]	获取所有(一个或多个)给定 key 的值。
7	SETBIT key offset value	对 key 所储存的字符串值，设置或清除指定偏移量上的位(bit)。
8	SETEX key seconds value	将值 value 关联到 key ，并将 key 的过期时间设为 seconds (以秒为单位)。
9	SETNX key value	只有在 key 不存在时设置 key 的值。
10	SETRANGE key offset value	用 value 参数覆写给定 key 所储存的字符串值，从偏移量 offset 开始。
11	STRLEN key	返回 key 所储存的字符串值的长度。
12	MSET key value [key value ...]	同时设置一个或多个 key-value 对。
13	MSETNX key value [key value ...]	同时设置一个或多个 key-value 对，当且仅当所有给定 key 都不存在。
14	PSETEX key milliseconds value	这个命令和 SETEX 命令相似，但它以毫秒为单位设置 key 的生存时间，而不是像 SETEX 命令那样，以秒为单位。
15	INCR key	将 key 中储存的数字值增一。
16	INCRBY key increment	将 key 所储存的值加上给定的增量值（increment）。
17	INCRBYFLOAT key increment	将 key 所储存的值加上给定的浮点增量值（increment）。
18	DECR key	将 key 中储存的数字值减一。
19	DECRBY key decrement	key 所储存的值减去给定的减量值（decrement）。
20	APPEND key value	如果 key 已经存在并且是一个字符串， APPEND 命令将指定的 value 追加到该 key 原来值（value）的末尾。

2.3 实例¶

127.0.0.1:6379> FLUSHALL
OK
127.0.0.1:6379> keys *
(empty list or set)
127.0.0.1:6379> set name cmz
OK
127.0.0.1:6379> set age 10
OK
127.0.0.1:6379> set sex male
OK
127.0.0.1:6379> keys *
1) "sex"
2) "age"
3) "name"
127.0.0.1:6379> type sex
string
127.0.0.1:6379> type name
string
127.0.0.1:6379> type age
string
127.0.0.1:6379> MGET name age sex
1) "cmz"
2) "10"
3) "male"
127.0.0.1:6379> mset k1 v1 k2 v2
OK
127.0.0.1:6379> keys *
1) "age"
2) "k1"
3) "sex"
4) "name"
5) "k2"
127.0.0.1:6379> get age
"10"
127.0.0.1:6379> INCR age
(integer) 11
127.0.0.1:6379> get age
"11"
127.0.0.1:6379> DECR age
(integer) 10
127.0.0.1:6379> get age
"10"
127.0.0.1:6379> get name
"cmz"
127.0.0.1:6379> APPEND name _caimengzhi
(integer) 14
127.0.0.1:6379> get name
"cmz_caimengzhi"

3. 哈希(Hash)¶

Redis hash 是一个string类型的field和value的映射表，hash特别适合用于存储对象。Redis 中每个 hash 可以存储 232 - 1 键值对（40多亿）。

3.1 语法¶

COMMAND KEY_NAME

3.2 命令¶

序号	命令	描述
1	HDEL key field1 [field2]	删除一个或多个哈希表字段
2	HEXISTS key field	查看哈希表 key 中，指定的字段是否存在。
3	HGET key field	获取存储在哈希表中指定字段的值。
4	HGETALL key	获取在哈希表中指定 key 的所有字段和值
5	HINCRBY key field increment	为哈希表 key 中的指定字段的整数值加上增量 increment 。
6	HINCRBYFLOAT key field increment	为哈希表 key 中的指定字段的浮点数值加上增量 increment 。
7	HKEYS key	获取所有哈希表中的字段
8	HLEN key	获取哈希表中字段的数量
9	HMGET key field1 [field2]	获取所有给定字段的值
10	HMSET key field1 value1 [field2 value2 ]	同时将多个 field-value (域-值)对设置到哈希表 key 中。
11	HSET key field value	将哈希表 key 中的字段 field 的值设为 value 。
12	HSETNX key field value	只有在字段 field 不存在时，设置哈希表字段的值。
13	HVALS key	获取哈希表中所有值
14	HSCAN key cursor [MATCH pattern] [COUNT count]	迭代哈希表中的键值对。

3.3 实例¶

127.0.0.1:6379> select 1
OK
127.0.0.1:6379[1]> keys *
(empty list or set)
127.0.0.1:6379[1]> HMSET cmz name caimengzhi age 30 description "I love python."
OK
127.0.0.1:6379[1]> keys *
1) "cmz"
127.0.0.1:6379[1]> HGETALL cmz
1) "name"
2) "caimengzhi"
3) "age"
4) "30"
5) "description"
6) "I love python."
127.0.0.1:6379[1]> hget cmz name
"caimengzhi"
127.0.0.1:6379[1]> hget cmz age
"30"
127.0.0.1:6379[1]> hget cmz description
"I love python."

127.0.0.1:6379[1]> HKEYS cmz
1) "name"
2) "age"
3) "description"

127.0.0.1:6379[1]> HLEN cmz
(integer) 3

127.0.0.1:6379[1]> hset cmz age 32
(integer) 0
127.0.0.1:6379[1]> hget cmz age
"32"


127.0.0.1:6379[1]> HDEL cmz age
(integer) 1
127.0.0.1:6379[1]> HGETALL cmz
1) "name"
2) "caimengzhi"
3) "description"
4) "I love python.

4. 列表(List)¶

Redis列表是简单的字符串列表，按照插入顺序排序。你可以添加一个元素到列表的头部（左边）或者尾部（右边），一个列表最多可以包含 232 - 1 个元素 (4294967295, 每个列表超过40亿个元素)。

4.1 语法¶

COMMAND KEY_NAME

4.2 命令¶

序号	命令	描述
1	BLPOP key1 [key2 ] timeout	移出并获取列表的第一个元素，如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
2	BRPOP key1 [key2 ] timeout	移出并获取列表的最后一个元素，如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
3	BRPOPLPUSH source destination timeout	从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它；如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
4	LINDEX key index	通过索引获取列表中的元素
5	LINSERT key BEFORE\|AFTER pivot value	在列表的元素前或者后插入元素
6	LLEN key	获取列表长度
7	LPOP key	移出并获取列表的第一个元素
8	LPUSH key value1 [value2]	将一个或多个值插入到列表头部
9	LPUSHX key value	将一个值插入到已存在的列表头部
10	LRANGE key start stop	获取列表指定范围内的元素
11	LREM key count value	移除列表元素
12	LSET key index value	通过索引设置列表元素的值
13	LTRIM key start stop	对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。
14	RPOP key	移除列表的最后一个元素，返回值为移除的元素。
15	RPOPLPUSH source destination	移除列表的最后一个元素，并将该元素添加到另一个列表并返回
16	RPUSH key value1 [value2]	在列表中添加一个或多个值
17	RPUSHX key value	为已存在的列表添加值

4.3 实例¶

127.0.0.1:6379[1]> select 2
OK
127.0.0.1:6379[2]> keys *
(empty list or set)
127.0.0.1:6379[2]> LPUSH caimengzhi 185cm 80kg it nanjing
(integer) 4
127.0.0.1:6379[2]> keys *
1) "caimengzhi"
127.0.0.1:6379[2]> type caimengzhi
list
127.0.0.1:6379[2]> LRANGE caimengzhi 0 -1
1) "nanjing"
2) "it"
3) "80kg"
4) "185cm"

127.0.0.1:6379[2]> LINDEX caimengzhi 0
"nanjing"
127.0.0.1:6379[2]> LINDEX caimengzhi 1
"it"
127.0.0.1:6379[2]> LINDEX caimengzhi 2
"80kg"
127.0.0.1:6379[2]> LINDEX caimengzhi 3
"185cm"

127.0.0.1:6379[2]> LLEN caimengzhi
(integer) 4
127.0.0.1:6379[2]> LPOP caimengzhi
"nanjing"

127.0.0.1:6379[2]> LRANGE caimengzhi 0 -1
1) "it"
2) "80kg"
3) "185cm"
127.0.0.1:6379[2]> LPUSHX caimengzhi name cmz
(integer) 5
127.0.0.1:6379[2]> LRANGE caimengzhi 0 -1
1) "cmz"
2) "name"
3) "it"
4) "80kg"
5) "185cm"

5. 集合(Set)¶

Redis 的 Set 是 String 类型的无序集合。集合成员是唯一的，这就意味着集合中不能出现重复的数据。
Redis 中集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是 O(1)。
集合中最大的成员数为 232 - 1 (4294967295, 每个集合可存储40多亿个成员)。

5.1 语法¶

COMMAND KEY_NAME

5.2 命令¶

序号	命令	描述
1	SADD key member1 [member2]	向集合添加一个或多个成员
2	SCARD key	获取集合的成员数
3	SDIFF key1 [key2]	返回给定所有集合的差集
4	SDIFFSTORE destination key1 [key2]	返回给定所有集合的差集并存储在 destination 中
5	SINTER key1 [key2]	返回给定所有集合的交集
6	SINTERSTORE destination key1 [key2]	返回给定所有集合的交集并存储在 destination 中
7	SISMEMBER key member	判断 member 元素是否是集合 key 的成员
8	SMEMBERS key	返回集合中的所有成员
9	SMOVE source destination member	将 member 元素从 source 集合移动到 destination 集合
10	SPOP key	移除并返回集合中的一个随机元素
11	SRANDMEMBER key [count]	返回集合中一个或多个随机数
12	SREM key member1 [member2]	移除集合中一个或多个成员
13	SUNION key1 [key2]	返回所有给定集合的并集
14	SUNIONSTORE destination key1 [key2]	所有给定集合的并集存储在 destination 集合中
15	SSCAN key cursor [MATCH pattern] [COUNT count]	迭代集合中的元素

5.3 实例¶

127.0.0.1:6379[2]> select 4
OK
127.0.0.1:6379[4]> keys *
(empty list or set)
127.0.0.1:6379[4]> SADD nosql redis
(integer) 1
127.0.0.1:6379[4]> SADD nosql mongodb memecache
(integer) 2
127.0.0.1:6379[4]> keys *
1) "nosql"
127.0.0.1:6379[4]> SCARD nosql
(integer) 3
127.0.0.1:6379[4]> SMEMBERS nosql
1) "redis"
2) "mongodb"
3) "memecache"
127.0.0.1:6379[4]> SPOP nosql
"mongodb"
127.0.0.1:6379[4]> SMEMBERS nosql
1) "redis"
2) "memecache"

6. 有序集合(sorted set)¶

Redis 有序集合和集合一样也是string类型元素的集合,且不允许重复的成员。不同的是每个元素都会关联一个double类型的分数。redis正是通过分数来为集合中的成员进行从小到大的排序。有序集合的成员是唯一的,但分数(score)却可以重复。

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

6.1 语法¶

COMMAND KEY_NAME

6.2 命令¶

序号	命令	描述
1	ZADD key score1 member1 [score2 member2]	向有序集合添加一个或多个成员，或者更新已存在成员的分数
2	ZCARD key	获取有序集合的成员数
3	ZCOUNT key min max	计算在有序集合中指定区间分数的成员数
4	ZINCRBY key increment member	有序集合中对指定成员的分数加上增量 increment
5	ZINTERSTORE destination numkeys key [key ...]	计算给定的一个或多个有序集的交集并将结果集存储在新的有序集合 key 中
6	ZLEXCOUNT key min max	在有序集合中计算指定字典区间内成员数量
7	ZRANGE key start stop [WITHSCORES]	通过索引区间返回有序集合成指定区间内的成员
8	ZRANGEBYLEX key min max [LIMIT offset count]	通过字典区间返回有序集合的成员
9	ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT]	通过分数返回有序集合指定区间内的成员
10	ZRANK key member	返回有序集合中指定成员的索引
11	ZREM key member [member ...]	移除有序集合中的一个或多个成员
12	ZREMRANGEBYLEX key min max	移除有序集合中给定的字典区间的所有成员
13	ZREMRANGEBYRANK key start stop	移除有序集合中给定的排名区间的所有成员
14	ZREMRANGEBYSCORE key min max	移除有序集合中给定的分数区间的所有成员
15	ZREVRANGE key start stop [WITHSCORES]	返回有序集中指定区间内的成员，通过索引，分数从高到底
16	ZREVRANGEBYSCORE key max min [WITHSCORES]	返回有序集中指定分数区间内的成员，分数从高到低排序
17	ZREVRANK key member	返回有序集合中指定成员的排名，有序集成员按分数值递减(从大到小)排序
18	ZSCORE key member	返回有序集中，成员的分数值
19	ZUNIONSTORE destination numkeys key [key ...]	计算给定的一个或多个有序集的并集，并存储在新的 key 中
20	ZSCAN key cursor [MATCH pattern] [COUNT count]	迭代有序集合中的元素（包括元素成员和元素分值）

6.3 实例¶

127.0.0.1:6379[4]> select 5
OK
127.0.0.1:6379[5]> zadd city 1 beijing
(integer) 1
127.0.0.1:6379[5]> zadd city 2 nanjing
(integer) 1
127.0.0.1:6379[5]> zadd city 3 shanghai
(integer) 1
127.0.0.1:6379[5]> zadd city 4 suqian
(integer) 1
127.0.0.1:6379[5]> keys *
1) "city"
127.0.0.1:6379[5]> ZRANGE city 0 -1
1) "beijing"
2) "nanjing"
3) "shanghai"
4) "suqian"