Redis数据类型--Set（集合）

Posted on | In | Visitors:

Redis的集合和列表都可以存储多个字符串，它们之间的不同在于，列表可以存储多个不同的字符串，而集合则通过使用散列来保证自己存储的每个字符串都是各不相同的。包含字符串的无序收集器（unordered collection）,并且被包含的每个字符串都是独一无二、各不相同的。
结构的读写：
 添加、读取、移除单个元素
 检查一个元素是否存在于集合中
 计算交集、并集、差集
 从集合中随机获取元素

SADD

SADD key member [member …]
 将一个或多个 member 元素加入到集合 key 当中，已经存在于集合的 member 元素将被忽略。
 假如 key 不存在，则创建一个只包含 member 元素作成员的集合。
 当 key 不是集合类型时，返回一个错误。
 在Redis2.4版本以前， SADD 只接受单个 member 值。

可用版本

版本>= 1.0.0

时间复杂度

O(N)， N 是被添加的元素的数量。

返回值

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

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
# 添加单个元素
redis> SADD bbs "discuz.net"
(integer) 1
# 添加重复元素
redis> SADD bbs "discuz.net"
(integer) 0
# 添加多个元素
redis> SADD bbs "tianya.cn" "groups.google.com"
(integer) 2
redis> SMEMBERS bbs
1) "discuz.net"
2) "groups.google.com"
3) "tianya.cn"

SCARD

SCARD key
 返回集合 key 的基数(集合中元素的数量)。

可用版本

版本>= 1.0.0

时间复杂度

O(1)

返回值

集合的基数。
当 key 不存在时，返回 0 。

示例

1
2
3
4
5
6
7
8
redis> SADD tool pc printer phone
(integer) 3
redis> SCARD tool   # 非空集合
(integer) 3
redis> DEL tool
(i
redis> SCARD tool   # 空集合
(integer) 0

SDIFF

SDIFF key [key …]
 返回一个集合的全部成员，该集合是所有给定集合之间的差集。
 不存在的 key 被视为空集。

可用版本

版本>= 1.0.0

时间复杂度

O(N)， N 是所有给定集合的成员数量之和。

返回值

交集成员的列表。

示例

1
2
3
4
5
6
7
8
9
10
11
redis> SMEMBERS peter's_movies
1) "bet man"
2) "start war"
3) "2012"
redis> SMEMBERS joe's_movies
1) "hi, lady"
2) "Fast Five"
3) "2012"
redis> SDIFF peter's_movies joe's_movies
1) "bet man"
2) "start war"

SDIFFSTORE

SDIFFSTORE destination key [key …]
 这个命令的作用和 SDIFF 类似，但它将结果保存到 destination 集合，而不是简单地返回结果集。
 如果 destination 集合已经存在，则将其覆盖。
 destination 可以是 key 本身。

可用版本

版本>= 1.0.0

时间复杂度

O(N)， N 是所有给定集合的成员数量之和。

返回值

结果集中的元素数量。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
redis> SMEMBERS joe's_movies
1) "hi, lady"
2) "Fast Five"
3) "2012"
redis> SMEMBERS peter's_movies
1) "bet man"
2) "start war"
3) "2012"
redis> SDIFFSTORE joe_diff_peter joe's_movies peter's_movies
(integer) 2
redis> SMEMBERS joe_diff_peter
1) "hi, lady"
2) "Fast Five"

SINTER

SINTER key [key …]
 返回一个集合的全部成员，该集合是所有给定集合的交集。
 不存在的 key 被视为空集。
 当给定集合当中有一个空集时，结果也为空集(根据集合运算定律)。

可用版本

版本>= 1.0.0

时间复杂度

O(N * M)， N 为给定集合当中基数最小的集合， M 为给定集合的个数。

返回值

交集成员的列表。

示例

1
2
3
4
5
6
7
8
9
redis> SMEMBERS group_1
1) "LI LEI"
2) "TOM"
3) "JACK"
redis> SMEMBERS group_2
1) "HAN MEIMEI"
2) "JACK"
redis> SINTER group_1 group_2
1) "JACK"

SINTERSTORE

SINTERSTORE destination key [key …]

 这个命令类似于 SINTER 命令，但它将结果保存到 destination 集合，而不是简单地返回结果集。
 如果 destination 集合已经存在，则将其覆盖。
 destination 可以是 key 本身。

可用版本

版本>= 1.0.0

时间复杂度

O(N * M)， N 为给定集合当中基数最小的集合， M 为给定集合的个数。

返回值

结果集中的成员数量。

示例

1
2
3
4
5
6
7
8
9
10
redis> SMEMBERS songs
1) "good bye joe"
2) "hello,peter"
redis> SMEMBERS my_songs
1) "good bye joe"
2) "falling"
redis> SINTERSTORE song_interset songs my_songs
(integer) 1
redis> SMEMBERS song_interset
1) "good bye joe"

SISMEMBER

SISMEMBER key member
 判断 member 元素是否集合 key 的成员。

可用版本

版本>= 1.0.0

时间复杂度

O(1)

返回值

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

示例

1
2
3
4
5
6
7
8
redis> SMEMBERS joe's_movies
1) "hi, lady"
2) "Fast Five"
3) "2012"
redis> SISMEMBER joe's_movies "bet man"
(integer) 0
redis> SISMEMBER joe's_movies "Fast Five"
(integer) 1

SMEMBERS

SMEMBERS key
 返回集合 key 中的所有成员。
 不存在的 key 被视为空集合。

可用版本

版本>= 1.0.0

时间复杂度

O(N)， N 为集合的基数。

返回值

集合中的所有成员。

示例

1
2
3
4
5
6
7
8
9
10
11
12
# key 不存在或集合为空
redis> EXISTS not_exists_key
(integer) 0
redis> SMEMBERS not_exists_key
(empty list or set)
# 非空集合
redis> SADD language Ruby Python Clojure
(integer) 3
redis> SMEMBERS language
1) "Python"
2) "Ruby"
3) "Clojure"

SMOVE

SMOVE source destination member
 将 member 元素从 source 集合移动到 destination 集合。
 SMOVE 是原子性操作。
 如果 source 集合不存在或不包含指定的 member 元素，则 SMOVE 命令不执行任何操作，仅返回 0 。否则， member 元素从 source 集合中被移除，并添加到 destination 集合中去。
 当 destination 集合已经包含 member 元素时， SMOVE 命令只是简单地将 source 集合中的 member 元素删除。
 当 source 或 destination 不是集合类型时，返回一个错误。

可用版本

版本>= 1.0.0

时间复杂度

O(1)

返回值

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

示例

1
2
3
4
5
6
7
8
9
10
11
redis> SMEMBERS songs
1) "Billie Jean"
2) "Believe Me"
redis> SMEMBERS my_songs
(empty list or set)
redis> SMOVE songs my_songs "Believe Me"
(integer) 1
redis> SMEMBERS songs
1) "Billie Jean"
redis> SMEMBERS my_songs
1) "Believe Me"

SPOP

SPOP key
 移除并返回集合中的一个随机元素。
 如果只想获取一个随机元素，但不想该元素从集合中被移除的话，可以使用 SRANDMEMBER 命令。

可用版本

版本>= 1.0.0

时间复杂度

O(1)

返回值

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

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
redis> SMEMBERS db
1) "MySQL"
2) "MongoDB"
3) "Redis"
redis> SPOP db
"Redis"
redis> SMEMBERS db
1) "MySQL"
2) "MongoDB"
redis> SPOP db
"MySQL"
redis> SMEMBERS db
1) "MongoDB"

SRANDMEMBER

SRANDMEMBER key [count]

 如果命令执行时，只提供了 key 参数，那么返回集合中的一个随机元素。

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

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

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

可用版本

版本>= 1.0.0

时间复杂度

只提供 key 参数时为 O(1) 。
如果提供了 count 参数，那么为 O(N) ，N 为返回数组的元素个数。

返回值

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

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# 添加元素
redis> SADD fruit apple banana cherry
(integer) 3
# 只给定 key 参数，返回一个随机元素
redis> SRANDMEMBER fruit
"cherry"
redis> SRANDMEMBER fruit
"apple"
# 给定 3 为 count 参数，返回 3 个随机元素
# 每个随机元素都不相同
redis> SRANDMEMBER fruit 3
1) "apple"
2) "banana"
3) "cherry"
# 给定 -3 为 count 参数，返回 3 个随机元素
# 元素可能会重复出现多次
redis> SRANDMEMBER fruit -3
1) "banana"
2) "cherry"
3) "apple"
redis> SRANDMEMBER fruit -3
1) "apple"
2) "apple"
3) "cherry"
# 如果 count 是整数，且大于等于集合基数，那么返回整个集合
redis> SRANDMEMBER fruit 10
1) "apple"
2) "banana"
3) "cherry"
# 如果 count 是负数，且 count 的绝对值大于集合的基数
# 那么返回的数组的长度为 count 的绝对值
redis> SRANDMEMBER fruit -10
1) "banana"
2) "apple"
3) "banana"
4) "cherry"
5) "apple"
6) "apple"
7) "cherry"
8) "apple"
9) "apple"
10) "banana"
# SRANDMEMBER 并不会修改集合内容
redis> SMEMBERS fruit
1) "apple"
2) "cherry"
3) "banana"
# 集合为空时返回 nil 或者空数组
redis> SRANDMEMBER not-exists
(nil)
redis> SRANDMEMBER not-eixsts 10
(empty list or set)

SREM

SREM key member [member …]
 移除集合 key 中的一个或多个 member 元素，不存在的 member 元素会被忽略。
 当 key 不是集合类型，返回一个错误。
 在 Redis 2.4 版本以前， SREM 只接受单个 member 值。

可用版本

版本>= 1.0.0

时间复杂度

O(N)， N 为给定 member 元素的数量。

返回值

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

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 测试数据
redis> SMEMBERS languages
1) "c"
2) "lisp"
3) "python"
4) "ruby"
# 移除单个元素
redis> SREM languages ruby
(integer) 1
# 移除不存在元素
redis> SREM languages non-exists-language
(integer) 0
# 移除多个元素
redis> SREM languages lisp python c
(integer) 3
redis> SMEMBERS languages
(empty list or set)

SUNION

SUNION key [key …]
 返回一个集合的全部成员，该集合是所有给定集合的并集。
 不存在的 key 被视为空集。

可用版本

版本>= 1.0.0

时间复杂度

O(N)， N 是所有给定集合的成员数量之和。

返回值

并集成员的列表。

示例

1
2
3
4
5
6
7
redis> SMEMBERS songs
1) "Billie Jean"
redis> SMEMBERS my_songs
1) "Believe Me"
redis> SUNION songs my_songs
1) "Billie Jean"
2) "Believe Me"

SUNIONSTORE

SUNIONSTORE destination key [key …]
 这个命令类似于 SUNION 命令，但它将结果保存到 destination 集合，而不是简单地返回结果集。
 如果 destination 已经存在，则将其覆盖。
 destination 可以是 key 本身。

可用版本

版本>= 1.0.0

时间复杂度

O(N)， N 是所有给定集合的成员数量之和。

返回值

结果集中的元素数量。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
redis> SMEMBERS NoSQL
1) "MongoDB"
2) "Redis"
redis> SMEMBERS SQL
1) "sqlite"
2) "MySQL"
redis> SUNIONSTORE db NoSQL SQL
(integer) 4
redis> SMEMBERS db
1) "MySQL"
2) "sqlite"
3) "MongoDB"
4) "Redis"

SSCAN

SSCAN key cursor [MATCH pattern] [COUNT count]
 详细信息请参考 SCAN 命令。

Adhere to the original technology to share, your support will encourage me to continue to create!