Redis集合命令

Redis的Set是String类型的无序集合。集合成员是唯一的，这就意味着集合中不能出现重复的数据。

Redis中集合是通过哈希表实现的，所以添加，删除，查找的复杂度都是O(1)。

集合中最大的成员数为 $2^{32} - 1$(超过40亿)。

Redis Sadd命令

Redis Sadd命令将一个或多个成员元素加入到集合中，已经存在于集合的成员元素将被忽略。

假如集合key不存在，则创建一个只包含添加的元素作成员的集合。

当集合key不是集合类型时，返回一个错误。

语法

127.0.0.1:6379> SADD KEY_NAME VALUE1..VALUEN

返回值

被添加到集合中的新元素的数量，不包括被忽略的元素

示例

127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "hello"
(integer) 0
127.0.0.1:6379> SMEMBERS myset
1) "hello"
2) "foo"

Redis Scard命令

Redis Scard命令返回集合中元素的数量。

语法

127.0.0.1:6379> SCARD KEY_NAME

返回值

• 集合的数量
• 当集合key不存在时，返回0

示例

127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "hello"
(integer) 0
127.0.0.1:6379> SCARD myset
(integer) 2

Redis Sdiff命令

Redis Sdiff命令返回给定集合之间的差集。不存在的集合 key 将视为空集。

差集的结果来自前面的FIRST_KEY，而不是后面的OTHER_KEY1，也不是整个FIRST_KEY OTHER_KEY1..OTHER_KEYN的差集。

语法

127.0.0.1:6379> SDIFF FIRST_KEY OTHER_KEY1..OTHER_KEYN

返回值

包含差集成员的列表

示例

127.0.0.1:6379> SADD key1 "a"
(integer) 1
127.0.0.1:6379> SADD key1 "b"
(integer) 1
127.0.0.1:6379> SADD key1 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "d"
(integer) 1
127.0.0.1:6379> SADD key2 "e"
(integer) 1
127.0.0.1:6379> SDIFF key1 key2
1) "a"
2) "b"

Redis Sdiffstore命令

Redis Sdiffstore命令将给定集合之间的差集存储在指定的集合中。如果指定的集合key已存在，则会被覆盖。

语法

127.0.0.1:6379> SDIFFSTORE DESTINATION_KEY KEY1..KEYN

返回值

结果集中的元素数量

示例

127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "bar"
(integer) 1
127.0.0.1:6379> SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "world"
(integer) 1
127.0.0.1:6379> SDIFFSTORE destset myset myset2
(integer) 2
127.0.0.1:6379> SMEMBERS destset
1) "foo"
2) "bar"

Redis Sinter命令

Redis Sinter命令返回给定所有给定集合的交集。不存在的集合key被视为空集。当给定集合当中有一个空集时，结果也为空集(根据集合运算定律)。

语法

127.0.0.1:6379> SINTER KEY KEY1..KEYN

返回值

交集成员的列表

示例

127.0.0.1:6379> SADD myset "hello"
(integer) 1
127.0.0.1:6379> SADD myset "foo"
(integer) 1
127.0.0.1:6379> SADD myset "bar"
(integer) 1
127.0.0.1:6379> SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "world"
(integer) 1
127.0.0.1:6379> SINTER myset myset2
1) "hello"

Redis Sinterstore命令

Redis Sinterstore命令将给定集合之间的交集存储在指定的集合中。如果指定的集合已经存在，则将其覆盖。

语法

127.0.0.1:6379> SINTERSTORE DESTINATION_KEY KEY KEY1..KEYN

返回值

交集成员的列表

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "foo"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "world"
(integer) 1
127.0.0.1:6379> SINTERSTORE myset myset1 myset2
(integer) 1
127.0.0.1:6379> SMEMBERS myset
1) "hello"

Redis Sismember命令

Redis Sismember命令判断成员元素是否是集合的成员。

语法

127.0.0.1:6379> SISMEMBER KEY VALUE

返回值

• 如果成员元素是集合的成员，返回1
• 如果成员元素不是集合的成员，或key不存在，返回0

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SISMEMBER myset1 "hello"
(integer) 1
127.0.0.1:6379> SISMEMBER myset1 "world"
(integer) 0

Redis Smembers命令

Redis Smembers命令返回集合中的所有的成员。不存在的集合key被视为空集合。

语法

127.0.0.1:6379> SMEMBERS KEY_NAME

返回值

集合中的所有成员

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SMEMBERS myset1
1) "World"
2) "Hello"

Redis Smove命令

Redis Smove命令将指定成员member元素从source集合移动到destination集合。SMOVE是原子性操作。

如果source集合不存在或不包含指定的member元素，则 SMOVE 命令不执行任何操作，仅返回0。否则，member元素从source集合中被移除，并添加到destination集合中去。

当destination集合已经包含member元素时，SMOVE命令只是简单地将source集合中的member元素删除。

当source或destination不是集合类型时，返回一个错误。

语法

127.0.0.1:6379> SMOVE SOURCE DESTINATION MEMBER

返回值

• 如果成员元素被成功移除，返回1
• 如果成员元素不是source集合的成员，并且没有任何操作对destination集合执行，那么返回0

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SADD myset2 "foo"
(integer) 1
127.0.0.1:6379> SMOVE myset1 myset2 "bar"
(integer) 1
127.0.0.1:6379> SMEMBERS myset1
1) "World"
2) "Hello"
127.0.0.1:6379> SMEMBERS myset2
1) "foo"
2) "bar"

Redis Spop命令

Redis Spop命令用于移除并返回集合中的一个随机元素。

语法

127.0.0.1:6379> SPOP KEY_NAME

返回值

• 被移除的随机元素
• 当集合不存在或是空集时，返回nil

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SPOP myset1
"bar"
127.0.0.1:6379> SMEMBERS myset1
1) "Hello"
2) "world"

Redis Srandmember命令

Redis Srandmember命令用于返回集合中的一个随机元素。

从Redis 2.6版本开始，Srandmember命令接受可选的count参数：

• 如果count为正数，且小于集合基数，那么命令返回一个包含count个元素的数组，数组中的元素各不相同。如果count大于等于集合基数，那么返回整个集合。
• 如果count为负数，那么命令返回一个数组，数组中的元素可能会重复出现多次，而数组的长度为count的绝对值。

该操作和SPOP相似，但SPOP将随机元素从集合中移除并返回，而Srandmember则仅仅返回随机元素，而不对集合进行任何改动。

语法

127.0.0.1:6379> SRANDMEMBER KEY [count]

返回值

• 只提供集合key参数时，返回一个元素
• 如果集合为空，返回nil
• 如果提供了count参数，那么返回一个数组；如果集合为空，返回空数组

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SRANDMEMBER myset1
"bar"
127.0.0.1:6379> SRANDMEMBER myset1 2
1) "Hello"
2) "world"

Redis Srem命令

Redis Srem命令用于移除集合中的一个或多个成员元素，不存在的成员元素会被忽略。

当key不是集合类型，返回一个错误。

语法

127.0.0.1:6379> SREM KEY MEMBER1..MEMBERN

返回值

被成功移除的元素的数量，不包括被忽略的元素

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SREM myset1 "hello"
(integer) 1
127.0.0.1:6379> SREM myset1 "foo"
(integer) 0
127.0.0.1:6379> SMEMBERS myset1
1) "bar"
2) "world"

Redis Sunion命令

Redis Sunion命令返回给定集合的并集。不存在的集合key被视为空集。

语法

127.0.0.1:6379> SUNION KEY KEY1..KEYN

返回值

并集成员的列表

示例

127.0.0.1:6379> SADD key1 "a"
(integer) 1
127.0.0.1:6379> SADD key1 "b"
(integer) 1
127.0.0.1:6379> SADD key1 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "c"
(integer) 1
127.0.0.1:6379> SADD key2 "d"
(integer) 1
127.0.0.1:6379> SADD key2 "e"
(integer) 1
127.0.0.1:6379> SUNION key1 key2
1) "a"
2) "c"
3) "b"
4) "e"
5) "d"

Redis Sunionstore命令

Redis Sunionstore命令将给定集合的并集存储在指定的集合destination中。如果destination已经存在，则将其覆盖。

语法

127.0.0.1:6379> SUNIONSTORE DESTINATION KEY KEY1..KEYN

返回值

结果集中的元素数量

示例

127.0.0.1:6379> SADD myset1 "hello"
(integer) 1
127.0.0.1:6379> SADD myset1 "world"
(integer) 1
127.0.0.1:6379> SADD myset1 "bar"
(integer) 1
127.0.0.1:6379> SADD myset2 "hello"
(integer) 1
127.0.0.1:6379> SADD myset2 "bar"
(integer) 1
127.0.0.1:6379> SUNIONSTORE myset myset1 myset2
(integer) 1
127.0.0.1:6379> SMEMBERS myset
1) "bar"
2) "world"
3) "hello"
4) "foo"