Redis Zadd コマンド

Redis 有序集合(sorted set)

Redis Zadd コマンドは、一つまたは複数のメンバー要素とそのスコア値を有序集合に追加するために使用されます。

あるメンバーが既に有序集合のメンバーである場合、そのメンバーのスコア値を更新し、このメンバーを再挿入することで、そのメンバーが正しい位置に保たれます。

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

有序集合のキーが存在しない場合、空の有序集合を作成し、ZADD操作を実行します。

キーが存在するが、有序集合のタイプでない場合、エラーが返されます。

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

文法

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)