Redis ZLEXCOUNTコマンドの使い方 – 辞書順の範囲でソート済みセットの要素数を取得する方法

このチュートリアルでは、RedisのZLEXCOUNTコマンドを使って、指定した範囲内の値を持つソート済みセット（Sorted Set）の要素数を取得する方法を解説します。

ZLEXCOUNTコマンドとは

ZLEXCOUNTコマンドは、ソート済みセットに格納された要素のうち、min（最小値）とmax（最大値）の引数で指定した範囲に含まれる要素（要素の文字列表現）の数を返します。

このコマンドを利用する際は、ソート済みセットのすべての要素に同じスコアを挿入しておく必要があります。こうすることで、スコアではなく要素そのものの辞書順（レキシコグラフィカル順）による並び替えが強制されます。

範囲指定のルール

minおよびmax引数は、必ず(または[で始める必要があります。

• [ … 閉区間（指定した値を含む）
• ( … 開区間（指定した値を含まない）

たとえば、次のコマンドは「a ≤ 要素 ≤ f」に該当する要素数を返します。

ZLEXCOUNT set [a [f

一方、次のコマンドは「a ≤ 要素 ＜ f」に該当する要素数を返します。

ZLEXCOUNT set [a (f

また、minとmaxには特別な値として+と-を指定できます。+は正の無限大の文字列、-は負の無限大の文字列を表します。たとえば、ZLEXCOUNT set - +を実行すると、ソート済みセット全体のサイズ（全要素数）が返されます。

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

構文

redis host:post> ZLEXCOUNT <keyname> <min> <max>

戻り値

- 指定した範囲内の要素数を表す整数値
- エラー：キーが存在するが、保存されている値がソート済みセット型でない場合

実行例

参考資料

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

以上、RedisのZLEXCOUNTコマンドを使って、指定した範囲内の値を持つソート済みセットの要素数を取得する方法について解説しました。この記事が役に立った場合は、ぜひコメント欄でご意見をお聞かせください。また、周りの方にもシェアしていただけると嬉しいです。