Redis Zadd コマンド

Redis ソート済みセット（sorted set）

Redis Zadd コマンドは、1つ以上のメンバー要素とそのスコア値をソート済みセットに追加するために使用されます。

メンバーがすでにソート済みセットのメンバーである場合は、そのメンバーのスコア値を更新し、そのメンバー要素を再挿入することで、メンバーが正しい位置にあることを保証します。

スコア値は整数値または倍精度浮動小数点数です。

ソート済みセットのキーが存在しない場合は、空のソート済みセットを作成して ZADD 操作を実行します。

キーが存在するがソート済みセット型でない場合は、エラーを返します。

注意：Redis 2.4 より前のバージョンでは、ZADD は一度に1つの要素しか追加できませんでした。

構文

redis Zadd コマンドの基本構文は次のとおりです。

redis 127.0.0.1:6379> ZADD KEY_NAME SCORE1 VALUE1.. SCOREN VALUEN

利用可能なバージョン

>= 1.2.0

戻り値

正常に追加された新しいメンバーの数。更新された既存のメンバーは含まれません。

例

redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 1 "uno"
(integer) 1
redis> ZADD myzset 2 "two" 3 "three"
(integer) 2
redis> ZRANGE myzset 0 -1 WITHSCORES
1) "one"
2) "1"
3) "uno"
4) "1"
5) "two"
6) "2"
7) "three"
8) "3"
redis>

Redis ソート済みセット（sorted set）

その他の拡張