公式ドキュメントのZUNIONSTOREとZINTERSTOREに書いてあるけれど、図解しないとわかりにくいと思います。

前提

私のSortedSetに対する理解の仕方について

私は、SortedSetをこのように理解しているので、そのつもりでお願いします。

このページで使用する、サンプルデータ

説明用に、事前に以下のように2つのSortedSetレコードを準備したことにします。

ZADD zset1 1 "one"
ZADD zset1 2 "two"
ZADD zset1 3 "three"

ZADD zset2 11 "one"
ZADD zset2 33 "three"
ZADD zset2 44 "four"

表にすると、各レコード（変数）は以下のようになってます。

縦軸にkey、横軸にmember、値がScoreです。

基本

Union（和集合）とかIntersect（共通集合）をして、Store（保存）します。デフォだと、各レコードにあるScoreを足し算します。

ミニマルな文法は、以下の通りです。

ZUNIONSTORE destination numkeys key [key ...]
ZINTERSTORE destination numkeys key [key ...]

• distinationは、出力先のkey名
• numは、Union・IntersectしたいSortedSetの数
• keyは、Union・IntersectしたいSortedSetのKey名

ZUNIONSTORE（和集合）の例

ZUNIONSTORE union1 2 zset1 zset2

これをやると、以下の表のようになります。

SortedSetは常にScoreでソートされるので、以下のようになります。

ZRANGE union1 0 -1 WITHSCORES
1) "two"
2) "2"
3) "one"
4) "12"
5) "three"
6) "36"
7) "four"
8) "44"

ZINTERSTORE（共通集合）の例

ZINTERSTORE inter1 2 zset1 zset2

これをやると、以下の表のようになります。

どうなってるか、確認してみます。

ZRANGE inter1 0 -1 WITHSCORES
1) "one"
2) "12"
3) "three"
4) "36"

各種オプション

UNIONとINTERSECTが何かはわかったと思うので、オプションはUNIONで説明します。（公式ドキュメントも、INTERSECTの方には「UNIONのほう見て」って書いてあるし。）

WEIGHTSオプション

各keyに対するWEIGHTS（重み）オプションです。（この説明わかるのか…？）

ZUNIONSTOREとZINTERSTOREに対するWEIGHTSの文法は、以下の通りです。

ZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]]
ZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]]

…まぁ、同じですな。

• weightは、keyと同じ数になります。

WEIGHTSオプションを使うとどうなるか

以下のようにやってみましょう。

ZUNIONSTORE union2 2 zset1 zset2 WEIGHTS 2 7

これをやると、以下の表のようになります。

SortedSetは、Scoreで常にソートされるので、以下のようになります。

ZRANGE union2 0 -1 WITHSCORES
1) "two"
2) "4"
3) "one"
4) "79"
5) "three"
6) "237"
7) "four"
8) "308"

AGGREGATEオプション

「基本」の説明で、以下のように書きました。

デフォだと、各レコードにあるScoreを足し算します。

この挙動を変更するオプションです。

このオプションの文法は、以下の通りです。

ZINTERSTORE destination numkeys key [key ...] [AGGREGATE SUM|MIN|MAX]
ZUNIONSTORE destination numkeys key [key ...] [AGGREGATE SUM|MIN|MAX]

例によって、同じです。

AGGREGATEオプションを使うとどうなるか

以下のようにやってみましょう。

ZUNIONSTORE union3 2 zset1 zset2 AGGREGATE MIN

AGGREGATE MIN としているので、小さいほうが選ばれます。

ZRANGE union3 0 -1 WITHSCORES
1) "one"
2) "1"
3) "two"
4) "2"
5) "three"
6) "3"
7) "four"
8) "44"

全部合わせてみる

最後に、4つのSortedSetに対して、適当にWEIGHTSとAGGREGATE MAXを使った場合の例を載せておきます。

ZADD zset1 1 "one"
ZADD zset1 2 "two"
ZADD zset1 3 "three"

ZADD zset2 11 "one"
ZADD zset2 33 "three"
ZADD zset2 44 "four"

ZADD zset3 12 "one"
ZADD zset3 inf "three"
ZADD zset3 0 "four"

ZADD zset4 inf "one"
ZADD zset4 33 "three"


ZINTERSTORE inter4 4 zset1 zset2 zset3 zset4 WEIGHTS 13 1 1 0 AGGREGATE MAX

ZRANGE inter4 0 -1 WITHSCORES
1) "one"
2) "13"
3) "three"
4) "inf"

なるほど、WEIGHTSの演算結果で、Scoreの大きさを比較するんですね。

おわり