redis-6-sorted-set

/ Database / 1 条评论 / 2034浏览

redissorted-set

指令

键指令作用例子返回值序号
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 - + ， 命令将返回有序集合中的所有元素

本文由 李阿斗创作 旅途愉快～ 我的主页 (￣▽￣)

最后编辑时间为: 2022/06/04 22:22

→ ← ↓ ↑
  1. ray

    大佬学完了 来点进阶的

    回复
  1. 1