redis-5-set

/ Database / 没有评论 / 2625浏览

redisset

指令介绍

键指令作用例子返回值序号
SADD将一个或多个成员元素加入到集合中，已经存在于集合的成员元素将被忽略，假如集合 key 不存在，则创建一个只包含添加的元素作成员的集合SADD KEY_NAME VALUE1..VALUEN被添加到集合中的新元素的数量，不包括被忽略的元素0
SCARD返回集合中元素的数量SCARD KEY_NAME集合的数量。 当集合 key 不存在时，返回 01
SDIFF返回第一个集合与其他集合之间的差异，也可以认为说第一个集合中独有的元素。不存在的集合 key 将视为空集, 差集的结果来自前面的 FIRST_KEY ,而不是后面的 OTHER_KEY1，也不是整个 FIRST_KEY OTHER_KEY1..OTHER_KEYN 的差集SDIFF FIRST_KEY OTHER_KEY1..OTHER_KEYN包含差集成员的列表2
SDIFFSTORE将给定集合之间的差集(SDIFF指令的输出)存储在指定的集合中。如果指定的集合 key 已存在，则会被覆盖SDIFFSTORE DESTINATION_KEY KEY1..KEYN结果集中的元素数量3
SINTER返回给定所有给定集合的交集。 不存在的集合 key 被视为空集。 当给定集合当中有一个空集时，结果也为空集(根据集合运算定律)SINTER KEY KEY1..KEYN交集成员的列表4
SINTERSTORE将给定集合之间的交集存储在指定的集合中。如果指定的集合已经存在，则将其覆盖SINTERSTORE DESTINATION_KEY KEY KEY1..KEYN返回存储交集的集合的元素数量5
SISMEMBER判断成员元素是否是集合的成员SISMEMBER KEY VALUE如果成员元素是集合的成员，返回 1 。 如果成员元素不是集合的成员，或 key 不存在，返回 06
SMEMBERS返回集合中的所有的成员。 不存在的集合 key 被视为空集合SMEMBERS key集合中的所有成员7
SMOVE将指定成员 member 元素从 source 集合移动到 destination 集合。SMOVE 是原子性操作。如果 source 集合不存在或不包含指定的 member 元素，则 SMOVE 命令不执行任何操作，仅返回 0 。否则， member 元素从 source 集合中被移除，并添加到 destination 集合中去。当 destination 集合已经包含 member 元素时， SMOVE 命令只是简单地将 source 集合中的 member 元素删除。当 source 或 destination 不是集合类型时，返回一个错误SMOVE SOURCE DESTINATION MEMBER如果成员元素被成功移除，返回 1 。 如果成员元素不是 source 集合的成员，并且没有任何操作对 destination 集合执行，那么返回 08
SPOP用于移除集合中的指定 key 的一个或多个随机元素，移除后会返回移除的元素。该命令类似 Srandmember 命令，但 SPOP 将随机元素从集合中移除并返回，而 Srandmember 则仅仅返回随机元素，而不对集合进行任何改动SPOP KEY_NAME [count]被移除的随机元素。 当集合不存在或是空集时，返回 nil9
SRANDMEMBER于返回集合中的一个随机元素。从 Redis 2.6 版本开始， Srandmember 命令接受可选的 count 参数：如果 count 为正数，且小于集合基数，那么命令返回一个包含 count 个元素的数组，数组中的元素各不相同。如果 count 大于等于集合基数，那么返回整个集合。 如果 count 为负数，那么命令返回一个数组，数组中的元素可能会重复出现多次，而数组的长度为 count 的绝对值。该操作和 SPOP 相似，但 SPOP 将随机元素从集合中移除并返回，而 Srandmember 则仅仅返回随机元素，而不对集合进行任何改动SRANDMEMBER KEY [count]只提供集合 key 参数时，返回一个元素；如果集合为空，返回 nil 。 如果提供了 count 参数，那么返回一个数组；如果集合为空，返回空数组10
SREM用于移除集合中的一个或多个成员元素，不存在的成员元素会被忽略。当 key 不是集合类型，返回一个错误。 在 Redis 2.4 版本以前， SREM 只接受单个成员值SREM KEY MEMBER1..MEMBERN被成功移除的元素的数量，不包括被忽略的元素11
SUNION返回给定集合的并集。不存在的集合 key 被视为空集SUNION KEY KEY1..KEYN并集成员的列表12
SUNIONSTORE将给定集合的并集存储在指定的集合 destination 中。如果 destination 已经存在，则将其覆盖SUNIONSTORE destination key [key ...]结果集中的元素数量13
SSCAN用于迭代集合中键的元素，Sscan 继承自 ScanSSCAN key cursor [MATCH pattern] [COUNT count]数组列表14

代码实践

SADD

	res,err := RedisClient.SAdd(ctx,"set","lijinghua","limeihua").Result()
	if err != nil {
		logrus.Error(err) // 如果key存在，则覆盖
		return
	}
	logrus.Info(res) // 返回成功写入的元素，已存在的不在返回内容内

SCARD

	res,err := RedisClient.SCard(ctx,"set").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在，不报错
		return
	}
	logrus.Info(res) // 返回元素的个数，如果key不存在，返回0

SDIFF

	res,err := RedisClient.SDiff(ctx,"set","set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在，不报错
		return
	}
	logrus.Info(res) // 返回第一个key独有的元素

SDIFFSTORE

	res, err := RedisClient.SDiffStore(ctx, "set-diff", "set", "set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在，不报错
		return
	}
	logrus.Info(res) // 返回SDiff的元素个数，对比的两个key都不存在，返回0

SINTER

	res, err := RedisClient.SInter(ctx, "set", "set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在，不报错
		return
	}
	logrus.Info(res) // 返回SInter求交集的结果，对比的两个key都不存在，返回0

SInterStore

	res, err := RedisClient.SInterStore(ctx, "set112", "set","set1").Result()
	if err != nil {
		logrus.Error(err) // 如果2个key都不存在，不报错
		return
	}
	logrus.Info(res) // 返回SInter求交集的结果，对比的两个key都不存在，返回0

SISMEMBER

	res, err := RedisClient.SIsMember(ctx, "set1112", "lijinghua").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在，不报错
		return
	}
	logrus.Info(res) // 如果存在，则返回true，否则返回false

SMEMBERS

	res, err := RedisClient.SMembers(ctx, "set1111").Result()
	if err != nil {
		logrus.Error(err) // 如果key不存在，不报错
		return
	}
	logrus.Info(res) // 正常情况下返回元素的数组列表，如果key不存在或者元素为空，返回空数组

SMove

	res, err := RedisClient.SMove(ctx, "set1","set","user1").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key不存在，会创建，不报错
		return
	}
	logrus.Info(res) // 正常情况下返回成功移动source key中的元素到目标key的元素个数,尽管目标key中已包含要移动的元素，但是source key会删除要移动的元素

SPop

res, err := RedisClient.SPop(ctx, "set1").Result()
if err != nil {
   logrus.Error(err) // 如果目标key不存在，会报错
   return
}
logrus.Info(res) // 正常情况下返回成功随机出来并删除的元素

SRandMember

res, err := RedisClient.SRandMember(ctx, "set").Result()
if err != nil {
   logrus.Error(err) // 如果目标key不存在，报错 nil
   return
}
logrus.Info(res) // 正常情况下返回随机出来的元素

SRandMemberN

	res, err := RedisClient.SRandMemberN(ctx, "se12t11",2).Result()
	if err != nil {
		logrus.Error(err) // 如果目标key不存在，不报错
		return
	}
	logrus.Info(res) // 正常情况下返回N个随机出来的元素，如果只有count个元素，则每次返回数据一样

SREM

	res, err := RedisClient.SRem(ctx, "set11","1111","2222").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key不存在，不报错，返回0
		return
	}
	logrus.Info(res) // 正常情况下返回移除的元素个数

SUNION

	res, err := RedisClient.SUnion(ctx, "set","set1","set121").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在，不报错
		return
	}
	logrus.Info(res) // 正常情况下返回所有目标的并集结果

SUNIONSTORE

	res, err := RedisClient.SUnionStore(ctx, "set","11111","1111111").Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在，不报错
		return
	}
	logrus.Info(res) // 正常情况下返回所有目标的并集结果，destination key在有并集结果和没并集结果的情况下，都会被清空

SSCAN

	res, cursor, err := RedisClient.SScan(ctx, "set",0,"*jinghua*",10).Result()
	if err != nil {
		logrus.Error(err) // 如果目标key都不存在，不报错
		return
	}
	logrus.Warn(cursor)
	logrus.Info(res) // 正常情况下返回所有匹配的元素组成的数组

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

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

→ ← ↓ ↑