非常教程

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"

Redis

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

Redis目录

1.集合 | Cluster
2.连接 | Connection
3.Geo
4.Hashes
5.HyperLogLog
6.键 | Keys
7.列表 | Lists
8.Pub/Sub
9.脚本 | Scripting
10.服务器 | Server
11.设定 | Sets
12.排序集 | Sorted Sets
13.字符串 | Strings
14.事务 | Transactions
15.Redis Dump 命令
16.Redis DEL 命令
17.Redis 键(key)
18.Redis 命令
19.Redis 配置
20.Redis 简介
21.Redis RANDOMKEY 命令
22.Redis TTL 命令
23.Redis Pttl 命令
24.Redis PERSIST 命令
25.Redis Move 命令
26.Redis PEXPIREAT 命令
27.Redis Keys 命令
28.Redis Expireat 命令
29.Redis Expire 命令
30.Redis EXISTS 命令
31.Redis Mget 命令
32.Redis Getbit 命令
33.Redis Getset 命令
34.Redis Getrange 命令
35.Redis Get 命令
36.Redis SET 命令
37.Redis 字符串(String)
38.Redis Type 命令
39.Redis Renamenx 命令
40.Redis Rename 命令
41.Redis Incrby 命令
42.Redis Incr 命令
43.Redis Psetex 命令
44.Redis Msetnx 命令
45.Redis Mset 命令
46.Redis Strlen 命令
47.Redis Setrange 命令
48.Redis Setnx 命令
49.Redis Setex 命令
50.Redis Setbit 命令
51.Redis Hincrby 命令
52.Redis Hgetall 命令
53.Redis Hget 命令
54.Redis Hexists 命令
55.Redis Hdel 命令
56.Redis 哈希(Hash)
57.Redis Append 命令
58.Redis Decrby 命令
59.Redis Decr 命令
60.Redis Incrbyfloat 命令
61.Redis Blpop 命令
62.Redis 列表(List)
63.Redis Hvals 命令
64.Redis Hsetnx 命令
65.Redis Hset 命令
66.Redis Hmset 命令
67.Redis Hmget 命令
68.Redis Hlen 命令
69.Redis Hkeys 命令
70.Redis Hincrbyfloat 命令
71.Redis Lrem 命令
72.Redis Lrange 命令
73.Redis Lpushx 命令
74.Redis Lpush 命令
75.Redis Lpop 命令
76.Redis Llen 命令
77.Redis Linsert 命令
78.Redis Lindex 命令
79.Redis Brpoplpush 命令
80.Redis Brpop 命令
81.Redis Sdiff 命令
82.Redis Scard 命令
83.Redis Sadd 命令
84.Redis 集合(Set)
85.Redis Rpushx 命令
86.Redis Rpush 命令
87.Redis Rpoplpush 命令
88.Redis Rpop 命令
89.Redis Ltrim 命令
90.Redis Lset 命令
91.Redis Sunion 命令
92.Redis Srem 命令
93.Redis Srandmember 命令
94.Redis Spop 命令
95.Redis Smove 命令
96.Redis Smembers 命令
97.Redis Sismember 命令
98.Redis Sinterstore 命令
99.Redis Sinter 命令
100.Redis Sdiffstore 命令