Redis集合（set）的命令操作

谁践踏了优雅 2022-06-09 09:14 262阅读 0赞

## redis 对set集合的命令操作 ##

redis的set集合是String类型的无序集合，集合元素是唯一的，

<table> 
 <tbody> 
  <tr> 
   <td> <font> sadd key value1 value2 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：对key添加一个value或多个value  
返回值：被添加到集合中的新元素的数量，不包括被忽略的元素。

<table> 
 <tbody> 
  <tr> 
   <td> <font> scard key </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：获取key对应的所有元素个数  
返回值：不存在是返回0。存在时返回集合的数量

<table> 
 <tbody> 
  <tr> 
   <td> <font> sismember key member </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：查看member元素是不是key集合的成员  
返回值：是的话返回1，不是或key集合不存在返回0

<table> 
 <tbody> 
  <tr> 
   <td> <font> smembers key </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：获取集合key的所有成员数量  
返回值：集合中的所有成员 , 不存在时返回 （empty list or set）

<table> 
 <tbody> 
  <tr> 
   <td> <font> smove source destination member </font> </td> 
  </tr> 
 </tbody> 
</table>

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

作用：随机移除key集合的一个元素，并返回  
返回值：被移除的元素， 当集合不存在或是空集的时候，返回nil

<table> 
 <tbody> 
  <tr> 
   <td> <font> srandmember key [count] </font> </td> 
  </tr> 
 </tbody> 
</table>

count: 为可选的参数  
作用： 如果 count 为正数，且小于集合基数，那么命令返回一个包含 count 个元素的数组，数组中的元素各不相同。如果 count 大于等于集合基数，那么返回整个集合。如果 count 为负数，那么命令返回一个数组，数组中的元素可能会重复出现多次，而数组的长度为 count 的绝对值。该操作和 SPOP 相似，但 SPOP 将随机元素从集合中移除并返回，而  
Srandmember 则仅仅返回随机元素，而不对集合进行任何改动。  
返回值：只提供集合 key 参数时，返回一个元素；如果集合为空，返回 nil 。 如果提供了 count 参数，那么返回一个数组；如果集合为空，返回空数组。

<table> 
 <tbody> 
  <tr> 
   <td> <font> srem key member1….member2 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：移除集合中的一个或多个元素  
返回值：被移除的元素

<table> 
 <tbody> 
  <tr> 
   <td> <font> sdiff key key1 key2 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：在集合key抛去 key1， key2分别和key两两之间的交集，剩余的部分为结果。不存在的集合视为空集  
返回值：包含差集成员的列表

<table> 
 <tbody> 
  <tr> 
   <td> <font> sdiffstore distingnation key key2 key3 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：其实就是在sdiff命令上做了修改，把这个结果放入到了集合distingnation中，若distingnation已经存在了就会被覆盖  
返回值：结果集中的个数

<table> 
 <tbody> 
  <tr> 
   <td> <font> sinter key1 key2 … key3 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：返回各个集合的交集  
返回值：结果集的成员列表

<table> 
 <tbody> 
  <tr> 
   <td> <font> sinterstore destination key1 key2 … key3 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：在sinter命令之上进行了扩展， 将各个集合的交集存储在了destination集合中，如果指定的集合已经存在，则将其覆盖  
返回值：交集成员的列表

<table> 
 <tbody> 
  <tr> 
   <td> <font>sunion key1 key2 key3 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用： 返回给定集合的并集。不存在的集合 key 被视为空集  
返回值：被移除的元素， 当集合不存在或是空集的时候，返回nil

<table> 
 <tbody> 
  <tr> 
   <td> <font> sunionstore destination key1 key2…key3 </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：将给定集合的并集存储在指定的集合 destination 中。如果 destination 已经存在，则将其覆盖  
返回值：并集的成员列表

<table> 
 <tbody> 
  <tr> 
   <td> <font> sscan key </font> </td> 
  </tr> 
 </tbody> 
</table>

作用：用于迭代集合键中的元素  
返回值：数组列表

##   ##

[sscan参考地址http://redisdoc.com/key/scan.html\#scan][sscan_http_redisdoc.com_key_scan.html_scan]  
SCAN 命令及其相关的 SSCAN 命令、 HSCAN 命令和 ZSCAN 命令都用于增量地迭代（incrementally iterate）一集元素（a collection of elements）：

SCAN 命令用于迭代当前数据库中的数据库键。
    SSCAN 命令用于迭代集合键中的元素。
    HSCAN 命令用于迭代哈希键中的键值对。
    ZSCAN 命令用于迭代有序集合中的元素（包括元素成员和元素分值）。

以上列出的四个命令都支持增量式迭代， 它们每次执行都只会返回少量元素， 所以这些命令可以用于生产环境， 而不会出现像 KEYS 命令、 SMEMBERS 命令带来的问题 —— 当 KEYS 命令被用于处理一个大的数据库时， 又或者 SMEMBERS 命令被用于处理一个大的集合键时， 它们可能会阻塞服务器达数秒之久。

不过， 增量式迭代命令也不是没有缺点的： 举个例子， 使用 SMEMBERS 命令可以返回集合键当前包含的所有元素， 但是对于 SCAN 这类增量式迭代命令来说， 因为在对键进行增量式迭代的过程中， 键可能会被修改， 所以增量式迭代命令只能对被返回的元素提供有限的保证 （offer limited guarantees about the returned elements）。

因为 SCAN 、 SSCAN 、 HSCAN 和 ZSCAN 四个命令的工作方式都非常相似， 所以这个文档会一并介绍这四个命令， 但是要记住：

SSCAN 命令、 HSCAN 命令和 ZSCAN 命令的第一个参数总是一个数据库键。
    而 SCAN 命令则不需要在第一个参数提供任何数据库键 —— 因为它迭代的是当前数据库中的所有数据库键。

SCAN 命令是一个基于游标的迭代器（cursor based iterator）： SCAN 命令每次被调用之后， 都会向用户返回一个新的游标， 用户在下次迭代时需要使用这个新游标作为 SCAN 命令的游标参数， 以此来延续之前的迭代过程。

当 SCAN 命令的游标参数被设置为 0 时， 服务器将开始一次新的迭代， 而当服务器向用户返回值为 0 的游标时， 表示迭代已结束。

以下是一个 SCAN 命令的迭代过程示例：

redis 127.0.0.1:6379> scan 0  
1) “17”  
2) 1) “key:12”  
2) “key:8”  
3) “key:4”  
4) “key:14”  
5) “key:16”  
6) “key:17”  
7) “key:15”  
8) “key:10”  
9) “key:3”  
10) “key:7”  
11) “key:1”

redis 127.0.0.1:6379> scan 17  
1) “0”  
2) 1) “key:5”  
2) “key:18”  
3) “key:0”  
4) “key:2”  
5) “key:19”  
6) “key:13”  
7) “key:6”  
8) “key:9”  
9) “key:11”

在上面这个例子中， 第一次迭代使用 0 作为游标， 表示开始一次新的迭代。

第二次迭代使用的是第一次迭代时返回的游标， 也即是命令回复第一个元素的值 —— 17 。

从上面的示例可以看到， SCAN 命令的回复是一个包含两个元素的数组， 第一个数组元素是用于进行下一次迭代的新游标， 而第二个数组元素则是一个数组， 这个数组中包含了所有被迭代的元素。

在第二次调用 SCAN 命令时， 命令返回了游标 0 ， 这表示迭代已经结束， 整个数据集（collection）已经被完整遍历过了。

以 0 作为游标开始一次新的迭代， 一直调用 SCAN 命令， 直到命令返回游标 0 ， 我们称这个过程为一次完整遍历（full iteration）。  
SCAN 命令的保证（guarantees）

SCAN 命令， 以及其他增量式迭代命令， 在进行完整遍历的情况下可以为用户带来以下保证： 从完整遍历开始直到完整遍历结束期间， 一直存在于数据集内的所有元素都会被完整遍历返回； 这意味着， 如果有一个元素， 它从遍历开始直到遍历结束期间都存在于被遍历的数据集当中， 那么 SCAN 命令总会在某次迭代中将这个元素返回给用户。

然而因为增量式命令仅仅使用游标来记录迭代状态， 所以这些命令带有以下缺点：

同一个元素可能会被返回多次。 处理重复元素的工作交由应用程序负责， 比如说， 可以考虑将迭代返回的元素仅仅用于可以安全地重复执行多次的操作上。
    如果一个元素是在迭代过程中被添加到数据集的， 又或者是在迭代过程中从数据集中被删除的， 那么这个元素可能会被返回， 也可能不会， 这是未定义的（undefined）。

SCAN 命令每次执行返回的元素数量

增量式迭代命令并不保证每次执行都返回某个给定数量的元素。

增量式命令甚至可能会返回零个元素， 但只要命令返回的游标不是 0 ， 应用程序就不应该将迭代视作结束。

不过命令返回的元素数量总是符合一定规则的， 在实际中：

对于一个大数据集来说， 增量式迭代命令每次最多可能会返回数十个元素；
    而对于一个足够小的数据集来说， 如果这个数据集的底层表示为编码数据结构（encoded data structure，适用于是小集合键、小哈希键和小有序集合键）， 那么增量迭代命令将在一次调用中返回数据集中的所有元素。

最后， 用户可以通过增量式迭代命令提供的 COUNT 选项来指定每次迭代返回元素的最大值。  
COUNT 选项

虽然增量式迭代命令不保证每次迭代所返回的元素数量， 但我们可以使用 COUNT 选项， 对命令的行为进行一定程度上的调整。

基本上， COUNT 选项的作用就是让用户告知迭代命令， 在每次迭代中应该从数据集里返回多少元素。

虽然 COUNT 选项只是对增量式迭代命令的一种提示（hint）， 但是在大多数情况下， 这种提示都是有效的。

COUNT 参数的默认值为 10 。
    在迭代一个足够大的、由哈希表实现的数据库、集合键、哈希键或者有序集合键时， 如果用户没有使用 MATCH 选项， 那么命令返回的元素数量通常和 COUNT 选项指定的一样， 或者比 COUNT 选项指定的数量稍多一些。
    在迭代一个编码为整数集合（intset，一个只由整数值构成的小集合）、 或者编码为压缩列表（ziplist，由不同值构成的一个小哈希或者一个小有序集合）时， 增量式迭代命令通常会无视 COUNT 选项指定的值， 在第一次迭代就将数据集包含的所有元素都返回给用户。

并非每次迭代都要使用相同的 COUNT 值。

用户可以在每次迭代中按自己的需要随意改变 COUNT 值， 只要记得将上次迭代返回的游标用到下次迭代里面就可以了。  
MATCH 选项

和 KEYS 命令一样， 增量式迭代命令也可以通过提供一个 glob 风格的模式参数， 让命令只返回和给定模式相匹配的元素， 这一点可以通过在执行增量式迭代命令时， 通过给定 MATCH 参数来实现。

以下是一个使用 MATCH 选项进行迭代的示例：

redis 127.0.0.1:6379> sadd myset 1 2 3 foo foobar feelsgood  
(integer) 6

redis 127.0.0.1:6379> sscan myset 0 match f\*  
1) “0”  
2) 1) “foo”  
2) “feelsgood”  
3) “foobar”

需要注意的是， 对元素的模式匹配工作是在命令从数据集中取出元素之后， 向客户端返回元素之前的这段时间内进行的， 所以如果被迭代的数据集中只有少量元素和模式相匹配， 那么迭代命令或许会在多次执行中都不返回任何元素。

以下是这种情况的一个例子：

redis 127.0.0.1:6379> scan 0 MATCH *11*  
1) “288”  
2) 1) “key:911”

redis 127.0.0.1:6379> scan 288 MATCH *11*  
1) “224”  
2) (empty list or set)

redis 127.0.0.1:6379> scan 224 MATCH *11*  
1) “80”  
2) (empty list or set)

redis 127.0.0.1:6379> scan 80 MATCH *11*  
1) “176”  
2) (empty list or set)

redis 127.0.0.1:6379> scan 176 MATCH *11* COUNT 1000  
1) “0”  
2) 1) “key:611”  
2) “key:711”  
3) “key:118”  
4) “key:117”  
5) “key:311”  
6) “key:112”  
7) “key:111”  
8) “key:110”  
9) “key:113”  
10) “key:211”  
11) “key:411”  
12) “key:115”  
13) “key:116”  
14) “key:114”  
15) “key:119”  
16) “key:811”  
17) “key:511”  
18) “key:11”

如你所见， 以上的大部分迭代都不返回任何元素。

在最后一次迭代， 我们通过将 COUNT 选项的参数设置为 1000 ， 强制命令为本次迭代扫描更多元素， 从而使得命令返回的元素也变多了。

[sscan_http_redisdoc.com_key_scan.html_scan]: http://redisdoc.com/key/scan.html#scan