redis-6-sorted-set

/ Database / 没有评论 / 184浏览

指令

键指令作用例子返回值序号
ZADD用于将一个或多个成员元素及其分数值加入到有序集当中。如果某个成员已经是有序集的成员,那么更新这个成员的分数值,并通过重新插入这个成员元素,来保证该成员在正确的位置上。分数值可以是整数值或双精度浮点数。如果有序集合 key 不存在,则创建一个空的有序集并执行 ZADD 操作。当 key 存在但不是有序集类型时,返回一个错误。ZADD KEY_NAME SCORE1 VALUE1.. SCOREN VALUEN被成功添加的新成员的数量,不包括那些被更新的、已经存在的成员0
ZCARD于计算集合中元素的数量ZCARD KEY_NAME当 key 存在且是有序集类型时,返回有序集的基数。 当 key 不存在时,返回 01
ZCOUNT用于计算有序集合中指定分数区间的成员数量ZCOUNT key min max分数值在 min 和 max 之间的成员的数量2
ZINCRBY对有序集合中指定成员的分数加上增量 increment。可以通过传递一个负数值 increment ,让分数减去相应的值,比如 ZINCRBY key -5 member ,就是让 member 的 score 值减去 5 。当 key 不存在,或分数不是 key 的成员时, ZINCRBY key increment member 等同于 ZADD key increment member 。当 key 不是有序集类型时,返回一个错误。分数值可以是整数值或双精度浮点数ZINCRBY key increment membermember 成员的新分数值,以字符串形式表示3
ZINTERSTORE计算给定的一个或多个有序集的交集,其中给定 key 的数量必须以 numkeys 参数指定,并将该交集(结果集)储存到 destination 。默认情况下,结果集中某个成员的分数值是所有给定集下该成员分数值之和ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]保存到目标结果集的的成员数量4
ZLEXCOUNT在计算有序集合中指定字典区间内成员数量ZLEXCOUNT KEY MIN MAX指定区间内的成员数量5
ZRANGE返回有序集中,指定区间内的成员。其中成员的位置按分数值递增(从小到大)来排序。具有相同分数值的成员按字典序(lexicographical order )来排列。如果你需要成员按值递减(从大到小)来排列,请使用 ZREVRANGE 命令。下标参数 start 和 stop 都以 0 为底,也就是说,以 0 表示有序集第一个成员,以 1 表示有序集第二个成员,以此类推。你也可以使用负数下标,以 -1 表示最后一个成员, -2 表示倒数第二个成员,以此类推ZRANGE key start stop [WITHSCORES]指定区间内,带有分数值(可选)的有序集成员的列表6
ZRANGEBYLEX通过字典区间返回有序集合的成员ZRANGEBYLEX key min max [LIMIT offset count]指定区间内的元素列表7
ZRANGEBYSCORE返回有序集合中指定分数区间的成员列表。有序集成员按分数值递增(从小到大)次序排列。具有相同分数值的成员按字典序来排列(该属性是有序集提供的,不需要额外的计算)。默认情况下,区间的取值使用闭区间 (小于等于或大于等于),你也可以通过给参数前增加 ( 符号来使用可选的开区间 (小于或大于)。ZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]指定区间内,带有分数值(可选)的有序集成员的列表8
ZRANK返回有序集中指定成员的排名。其中有序集成员按分数值递增(从小到大)顺序排列ZRANK key member如果成员是有序集 key 的成员,返回 member 的排名。 如果成员不是有序集 key 的成员,返回 nil9
ZREM用于移除有序集中的一个或多个成员,不存在的成员将被忽略。当 key 存在但不是有序集类型时,返回一个错误。ZREM key member [member ...]被成功移除的成员的数量,不包括被忽略的成员10
ZREMRANGEBYLEX用于移除有序集合中给定的字典区间的所有成员ZREMRANGEBYLEX key min max被成功移除的成员的数量,不包括被忽略的成员11
ZREMRANGEBYRANK用于移除有序集合中,指定排名(rank)区间内的所有成员ZREMRANGEBYRANK key start stop被移除成员的数量12
ZREMRANGEBYSCORE用于移除有序集合中,指定分数(score)区间内的所有成员ZREMRANGEBYSCORE key min max被移除成员的数量13
ZREVRANGE返回有序集中,指定区间内的成员。其中成员的位置按分数值递减(从大到小)来排列。具有相同分数值的成员按字典序的逆序(reverse lexicographical order)排列。除了成员按分数值递减的次序排列这一点外, ZREVRANGE 命令的其他方面和 ZRANGE 命令一样ZREVRANGE key start stop [WITHSCORES]指定区间内,带有分数值(可选)的有序集成员的列表14
ZREVRANGEBYSCORE返回有序集中指定分数区间内的所有的成员。有序集成员按分数值递减(从大到小)的次序排列。具有相同分数值的成员按字典序的逆序(reverse lexicographical order )排列。除了成员按分数值递减的次序排列这一点外, ZREVRANGEBYSCORE 命令的其他方面和 ZRANGEBYSCORE 命令一样ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]指定区间内,带有分数值(可选)的有序集成员的列表15
ZREVRANK返回有序集中成员的排名。其中有序集成员按分数值递减(从大到小)排序。排名以 0 为底,也就是说, 分数值最大的成员排名为 0 。使用 ZRANK 命令可以获得成员按分数值递增(从小到大)排列的排名ZREVRANK key member如果成员是有序集 key 的成员,返回成员的排名。 如果成员不是有序集 key 的成员,返回 nil16
ZSCORE返回有序集中成员的分数值。 如果成员元素不是有序集 key 的成员,或 key 不存在,返回 nilZSCORE key member成员的分数值,以字符串形式表示17
ZUNIONSTORE计算给定的一个或多个有序集的并集,其中给定 key 的数量必须以 numkeys 参数指定,并将该并集(结果集)储存到 destination 。默认情况下,结果集中某个成员的分数值是所有给定集下该成员分数值之和 。ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX]保存到 destination 的结果集的成员数量18
ZSCAN用于迭代有序集合中的元素(包括元素成员和元素分值)ZSCAN key cursor [MATCH pattern] [COUNT count]返回的每个元素都是一个有序集合元素,一个有序集合元素由一个成员(member)和一个分值(score)组成19

代码实践

Zadd

	keyAppend := []*redis.Z{
		{Member: "阿斗", Score: 190},
		{Member: "华仔", Score: 120},
		{Member: "狗蛋", Score: 100},
		{Member: "233", Score: 100},
	}
	res,err := RedisClient.ZAdd(ctx, "sorted-set", keyAppend...).Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回所有写入成功的成员数量,不包括那些被更新的、已经存在的成员

ZCard

	res,err := RedisClient.ZCard(ctx, "sorted-set").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回集合中元素的数量

ZCount

	res,err := RedisClient.ZCount(ctx, "sorted-set","100","120").Result() // 包括100分和120分
	if err != nil {
		logrus.Error(err) // 如果目标key不存在,不报错
		return
	}
	logrus.Info(res) // 正常情况下返回匹配元素的数量=

ZIncrBy

res, err := RedisClient.ZIncrBy(ctx, "sorted-set", 10, "阿斗").Result()
if err != nil {
   logrus.Error(err) // key不存在,会自动创建该key,并增加该member
}
logrus.Info("新的分数为", res) // 返回增加后的分数,如果key不存在,则返回增加的值

ZINTERSTORE todo

ZLexCount

res,err := RedisClient.ZLexCount(ctx,"sorted-set","[liuqi","[李精华").Result()
if err != nil {
   logrus.Error(err) // 如果key不存在,不报错,返回0
}
logrus.Infof("%v", res) // 返回指定元素之间的member个数

ZRange

res,err := RedisClient.ZRange(ctx,"sorted-set",0,100).Result() // start 最小为0,-1表示最后一个成员,-2表示倒数第二个成员
if err != nil {
   logrus.Error(err) // 如果key不存在,不报错,返回空数组
}
logrus.Infof("%v", res) // 返回指定分数之间的成员,分数为从小到大

ZRANGEBYLEX

todo

ZRANGEBYSCORE

	var opt redis.ZRangeBy
	opt = redis.ZRangeBy{
		Min:    "10",  //最小分数
		Max:    "111", //最大分数
		Offset: 0,     //在满足条件的范围,从offset下标处开始取值
		Count:  10,    //查询结果集个数
	}
	res,err := RedisClient.ZRangeByScore(ctx,"sorted-set",&opt).Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在,不报错,返回空数组
	}
	logrus.Infof("%v", res) // 返回指定分数之间的成员,按照分数的升序排列结果,具有相同分数值的成员按字典序来排列(该属性是有序集提供的,不需要额外的计算)

ZRank

	res,err := RedisClient.ZRank(ctx,"sorted-set","阿斗").Result() 
	if err != nil {
		logrus.Error(err) // 如果key不存在报错nil
	}
	logrus.Infof("%v", res) // 返回指定成员的索引

ZRem

	// 根据成员名称,移除指定成员 :
	res,err:= RedisClient.ZRem(ctx, "sorted-set", "嗷嗷").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在不报错
	}
	logrus.Info(res) // =0 失败   >0 成功
	// 批量移除指定的多个成员
	memberList := make([]interface{}, 0)
	memberList = append(memberList, "123", "234")
	result, err := RedisClient.ZRem(ctx, "sorted-set", memberList...).Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在不报错
	}
	logrus.Info(result) // =0 失败   >0 成功

ZREMRANGEBYLEX

// 其中第48~57为0~9十个阿拉伯数字;65~90为26个大写英文字母,97~122为26个小写字母

// redis 有序列表排序,ASCII码从大到小排列,也就是数字和字母都是从大到小排序

	res,err:= RedisClient.ZRemRangeByLex(ctx, "sort1ed-set", "[bbbb","[cccc").Result() // min 在max的下面,min要比mac的ascii码小
	if err != nil {
		logrus.Error(err) // 如果key不存在不报错
	}
	logrus.Info(res) // 返回成功删除的元素个数

ZREMRANGEBYRANK

	res,err:= RedisClient.ZRemRangeByRank(ctx, "sorted-set", 3,2).Result() // start stop 为元素的下标
	if err != nil {
		logrus.Error(err) // 如果key不存在不报错
	}
	logrus.Info(res) // 返回成功删除的元素个数

ZREMRANGEBYSCORE

	res,err:= RedisClient.ZRemRangeByScore(ctx, "sorted-set", "2","67").Result() // min max 为分数区间
	if err != nil {
		logrus.Error(err) // 如果key不存在不报错
	}
	logrus.Info(res) // 返回成功删除的元素个数

ZRevRange

res,err:= RedisClient.ZRevRange(ctx, "sorted-set", 0,2).Result() //  start stop 为需要排序的元素的下标
if err != nil {
   logrus.Error(err) // 如果key不存在不报错
}
logrus.Info(res) // 返回分数值从大到小的成员元素,与ZRange相似,只是值是按照分数从大到小排列

ZSCORE

	res,err:= RedisClient.ZScore(ctx, "sorted-set", "a").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在,报错nil
	}
	logrus.Info(res) // 返回该key的元素的分数值

ZUnionStore

	var opt redis.ZStore
	opt = redis.ZStore{
			Keys: []string{"sorted-set1","sorted-set"},
	}
	res,err:= RedisClient.ZUnionStore(ctx, "sorted-set1211",&opt).Result()

	if err != nil {
		logrus.Error(err) // 如果key不存在,不报错,会直接创建
	}
	logrus.Info(res) // 返回本次key合并交集的元素个数

ZSCAN

	res,cursor,err:= RedisClient.ZScan(ctx, "sorted-set",0,"*",10).Result()
	logrus.Info(cursor)
	if err != nil {
		logrus.Error(err) // 如果key不存在,不报错,返回空数组
	}
	logrus.Info(res) // 返回本次扫描结果的member和score

[ 符号

( 符号

特殊值 + 和 - 在 min 参数以及 max 参数中具有特殊的意义, 其中 + 表示正无限, 而 - 表示负无限。 因此, 向一个所有成员的分值都相同的有序集合发送命令 ZRANGEBYLEX - + , 命令将返回有序集合中的所有元素