字符串
Redis的字符串就是一个由字节组成的序列,在Redis里面,字符串可以存储以下3中类型的值:
- 字节串(byte string)
- 整数
- 浮点数
自增自减操作
Redis对字符串执行自增和自减的命令:
命令 | 用例和描述 |
---|---|
INCR | INCR key-name ———将键存储的值加1 |
DECR | DECR key-name ———将键存储的值减去1 |
INCRBY | INCRBY key-name amount ——-将键存储的值加上整数amount |
DECRBY | DECRBY key-name amount ——-将键存储的值减去整数amount |
INCRBYFLOAT | INCRBYFLOAT key-name amount ——-将键存储的值加上浮点数amount,redis2.6及以上可用 |
注意:
- 当存储在redis字符串里面的值可以被解释(interpret)为十进制整数或者浮点数时,redis允许用户对这个字符串执行各种INCR和DECR操作;
- 当用户对一个不存在的键或者保存了空串的键执行自增或者自减操作,则redis会将这个键当作0来处理;
- 当用户尝试对一个值无法解释为整数或者浮点数的字符串键执行自增或者自减操作,则redis会返回一个错误。
Redis的INCR和DECR操作示例:
1 | Jedis conn = new Jedis("localhost"); |
Redis对字符串进行读取和写入操作
Redis处理子串和二进制位的命令:
命令 | 用例和描述 |
---|---|
APPEND | APPEND key-name value —将值value追加到给定键key-name当前存储的值的末尾 |
GETRANGE | GETRANGE key-name start end —获取一个由偏移量start至end范围内的子串,包含start和end在内 |
SETRANGE | SETRANGE key-name offset value —将从offset偏移量开始的子串设置为给定值 |
GETBIT | GETBIT key-name offset — 将字节串看作是二进制位串(bit string),并返回位串中偏移量为offset的二进制位的值 |
SETBIT | SETBIT key-name offset value — 将字节串看作是二进制位串,并将位串中偏移量为offset的二进制位的值设置为value |
BITCOUNT | BITCOUNT key-name [start end] — 统计二进制位串中值为1的二进制位的数量 |
BITOP | BITOP operation dest-key key-name [key-name …] — 对一个或多个二进制位串执行包括并(AND)、或(OR)、异或(XOR)、非(NOT)在内的任意一种按位运算操作(bitwise operation),并将计算得出的结果保存在dest-key键里面 |
注意:
- redis现在的GETRANGE命令是由以前的SUBSTR命令改写而来的,因此,Python现在仍然可以使用substr()方法来获取子串;
- 在使用SETRANGE或者SETBIT命令对字符串进行写入的时候,如果字符串当前的长度不能满足写入的要求,那么redis会自动地使用空字节null来将字符串扩展至所需的长度,然后才执行写入或者更新操作。
- 在使用GETRANGE读取字符串的时候,超出字符串末尾的数据会被视为是空串,而在使用GETBIT读取二进制位串的时候,超出字符串末尾的二进制位会被视为是0。
Redis的子串操作和二进制位操作示例:
1 | //将'hello'追加到目前并不存在的'new-string-key'键里 |
Redis通过使用子串操作和二进制位操作,配合WATCH命令、MULTI命令和EXEC命令,用户可以自己动手去构建任何他们想要的数据结构。
列表
列表是由多个字符串组成的有序序列结构。Redis的列表允许用户从序列的两端推入或者弹出元素,获取列表元素,以及执行各种常见的列表操作。除此之外,列表还可以用来存储任务信息、最近浏览过的文章或者常用联系人信息。
一些常用的列表命令:
命令 | 用例和描述 |
---|---|
RPUSH | RPUSH key-name value [value …] — 将一个或多个值推入列表的右端 |
LPUSH | LPUSH key-name value [value …] — 将一个或多个值推入列表的左端 |
RPOP | RPOP key-name — 移除并返回列表最右端的元素 |
LPOP | LPOP key-name — 移除并返回列表最左端的元素 |
LINDEX | LINDEX key-name offset — 返回列表偏移量为offset的元素 |
LRANGE | LRANGE key-name start end — 返回[start, end]范围内的所有元素 |
LTRIM | LTRIM key-name start end — 对列表进行修剪,只保留[start, end]范围内的元素 |
常用命令示例:
1 | conn.rpush('list-key', 'last'); //1L 向列表推入元素,执行完毕会返回列表当前的长度 |
组合使用LTRIM和LRANGE可以构建一个在功能上类似于LPOP或RPOP,但能够一次返回并弹出多个元素的操作。下面的几个列表命令可以将元素从一个列表移动到另一个列表,或者阻塞(block)执行命令的客户端直到有其他客户端给列表添加元素为止。
阻塞式的列表弹出命令以及在列表之间移动元素的命令:
命令 | 用例和描述 |
---|---|
BLPOP | BLPOP key-name [key-name …] timeout — 从第一个非空列表中弹出位于最左端的元素,或者在timeout秒之内阻塞并等待可弹出的元素出现 |
BRPOP | BRPOP key-name [key-name …] timeout — 从第一个非空列表中弹出位于最右端的元素,或者在timeout秒之内阻塞并等待可弹出的元素出现 |
RPOPLPUSH | RPOPLPUSH source-key dest-key — 从source-key 列表中弹出最右端的元素,然后将这个元素推入dest-key 列表的最左端,并向用户返回这个元素 |
BRPOPLPUSH | BRPOPLPUSH source-key dest-key timeout — 从source-key 列表中弹出最右端的元素,然后将这个元素推入dest-key 列表的最左端,并向用户返回这个元素;如果source-key为空,那么在timeout秒之内阻塞并等待可弹出的元素出现 |
阻塞式命令示例:
1 | conn.rpush('list', 'item1'); //1 |
对于阻塞弹出命令和弹出并推入命令,最常见的用例就是消息传递(messaging)和任务队列(task queue)。列表的一个主要优点在于它可以包含多个字符串值,这使得用户可以将数据集中在同一个地方。Redis的集合也提供了与列表类似的特性,但集合只能保存各不相同的元素。
集合
Redis的集合以无序的方式来存储多个各不相同的元素,用户可以快速地对集合执行添加元素操作、移除元素操作以及检查一个元素是否存在于集合里。
一些常用的集合命令:
命令 | 用例和描述 |
---|---|
SADD | SADD key-name item [item … ] — 将一个或多个元素添加到集合里面,并返回被添加元素当中原本并不存在于集合里面的元素数量 |
SREM | SREM key-name item [item … ] — 从集合里面移除一个或多个元素,并返回被移除元素的数量 |
SISMEMBER | SISMEMBER key-name item — 检查元素是否存在于集合key-name里 |
SCARD | SCARD key-name — 返回集合包含的元素的数量 |
SMEMBERS | SMEMBERS key-name — 返回集合包含的所有元素 |
SRANDMEMBER | SRANDMEMBER key-name [count] — 从集合里面随机地返回一个或多个元素。当count为正数时,命令返回的随机元素不会重复,当count为负数时,命令返回的随机元素可能会出现重复 |
SPOP | SPOP key-name — 随机地移除集合中的一个元素,并返回被移除的元素 |
SMOVE | SMOVE source-key dest-key item — 如果集合source-key包含元素item,那么从集合source-key里面移除元素item,并将元素item添加到集合dest-key中;成功返回1,否则返回0 |
redis集合示例:
1 | conn.sadd('set-key', 'a', 'b', 'c'); //3 --返回被添加元素的数量 |
用于组合和处理多个集合的Redis命令:
命令 | 用例和描述 |
---|---|
SDIFF | SDIFF key-name [key-name …] — 返回那些存在于第一个集合、但不存在于其他集合中的元素(差集运算) |
SDIFFSTORE | SDIFFSTORE dest-key key-name [key-name … ] — 将差集运算存储到dest-key键里面 |
SINTER | SINTER key-name [key-name …] — 返回那些同时存在于所有集合中的元素(交集运算) |
SINTERSTORE | SINTERSTORE dest-key key-name [key-name … ] — 将交集运算存储到dest-key键里面 |
SUNION | SUNION key-name [key-name …] — 返回那些至少存在于一个集合中的元素(并集运算) |
SUNIONSTORE | SUNIONSTORE dest-key key-name [key-name … ] — 将并集运算存储到dest-key键里面 |
redis的差集、交集、并集示例:
1 | conn.sadd('skey1', 'a', 'b', 'c', 'd'); //4 |
散列
Redis的散列可以让用户将多个键值对存储到一个Redis键里面。
用于添加和删除键值对的散列操作:
命令 | 用例和描述 |
---|---|
HMGET | HMGET key-name key [key … ] — 从散列获取一个或多个键的值 |
HMSET | HMSET key-name key value [key value … ] — 为散列里面的一个或多个键设置值 |
HDEL | HDEL key-name key [key …] — 删除散列里面的一个或多个键值对,返回成功找到并删除的键值对数量 |
HLEN | HLEN key-name — 返回散列包含的键值对数量 |
hlen命令用于一次读取或者设置多个键的hmget和hmset,像hmget和hmset这种批量处理多个键的命令既可以给用户带来方便,又可以通过减少命令的调用次数以及客户端与Redis之间的通信往返次数来提升Redis的性能。
redis散列命令示例:
1 | conn.hmset('hash-key', {'k1':'v1', 'k2':'k2', 'k3':'k3'}); //true |
redis更高级特性:
命令 | 用例和描述 |
---|---|
HEXISTS | HEXISTS key-name key — 检查给定键是否存在于散列中 |
HKEYS | HKEYS key-name — 获取散列包含的所有键 |
HVALS | HVALS key-name — 获取散列包含的所有值 |
HGETALL | HGETALL key-name — 获取散列包含的所有键值对 |
HINCRBY | HINCRBY key-name key increment — 将键key存储的值加上整数increment |
HINCRBYFLOAT | HINCRBYFLOAT key-name key increment — 将键key存储的值加上浮点数increment |
尽管有hgetall存在,但hkeys和hvals也是很有用,如果散列包含的值非常大,那么用户可以先使用hkeys取出散列包含的所有键,然后再使用hget一个一个地取出键的值,从而避免一次获取多个大体积的值而导致服务器阻塞。hincrby和hincrbyfloat类似于处理字符串的incrby和incrbyfloat,区别就是前者处理散列,后者处理字符串。
散列高级特性示例:
1 | conn.hmset('hash-key2', {'short':'hello', 'long':1000*'1'}); //true |
有序集合
和散列存储着键与值之间的映射类似,有序集合也存储着成员与分值之间的映射,并且提供了分值处理命令,以及根据分值大小有序地获取(fetch)或扫描(scan)成员和分值的命令。
一些常用的有序集合命令:
命令 | 用例和描述 |
---|---|
ZADD | ZADD key-name score member [score member … ] — 将带有给定分值的成员添加到有序集合里面 |
ZREM | ZREM key-name member [member … ] — 从有序集合里面移除给定的成员,并返回被移除成员的数量 |
ZCARD | ZCARD key-name — 返回有序集合包含的成员数量 |
ZINCRBY | ZINCRBY key-name increment member — 将member成员的分值加上increment |
ZCOUNT | ZCOUNT key-name min max — 返回分值介于min和max之间的成员数量 |
ZRANK | ZRANK key-name member — 返回成员member在有序集合中的排名 |
ZSCORE | ZSCORE key-name member — 返回成员member的分值 |
ZRANGE | ZRANGE key-name start stop [WITHSCORES] — 返回有序集合中排名介于start和stop 之间的成员,如果给定了WITHSCORES选项,则将分值一并返回 |
redis有序集合示例:
1 | conn.zadd('zset-key', 3, 'a', 2, 'b', 1, 'c'); //3 |
有序集合的范围型数据获取和删除命令以及并集、交集命令:
命令 | 用例和描述 | ||||
---|---|---|---|---|---|
ZREVRANK | ZREVRANK key-name member — 返回有序集合里成员member的排名,成员按照分值从大到小排列(逆序) | ||||
ZREVRANGE | ZREVRANGE key-name start stop [WITHSCORES] — 返回有序集合给定排名范围内的成员 | ||||
ZRANGEBYSCORE | ZRANGEBYSCORE key min max [WITHSCORES]\ | [LIMIT offset count]返回有序集合中分值介于min和max之间的所有成员 | |||
ZREVRANGEBYSCORE | ZREVRANGEBYSCORE key max min [WITHSCORES]\ | [LIMIT offset count]获取有序集合中分值介于min和max之间的所有成员,并按分值从大到小的顺序来返回它们 | |||
ZREMRANGEBYRANK | ZREMRANGEBYRANK key-name start stop — 移除有序集合中排名介于start和stop之间的所有成员 | ||||
ZREMRANGEBYSCORE | ZREMRANGEBYSCORE key-name min max — 移除有序集合中分值介于min和max之间的所有成员 | ||||
ZINTERSTORE | ZINTERSTORE dest-key key-count key [key … ] \ | [WEIGHTS weight [weight … ]] \ | [AGGREGATE SUM\ | MIN\ | MAX] — 对给定的有序集合执行类似于集合的交集运算 |
ZUNIONSTORE | ZUNIONSTORE dest-key key-count key [key … ] \ | [WEIGHTS weight [weight … ]] \ | [AGGREGATE SUM\ | MIN\ | MAX] — 对给定的有序集合执行类似于集合的并集运算 |
ZINTERSTORE和ZUNIONSTORE命令示例:
1 | conn.zadd('zset-1', 1, 'a', 2, 'b', 3, 'c'); //3 |
发布与订阅
发布与订阅(publish/subscribe)模式,又称pub/sub模式,redis也实现了这种模式。发布与订阅特点是订阅者(listener)负责订阅频道(channel),发送者(publisher)负责向频道发送二进制字符串消息(binary string message)。每当有消息被发送至给定频道时,频道的所有订阅者都会收到消息。
redis提供的发布与订阅命令:
命令 | 用例和描述 |
---|---|
SUBSCRIBE | SUBSCRIBE channel [channel … ] — 订阅给定的一个或多个频道 |
UNSUBSCRIBE | UNSUBSCRIBE [channel [channel … ]] — 退订给定的一个或多个频道,如果执行时没有给定频道则退订所有频道 |
PUBLISH | PUBLISH channel message — 向给定频道发送消息 |
PSUBSCRIBE | PSUBSCRIBE pattern [pattern … ] — 订阅与给定模式相匹配的所有频道 |
PUNSUBSCRIBE | PUNSUBSCRIBE [pattern [pattern … ]] — 退订给定的模式,如果执行时没有给定频道则退订所有模式 |
redis提供的发布与订阅很少用有两个原因:
- redis系统的稳定性有关。对于旧版redis,当用户读取速度慢导致消息积压,会使得redis输出缓冲区体积变大,导致redis速度变慢甚至奔溃,新版会设置client-output-buffer-limit pubsub选项,会自动断开不符合要求的订阅客户端。
- 数据传输的可靠性有关。客户端在执行订阅的过程中断线则会丢失断线期间发送的消息。后面总结解决方法。
排序
Redis的排序操作和其他编程语言的排序操作一样,都可以根据某种比较规则对一系列元素进行有序的排列。负责执行排序操作的SORT命令可以根据字符串、列表、集合、有序集合、散列这5种键里面存储着的数据,对列表、集合以及有序集合进行排序。SORT命令的定义:
命令 | 用例和描述 | ||||||
---|---|---|---|---|---|---|---|
SORT | SORT source-key [BY pattern] \ | [LIMIT offset count] \ | [get pattern [get pattern … ]] \ | [ASC\ | DESC] \ | [ALPHA] \ | [STORE dest-key] — 根据给定的选项,对输入列表、集合或者有序集合进行排序,然后返回或者存储排序的结果 |
使用SORT命令提供的选项可以实现以下功能:
- 根据降序而不是默认的升序来排序元素;
- 将元素看作是数字来进行排序,或者将元素看作是二进制字符串来进行排序;
- 使用被排序元素之外的其他值作为权重来进行排序,甚至还可以从输入的列表、集合、有序集合以外的其他地方进行取值。
SORT命令示例:
1 | conn.rpush('sort-input', 23, 15, 110, 7); //4 |
SORT是redis唯一一个可以同时处理3种不同类型的数据的命令,但基本的redis事务同样可以让我们在一连串不间断执行的命令里面操作多种不同类型的数据。
基本的Redis事务
Redis的基本事务(basic transaction)需要用到MULTI命令和EXEC命令,这种事务可以让一个客户端在不被其他客户端打断的情况下执行多个命令。Redis有5个命令可以让用户在不被打断(interruption)的情况下多个键执行操作,它们分别是WATCH、MULTI、EXEC、UNWATCH和DISCARD。和关系数据库那种可以在执行的过程中进行回滚(rollback)的事务不同,在redis里面,被multi命令和exec命令包围的所有命令会一个接一个地执行,直到所有命令都执行完毕为止。当一个事务执行完毕之后,redis才会处理其他客户端的命令。
在redis里面执行事务,当redis从一个客户端那里接收到multi命令时,redis会将这个客户端之后发送的所有命令都放到一个队列里面,直到这个客户端发送exec命令为止,然后redis就会在不被打断的情况下,一个接一个地执行存储在队列里面的命令。
说明:
- multi和exec事务的一个主要作用是移除竞争条件;
- 在redis里面使用流水线的另一个目的是提高性能,在执行一连串命令时,减少redis与客户端之间的通信往返次数可以大幅度降低客户端等待回复所需要的时间。
键的过期时间
过期时间特性对于清理缓存数据非常有用,但是只有少数几个命令可以原子地为键设置过期时间,并且对于列表、集合、散列和有序集合这样的容器(container)来说,键的过期时间命令只能为整个键设置而没有办法为键里面的单个元素设置过期时间,为了解决这个问题,我们可以用存储时间戳的有序集合来实现针对单个元素的过期时间。用于处理过期时间的redis命令:
命令 | 示例和描述 |
---|---|
PERSIST | PERSIST key-name — 移除键的过期时间 |
TTL | TTL key-name — 查看给定键距离过期时间还有多少秒 |
EXPIRE | EXPIRE key-name seconds — 让给定键在指定的秒数之后过期 |
EXPIREAT | EXPIREAT key-name timestsmp — 将给定键的过期时间设置为给定的UNIX时间戳 |
PTTL | PTTL key-name 查看给定键距离过期时间还有多少毫秒 |
PEXPIRE | PEXPIRE key-name milliseconds — 让给定键在指定的毫秒数之后过期 |
PEXPIREAT | PEXPIREAT key-name timestsmp-milliseconds — 将一个毫秒级精度的UNIX时间戳设置为给定键的过期时间 |
redis过期时间命令示例:
1 | conn.set('key', 'value'); //true |