Redis ZCOUNT –スコア範囲でソートされたセットの要素数を取得する方法

このチュートリアルでは、RedisのZCOUNTコマンドを使用して、ソート済みセット（Sorted Set）に格納された要素のうち、特定のスコア範囲に該当する要素数を取得する方法を解説します。

ZCOUNTコマンドとは

ZCOUNTコマンドは、引数として渡されたmin以上かつmax以下のスコアを持つ、ソート済みセットの要素数を返すコマンドです。

デフォルトではminとmaxは閉区間（境界値を含む）として扱われますが、値の先頭に「(」を付けることで、開区間（境界値を含まない）として指定することも可能です。例えば以下のようになります。

ZCOUNT zset (1 5

上記のコマンドは「1 < スコア <= 5」を満たす要素数を返します。一方、次のコマンドの場合：

ZCOUNT zset (5 (10

こちらは「5 < スコア < 10」（5と10は含まない）を満たす要素数が返されます。

さらに、minとmaxには-inf（負の無限大）や+inf（正の無限大）を指定できます。これにより、ソート済みセット内の最高スコアや最低スコアを事前に把握していなくても、特定のスコアまで（またはそれ以降）のすべての要素を簡単に取得できるのが便利です。

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

構文

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

戻り値

- 指定したスコア範囲内の要素数を表す(integer)型の応答
- キーが存在するが、保存されている値がソート済みセット型でない場合はエラー

実行例

参考資料

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

以上が、RedisのZCOUNTコマンドを使ってスコア範囲からソート済みセットの要素数を取得する方法でした。この記事が役に立ったら、ぜひコメント欄で感想を共有したり、他の方にもシェアしてみてください。