Redis参考手册
排序集 | Sorted Sets
zadd
ZADD key [NX|XX] [CH] [INCR] score member [score member ...]
自1.2.0起可用。
时间复杂度:添加每个项目的O(log(N)),其中N是排序集合中元素的数量。
将指定分数的所有指定成员添加到key
存储的已排序集。可以指定多个乐谱/成员对。如果指定的成员已经是有序集合的成员,则更新得分并将元素重新插入到正确的位置以确保正确的排序。
如果key
不存在,则创建一个新的有指定成员作为唯一成员的有序集合,就像已排序的集合是空的一样。如果密钥存在但不包含有序集合,则返回错误。
得分值应该是双精度浮点数的字符串表示。+inf
和-inf
值是有效的值也是如此。
ZADD选项(Redis 3.0.2或更高版本)
ZADD 支持在密钥名称和第一个分数参数之前指定的选项列表。选项是:
- XX:只更新已经存在的元素。切勿添加元素。
- NX:不要更新已有的元素。总是添加新的元素。
- CH:从添加的新元素数量修改返回值到更改的元素总数(CH 是已更改的缩写)。更改的元素是添加的新元素以及已更新分数的元素。因此,在命令行中指定的与过去相同得分的元素不计算在内。注意:通常 ZADD 的返回值只计算添加的新元素的数量。
- INCR:指定此选项时,ZADD 的行为与 ZINCRBY 相同。在此模式下只能指定一个乐谱元素对。
可精确表示的整数分数的范围
Redis 排序集使用双64位浮点数来表示分数。在所有我们所支持的架构,这表示为IEEE 754浮点数,即能代表之间的精确整数-(2^53)
和+(2^53)
包括在内。更实用的说,-9007199254740992和9007199254740992之间的所有整数都是完全可以代表的。较大的整数或分数在内部以指数形式表示,所以可能只得到十进制数的近似值,或者设置为分数的非常大的整数。
分类集101
排序集按照他们的得分按升序排列。同一元素只存在一次,不允许重复元素。可以通过 ZADD 修改得分,ZADD 会更新元素得分,并且作为副作用,它在有序集合上的位置以及 ZINCRBY 可以用来将得分相对于之前的值更新。
元素的当前得分可以使用 ZSCORE 命令检索,也可以用来验证元素是否已经存在。
分拣台的介绍,请参阅数据类型页排序集。
具有相同分数的元素
虽然相同的元素不能在有序集合中重复使用,因为每个元素都是唯一的,所以可以添加多个具有相同得分的不同元素。当多个元素具有相同的得分时,它们按照字典顺序排列(它们仍然按照得分作为第一个键来排序,但是,在本地,具有相同得分的所有元素按字典顺序相对有序)。
使用的字典顺序是二进制的,它将字符串比作字节数组。
如果用户将所有元素插入到具有相同分数的排序集合中(例如0),则排序集合中的所有元素按照字典顺序排序,并且可以使用命令 ZRANGEBYLEX 对元素进行范围查询(注意:也可以使用 ZRANGEBYSCORE 按分数范围查询排序集)。
返回值
整数回复,具体为:
- 添加到已排序集合的元素数量,不包括已经为其更新分数的元素。如果指定了 INCR 选项,则返回值将是批量字符串回复:
-
member
(双精度浮点数)的新分数,以字符串表示。
历史
-
>= 2.4
:接受多个元素。在 Redis 版本超过2.4的情况下,每次调用都可以添加或更新单个成员。
示例
redis> ZADD myzset 1 "one" (integer) 1
redis> ZADD myzset 1 "uno" (integer) 1
redis> ZADD myzset 2 "two" 3 "three" (integer) 2
redis> ZRANGE myzset 0 -1 WITHSCORES 1) "one" 2) "1" 3) "uno" 4) "1" 5) "two" 6) "2" 7) "three" 8) "3"
排序集 | Sorted Sets相关
Redis 是一个开源的使用 ANSI C 语言编写、遵守 BSD 协议、支持网络、可基于内存亦可持久化的日志型、Key-Value 数据库,并提供多种语言的 API。 它通常被称为数据结构服务器,因为值( value )可以是 字符串( String ), 哈希(Map),列表(list),集合( sets ) 和 有序集合( sorted sets )等类型。
主页 | https://redis.io/ |
源码 | https://github.com/antirez/redis |
发布版本 | 4.0.2 |