redis commands zsets zadd

ZADD

Redis 開発者教育の申込	Redis 定期点検/技術サポート Redis Technical Support	Redis エンタープライズサーバー Redis Enterprise Server

集合にデータを score とともに追加

使い方は zadd key score member です。
sadd に score が追加された形です。
score は必ず 数字でなければなりません。 文字は入力できません。

	score の整数範囲は -9007199254740992 -(2^53) から 9007199254740992 +(2^53) で、 実数範囲は Double precision floating point number です。

score member を複数入力可能

使い方は zadd key score member score member です。

score が同じなら member で sort される

member の重複は許されないが

score は update されます。ただし 0 を返すため score も update されないと誤解することがあります。

version 3.0.2 で追加されたオプション

• NX: メンバーが既にあれば更新せず、ない場合だけ追加します。
• XX: 既に存在するメンバーのスコアを更新します。
• CH: スコアを更新した場合だけ更新したメンバー数を返します。 スコアが同じなら 0 を返し、異なれば更新して 1 を返します。 戻り値にだけ影響するオプションです。
• INCR: スコアを与えた値だけ増加させます。

version 6.2.0 で追加されたオプション

• LT: 新しいスコアが現在のスコアより小さい場合だけ既存要素を更新します。
• GT: 新しいスコアが現在のスコアより大きい場合だけ既存要素を更新します。

構文

ZADD key [NX|XX] [GT|LT] [CH] [INCR] score member [score member ...]   [ex seconds]

• このコマンドは version 1.2.0 から使用できます。
• 時間計算量は O(log(N)) です。N は集合の member 個数です。
• version 2.4 以降から member を複数入力できます。
• add された member 個数を返します。
• サブクエリとメンバー自動削除機能は Enterprise サーバーで使用できます。