Redis数据类型 之 zset

Redis数据类型 之 zset

zset：不能重复但有序

zadd key score member [[score member] [score member] …]

将一个或多个 member 元素及其 score 值加入到有序集 key 当中。

zcard key

返回有序集 key 的基数。

zcount key min max

返回有序集 key 中， score 值在 min 和 max 之间(默认包括 score 值等于 min 或 max )的成员的数量。

zincrby key increment member

为有序集 key 的成员 member 的 score 值加上增量 increment 。

zrange key start stop [withscores]

返回有序集 key 中，指定区间内的成员。
其中成员的位置按 score 值递增(从小到大)来排序。

zrangebyscore key min max [withscores] [limit offset count]

返回有序集 key 中，所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。有序集成员按 score 值递增(从小到大)次序排列。
LIMIT 参数指定返回结果的数量及区间(就像SQL中的 SELECT LIMIT offset, count )

zrem key member [member …]

移除有序集 key 中的一个或多个成员，不存在的成员将被忽略。
当 key 存在但不是有序集类型时，返回一个错误。

zremrangebyrank key start stop

移除有序集 key 中，指定排名(rank)区间内的所有成员。
区间分别以下标参数 start 和 stop 指出，包含 start 和 stop 在内。
下标参数 start 和 stop 都以 0 为底，也就是说，以 0 表示有序集第一个成员，以 1 表示有序集第二个成员，以此类推。
你也可以使用负数下标，以 -1 表示最后一个成员， -2 表示倒数第二个成员，以此类推。

zremrangebyscore key min max

移除有序集 key 中，所有 score 值介于 min 和 max 之间(包括等于 min 或 max )的成员。

zrevrange key start stop [withscores]

返回有序集 key 中，指定区间内的成员。
其中成员的位置按 score 值递减(从大到小)来排列。
具有相同 score 值的成员按字典序的逆序(reverse lexicographical order)排列。

zrevrangebyscore key max min [withscores] [limit offset count]

返回有序集 key 中， score 值介于 max 和 min 之间(默认包括等于 max 或 min )的所有的成员。有序集成员按 score 值递减(从大到小)的次序排列。

zrevrank key member

返回有序集 key 中成员 member 的排名。其中有序集成员按 score 值递减(从大到小)排序。
排名以 0 为底，也就是说， score 值最大的成员排名为 0 。

zscore key member

返回有序集 key 中，成员 member 的 score 值。
如果 member 元素不是有序集 key 的成员，或 key 不存在，返回 nil 。

zunionstore destination numkeys key [key …] [weights weight [weight …]] [aggregate sum|min|max]

计算给定的一个或多个有序集的并集，其中给定 key 的数量必须以 numkeys 参数指定，并将该并集(结果集)储存到 destination 。
默认情况下，结果集中某个成员的 score 值是所有给定集下该成员 score 值之 和 。
weights
使用 weights 选项，你可以为 每个 给定有序集 分别 指定一个乘法因子(multiplication factor)，每个给定有序集的所有成员的 score 值在传递给聚合函数(aggregation function)之前都要先乘以该有序集的因子。
如果没有指定 weights 选项，乘法因子默认设置为 1 。
aggregate
使用 aggregate 选项，你可以指定并集的结果集的聚合方式。
默认使用的参数 sum ，可以将所有集合中某个成员的 score 值之 和 作为结果集中该成员的 score 值；使用参数 min ，可以将所有集合中某个成员的 最小 score 值作为结果集中该成员的 score 值；而参数 max 则是将所有集合中某个成员的 最大 score 值作为结果集中该成员的 score 值。

zinterstore destination numkeys key [key …] [weights weight [weight …]] [aggregate sum|min|max]

计算给定的一个或多个有序集的交集，其中给定 key 的数量必须以 numkeys 参数指定，并将该交集(结果集)储存到 destination 。
默认情况下，结果集中某个成员的 score 值是所有给定集下该成员 score 值之和