Redis ZREVRANGEBYLEXコマンドの使い方｜辞書順降順で範囲指定してソート済みセットの要素を取得する方法

このチュートリアルでは、RedisのZREVRANGEBYLEXコマンドを使って、ソート済みセット（Sorted Set）から特定の範囲内の値を持つすべての要素を、辞書順の降順で取得する方法を解説します。

ZREVRANGEBYLEXコマンドとは

ZREVRANGEBYLEXコマンドは、指定したキーに保存されているソート済みセットの要素のうち、max引数とmin引数で指定された範囲（要素の文字列表現）に該当するすべての要素を返します。このコマンドを利用する際は、ソート済みセットのすべての要素を同じスコアで挿入し、辞書順（レキシコグラフィカル順）での並び替えを強制するのが前提となります。返される要素は、辞書順の降順で並べられます。

maxおよびmin引数は、必ず( または [ で始める必要があります。[ は閉区間（その値を含む）、( は開区間（その値を含まない）を意味します。

例えば、次のコマンドを実行すると：

ZREVRANGEBYLEX set [f [a

f >= 要素 >= a を満たすすべての要素が返されます。一方、次のコマンドの場合：

ZREVRANGEBYLEX set [f (a

f >= 要素 > a を満たすすべての要素が返されます。

また、maxとmin引数には特別な値である+や-を指定することもできます。+は正の無限大の文字列、-は負の無限大の文字列を表します。例えば、ZREVRANGEBYLEX set + - を実行すると、ソート済みセットのすべての要素が返されます。

さらに、オプションのLIMIT引数を渡すことで、offsetで指定した位置からcount個の一致する要素を取得できます。countに負の値を指定した場合は、offset以降のすべての要素が返されます。

例：

ZREVRANGEBYLEX set [f [a LIMIT 1 3
※ set = [a, b, c, d, e, f, g, h] の場合

この場合、2番目に一致する要素から3つの要素、つまり [e, d, c] が返されます。

キーが存在しない場合は空のセットが返されます。また、キーは存在するものの、その値がソート済みセット型ではない場合はエラーが返されます。

構文

redis host:post> ZREVRANGEBYLEX <keyname> <max> <min> [LIMIT offset count]

出力

- (array) reply：指定範囲内のソート済みセットの要素を表す配列
- 空のセット：キーが存在しない場合
- エラー：キーは存在するが、保存されている値がソート済みセット型ではない場合

使用例

参考資料

1. ZREVRANGEBYLEXコマンド公式ドキュメント

以上が、RedisのZREVRANGEBYLEXコマンドを使って、特定の範囲内の値を持つソート済みセットの要素を辞書順降順で取得する方法でした。この記事が役に立った場合は、ぜひコメント欄で感想を共有したり、他の方にもシェアしてください。