Redis ZREMRANGEBYSCOREコマンド徹底解説 – スコア範囲を指定してソート済みセットの要素を削除する方法

このチュートリアルでは、RedisのZREMRANGEBYSCOREコマンドを使用して、ソート済みセット（Sorted Set）から指定したスコア範囲内の要素を削除する方法を解説します。

ZREMRANGEBYSCOREコマンドとは

ZREMRANGEBYSCOREコマンドは、引数として渡されたmin（最小値）以上・max（最大値）以下のスコアを持つすべての要素を、ソート済みセットから一括で削除するコマンドです。

デフォルトではminとmaxは閉区間（境界値を含む）として扱われますが、値の先頭に(（半角括弧）を付けることで、開区間（境界値を含まない）として指定することも可能です。

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

ZREMRANGEBYSCORE set (1 5

1 < スコア <= 5 を満たすすべての要素が削除されます。

一方、次のように両方に括弧を付けると：

ZREMRANGEBYSCORE set (5 (10

5 < スコア < 10 を満たす要素のみが削除され、5と10自体は削除対象外となります。

また、minとmaxには -inf（負の無限大）や +inf（正の無限大）を指定できます。これにより、セット内の最高スコアや最低スコアを事前に把握していなくても、柔軟に範囲を指定することができます。

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

構文

redis host:port> ZREMRANGEBYSCORE <keyname> <min> <max>

戻り値

- (integer)：削除された要素の数
- 0：キーが存在しない場合
- エラー：キーは存在するが、格納されている値がソート済みセット型ではない場合

実行例

参考資料

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

以上が、RedisのZREMRANGEBYSCOREコマンドを使って、指定したスコア範囲内のソート済みセット要素を削除する方法でした。この記事が役に立ったと思ったら、ぜひコメントで感想をお聞かせください。また、他の方にもシェアしていただけると嬉しいです。