Tair (Redis® OSS-Compatible):exZset

コマンド

構文

説明

EXZADD

EXZADD key [NX|XX] [CH] [INCR] score member [score member ...]

指定されたスコアとメンバー情報を TairZset キーに格納します。複数のスコアとメンバーをサポートします。

EXZINCRBY

EXZINCRBY key increment member

TairZset キー内のメンバーのスコアを増分させます。increment はスコアに加算する値です。

EXZSCORE

EXZSCORE key member

TairZset キー内のメンバーのスコアを返します。キーまたはメンバーが存在しない場合、システムは nil を返します。

EXZRANGE

EXZRANGE key min max [WITHSCORES]

TairZset キー内の指定された範囲の要素を返します。

EXZREVRANGE

EXZREVRANGE key min max [WITHSCORES]

TairZset キー内の指定された範囲の要素を返します。要素はスコアの高い順にソートされます。同じスコアの要素は、逆辞書式順序でソートされます。

EXZRANGEBYSCORE

EXZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]

TairZset キー内で、スコアが min 以上かつ max 以下のすべての要素を返します。要素はスコアの低い順にソートされます。同じスコアの要素は、辞書式順序でソートされます。

EXZREVRANGEBYSCORE

EXZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]

TairZset キー内で、スコアが min 以上かつ max 以下のすべての要素を返します。デフォルトの TairZset ソートとは異なり、このコマンドは要素をスコアの高い順にソートします。同じスコアの要素は、逆辞書式順序でソートされます。

EXZRANGEBYLEX

EXZRANGEBYLEX key min max [LIMIT offset count]

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で min と max の間にある要素を返します。

EXZREVRANGEBYLEX

EXZREVRANGEBYLEX key max min [LIMIT offset count]

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で max と min の間にある要素を返します。

EXZREM

EXZREM key member [member ...]

キーから指定されたメンバーを削除します。指定されたメンバーが存在しない場合は無視します。

EXZREMRANGEBYSCORE

EXZREMRANGEBYSCORE key min max

TairZset キーから、スコアが min 以上かつ max 以下の要素を削除します。

EXZREMRANGEBYRANK

EXZREMRANGEBYRANK key start stop

TairZset キーから、ランクが start と stop の間にある要素を削除します。

EXZREMRANGEBYLEX

EXZREMRANGEBYLEX key min max

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で max と min の間にある要素を削除します。

EXZCARD

EXZCARD key

TairZset キーのカーディナリティ (要素数) を返します。

EXZRANK

EXZRANK key member

TairZset キー内のメンバーのランクを、スコアの低い順にソートして返します。ランク (またはインデックス) は 0 から始まり、最もスコアの低いメンバーのランクが 0 になります。

EXZREVRANK

EXZREVRANK key member

TairZset キー内のメンバーのランクを返します。結果はスコアの高い順にソートされます。ランク (またはインデックス) は 0 から始まり、最もスコアの高いメンバーのランクが 0 になります。

EXZCOUNT

EXZCOUNT key min max

TairZset キー内で、スコアが min と max の間にある要素の数を返します。

EXZLEXCOUNT

EXZLEXCOUNT key min max

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で値が min と max の間にある要素の数を返します。

EXZRANKBYSCORE

EXZRANKBYSCORE key score

EXZREVRANKBYSCORE

EXZREVRANKBYSCORE key score

DEL

DEL key [key ...]

ネイティブの Redis DEL コマンドを使用して、1 つ以上の TairZset データエントリを削除します。

カテゴリ

説明

構文

EXZADD key [NX|XX] [CH] [INCR] score member [score member ...]

時間計算量

O(N)

コマンドの説明

指定されたスコアとメンバー情報を TairZset キーに格納します。複数のスコアとメンバーをサポートします。システムは、キーとメンバーが存在するかどうかに基づいて、異なる戦略を適用します。

• 指定されたキーまたはメンバーが存在しない場合、システムはそれを作成し、スコアを挿入します。

• 指定されたキーまたはメンバーが既に存在する場合、システムはスコアを更新 (上書き) します。

• 各スコアは、倍精度浮動小数点数の文字列表現です。+inf と -inf は有効な値です。

オプション

• NX：新しい要素のみを追加します。既存の要素は更新しません。

• XX：既存の要素のみを更新します。新しい要素は追加しません。

• CH：通常、このコマンドは追加された新しい要素の数を返します。このパラメーターを使用すると、戻り値が変更された要素の総数に変わります。

  説明

  変更された要素には、新しい要素とスコアが更新された既存の要素が含まれます。したがって、コマンドラインで既存の要素のスコアが変更されない場合、それは変更された要素としてカウントされません。

• INCR：このオプションを指定すると、EXZADD は EXZINCRBY のように動作します。このモードでは、1 つのスコアと 1 つの要素のみを指定できます。

戻り値

整数を返します。

• オプションが指定されていない場合、戻り値はキーに追加された要素の数です (スコアのみが更新された要素は除く)。

• CH オプションが指定されている場合、戻り値は変更された要素 (新規または更新) の数です。

• INCR オプションが指定されている場合、戻り値はメンバーの新しいスコア (文字列として) です。多次元スコアが使用されている場合、メンバーのスコアフォーマットは "score1#score2#score3#..." となります (例：2#0#6)。

  説明

  操作が停止した場合 (コマンドに XX または NX オプションが含まれる場合)、nil を返します。

例

カテゴリ

説明

構文

EXZINCRBY key increment member

時間計算量

O(log(N))

コマンドの説明

TairZset キー内のメンバーのスコアを増分させます。increment はスコアに加算する値です。システムは、キーとメンバーが存在するかどうかに基づいて、異なる戦略を適用します。

• 指定されたキーまたはメンバーが存在しない場合、システムはそれを作成し、スコアを挿入します。

• 指定されたキーまたはメンバーが既に存在する場合、システムはスコアを更新 (増分) します。

• 各スコアは、倍精度浮動小数点数の文字列表現です。+inf と -inf は有効な値です。

オプション

なし

戻り値

メンバーの新しいスコア (文字列として) を返します。多次元スコアが使用されている場合、メンバーのスコアフォーマットは "score1#score2#score3#..." となります (例：2#0#6)。

例

コマンド例：

EXZINCRBY testkey 2#2#1 a

戻り値の例：

"3#2#4"

カテゴリ

説明

構文

EXZSCORE key member

時間計算量

O(1)

コマンドの説明

TairZset キー内のメンバーのスコアを返します。キーまたはメンバーが存在しない場合、システムは nil を返します。

オプション

なし

戻り値

メンバーのスコア (文字列として) を返します。多次元スコアが使用されている場合、メンバーのスコアフォーマットは "score1#score2#score3#..." となります (例：2#0#6)。

例

コマンド例：

EXZSCORE testkey a

戻り値の例：

"3#2#4"

カテゴリ

説明

構文

EXZRANGE key min max [WITHSCORES]

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M は返される要素数です。

コマンドの説明

TairZset キー内の指定された範囲の要素を返します。

オプション

• min、max：これらは 0 から始まるインデックス値を表します。最初の要素のインデックス値は 0、2 番目の要素は 1、というようになります。これら 2 つのパラメーターを使用して閉区間を指定します。

  説明

  • インデックス値が負の場合、返される要素の末尾からのオフセットを表します。たとえば、-1 はキーの最後の要素、-2 は最後から 2 番目の要素を表します。

  • すべての要素情報をクエリするには、min を 0 に、max を -1 に設定します。

  • min の値がキーの最後の要素のインデックス値または max の値より大きい場合、空のリストが返されます。

• WITHSCORES：戻り値には要素のスコアが含まれます。返されるリストのデータ形式は value1, score1, ..., valueN, scoreN です。例：

  1) "b"
  2) "1#0#2"
  3) "a"
  4) "3#2#4"

戻り値

指定された範囲内の要素のリストを返します。WITHSCORES オプションが使用されている場合、戻り値には要素のスコアが含まれます。

例

コマンド例：

EXZRANGE testkey 0 -1 WITHSCORES

戻り値の例：

1) "b"
2) "1#0#2"
3) "a"
4) "3#2#4"

カテゴリ

説明

構文

EXZREVRANGE key min max [WITHSCORES]

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M は返される要素数です。

コマンドの説明

TairZset キー内の指定された範囲の要素を返します。要素はスコアの高い順にソートされます。同じスコアの要素は、逆辞書式順序でソートされます。

オプション

• min、max：これらは 0 から始まるインデックス値を表します。最初の要素のインデックス値は 0、2 番目の要素は 1、というようになります。これら 2 つのパラメーターを使用して閉区間を指定します。

  説明

  • インデックス値が負の場合、返される要素の末尾からのオフセットを表します。たとえば、-1 はキーの最後の要素、-2 は最後から 2 番目の要素を表します。

  • すべての要素情報をクエリするには、min を 0 に、max を -1 に設定します。

  • min の値がキーの最後の要素のインデックス値または max の値より大きい場合、空のリストが返されます。

• WITHSCORES：戻り値には要素のスコアが含まれます。返されるリストのデータ形式は value1, score1, ..., valueN, scoreN です。例：

  1) "b"
  2) "1#0#2"
  3) "a"
  4) "3#2#4"

戻り値

指定された範囲内の要素のリストを返します。WITHSCORES オプションが使用されている場合、戻り値には要素のスコアが含まれます。

例

コマンド例：

EXZREVRANGE testkey 0 -1 WITHSCORES

戻り値の例：

1) "a"
2) "3#2#4"
3) "b"
4) "1#0#2"

カテゴリ

説明

構文

EXZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count]

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M は返される要素数です。

コマンドの説明

TairZset キー内で、スコアが min 以上かつ max 以下のすべての要素を返します。要素はスコアの低い順にソートされます。同じスコアの要素は、辞書式順序でソートされます。

オプション

• min、max：それぞれ最小スコアと最大スコアを表します。キー内の要素が多次元スコアを使用する場合、各次元のスコアをハッシュ記号 (#) で区切ります。

  説明

  • キー内の要素の最高スコアと最低スコアが不明で、特定の値以上のスコアまたは以下のスコアを持つ要素をクエリしたい場合は、min を負の無限大 (-inf) に、max を正の無限大 (+inf) に設定します。

  • デフォルトのデータ範囲は閉区間です。開区間を指定するには、スコア範囲の前に半角の丸括弧を追加します。たとえば、(1 5 は、スコアが 1 より大きく 5 以下の要素を返すことを意味します。

• WITHSCORES：戻り値には要素のスコアが含まれます。

• LIMIT offset count：返される結果の数と範囲を指定します。count が負の数の場合、オフセットからすべての要素を返します。

  説明

  offset が大きい場合、要素を返す前にオフセット要素を見つけるためにキー全体を走査します。これにより時間計算量が増加します。

戻り値

指定されたスコア範囲内の要素のリストを返します。WITHSCORES オプションが使用されている場合、戻り値には要素のスコアが含まれます。

コマンド例

コマンド例：

EXZRANGEBYSCORE testkey 0#0#0 6#6#6 WITHSCORES

戻り値の例：

1) "b"
2) "1#0#2"
3) "a"
4) "3#2#4"

カテゴリ

説明

構文

EXZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M は返される要素数です。

コマンドの説明

TairZset キー内で、スコアが min 以上かつ max 以下のすべての要素を返します。デフォルトの TairZset ソートとは異なり、このコマンドは要素をスコアの高い順にソートします。同じスコアの要素は、逆辞書式順序でソートされます。

オプション

• min、max：それぞれ最小スコアと最大スコアを表します。キー内の要素が多次元スコアを使用する場合、各次元のスコアをハッシュ記号 (#) で区切ります。

  説明

  • キー内の要素の最高スコアと最低スコアが不明で、特定の値以上のスコアまたは以下のスコアを持つ要素をクエリしたい場合は、min を負の無限大 (-inf) に、max を正の無限大 (+inf) に設定します。

  • デフォルトのデータ範囲は閉区間です。開区間を指定するには、スコア範囲の前に半角の丸括弧を追加します。たとえば、(1 5 は、スコアが 1 より大きく 5 以下の要素を返すことを意味します。

• WITHSCORES：戻り値には要素のスコアが含まれます。

• LIMIT offset count：返される結果の数と範囲を指定します。count が負の数の場合、オフセットからすべての要素を返します。

  説明

  offset が大きい場合、要素を返す前にオフセット要素を見つけるためにキー全体を走査します。これにより時間計算量が増加します。

戻り値

指定されたスコア範囲内の要素のリストを返します。WITHSCORES オプションが使用されている場合、戻り値には要素のスコアが含まれます。

コマンド例

コマンド例：

EXZREVRANGEBYSCORE testkey 6#6#6 0#0#0 WITHSCORES

戻り値の例：

1) "a"
2) "3#2#4"
3) "b"
4) "1#0#2"

カテゴリ

説明

構文

EXZRANGEBYLEX key min max [LIMIT offset count]

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M は返される要素数です。

コマンドの説明

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で min と max の間にある要素を返します。

オプション

• min、max：それぞれ最小メンバー名と最大メンバー名 (文字列として) を表します。文字範囲を指定します。例：

  • 開区間：値の前に半角の丸括弧を追加します (例：(a)。

  • 閉区間：値の前に角括弧を追加します (例：[a)。

  説明

  正の無限大と負の無限大は、それぞれ + と - です。

• LIMIT offset count：返される結果の数と範囲を指定します。count が負の数の場合、オフセットからすべての要素を返します。

  説明

  offset が大きい場合、要素を返す前にオフセット要素を見つけるためにキー全体を走査します。これにより時間計算量が増加します。

戻り値

名前が指定された範囲内にある要素のリストを返します。

コマンド例

コマンド例：

EXZRANGEBYLEX zzz [a [b

戻り値の例：

1) "aba"
2) "abc"

カテゴリ

説明

構文

EXZREVRANGEBYLEX key max min [LIMIT offset count]

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M は返される要素数です。

コマンドの説明

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で max と min の間にある要素を返します。

オプション

• min、max：それぞれ最小メンバー名と最大メンバー名 (文字列として) を表します。文字範囲を指定します。例：

  • 開区間：値の前に半角の丸括弧を追加します (例：(a)。

  • 閉区間：値の前に角括弧を追加します (例：[a)。

  説明

  正の無限大と負の無限大は、それぞれ + と - です。

• LIMIT offset count：返される結果の数と範囲を指定します。count が負の数の場合、オフセットからすべての要素を返します。

  説明

  offset が大きい場合、要素を返す前にオフセット要素を見つけるためにキー全体を走査します。これにより時間計算量が増加します。

戻り値

名前が指定された範囲内にある要素のリストを返します。

コマンド例

コマンド例：

EXZREVRANGEBYLEX zzz [b [a

戻り値の例：

1) "abc"
2) "aba"

カテゴリ

説明

構文

EXZREM key member [member ...]

時間計算量

O(M*log(N))。ここで、N は TairZset 内の要素数、M は削除する要素数です。

コマンドの説明

キーから指定されたメンバーを削除します。指定されたメンバーが存在しない場合は無視します。

オプション

なし

戻り値

キーから削除されたメンバーの数を返します (存在しないメンバーは除く)。

コマンド例

コマンド例：

EXZREM testkey a

戻り値の例：

(integer) 1

カテゴリ

説明

構文

EXZREMRANGEBYSCORE key min max

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M は削除する要素数です。

コマンドの説明

TairZset キーから、スコアが min 以上かつ max 以下の要素を削除します。

オプション

min と max は、それぞれ最小スコアと最大スコアを表します。キー内の要素が多次元スコアを使用する場合、各次元のスコアをハッシュ記号 (#) で区切ります。

戻り値

削除された要素の数を返します。

コマンド例

コマンド例：

EXZREMRANGEBYSCORE testkey 3#2#4 6#6#6

戻り値の例：

(integer) 1

カテゴリ

説明

構文

EXZREMRANGEBYRANK key start stop

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M はこの操作によって削除された要素数です。

コマンドの説明

TairZset キーから、ランクが start と stop の間にある要素を削除します。

オプション

start と stop は 0 から始まるインデックス値で、0 は最もスコアの低い要素を表します。負のインデックス値は、最もスコアの高い要素からのオフセットを表します。たとえば、-1 は最もスコアの高い要素、-2 は 2 番目に高いスコアの要素、というようになります。

戻り値

削除された要素の数を返します。

コマンド例

コマンド例：

EXZREMRANGEBYRANK testkey 0 1EXZREVRANGEBYSCORE

戻り値の例：

(integer) 1

カテゴリ

説明

構文

EXZREMRANGEBYLEX key min max

時間計算量

O(log(N)+M)。ここで、N は TairZset 内の要素数、M はこの操作によって削除された要素数です。

コマンドの説明

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で max と min の間にある要素を削除します。

オプション

min、max：それぞれ最小メンバー名と最大メンバー名 (文字列として) を表します。文字範囲を指定します。例：

• 開区間：値の前に半角の丸括弧を追加します (例：(a)。

• 閉区間：値の前に角括弧を追加します (例：[a)。

戻り値

削除された要素の数。

コマンド例

コマンド例：

EXZREMRANGEBYLEX [a [b

戻り値の例：

(integer) 2

カテゴリ

説明

構文

EXZCARD key

時間計算量

O(1)

コマンドの説明

TairZset キーのカーディナリティ (要素数) を返します。

オプション

なし

戻り値

キー内の要素の数を返します。キーが存在しない場合は 0 を返します。

コマンド例

コマンド例：

EXZCARD testkey

戻り値の例：

(integer) 2

カテゴリ

説明

構文

EXZRANK key member

時間計算量

O(log(N))

コマンドの説明

TairZset キー内のメンバーのランクを、スコアの低い順にソートして返します。ランク (またはインデックス) は 0 から始まり、最もスコアの低いメンバーのランクが 0 になります。

オプション

なし

戻り値

• 指定されたメンバーがキーに存在する場合、メンバーのランク (整数) を返します。

• キーまたはメンバーが見つからない場合、nil が返されます。

コマンド例

コマンド例：

EXZRANK testkey b

戻り値の例：

(integer) 0

カテゴリ

説明

構文

EXZREVRANK key member

時間計算量

O(log(N))

コマンドの説明

TairZset キー内のメンバーのランクを返します。結果はスコアの高い順にソートされます。ランク (またはインデックス) は 0 から始まり、最もスコアの高いメンバーのランクが 0 になります。

オプション

なし

戻り値

• 指定されたメンバーがキーに存在する場合、メンバーのランク (整数) を返します。

• キーまたはメンバーが見つからない場合、nil が返されます。

コマンド例

コマンド例：

EXZREVRANK testkey b

戻り値の例：

(integer) 1

カテゴリ

説明

構文

EXZCOUNT key min max

時間計算量

O(log(N))。ここで、N は TairZset 内の要素数です。

コマンドの説明

TairZset キー内で、スコアが min と max の間にある要素の数を返します。

オプション

min、max：それぞれ最小スコアと最大スコアを表します。キー内の要素が多次元スコアを使用する場合、各次元のスコアをハッシュ記号 (#) で区切ります。

戻り値

指定されたスコア範囲内の要素の数 (整数) を返します。

コマンド例

コマンド例：

EXZCOUNT testkey (1#0#2 6#6#6

戻り値の例：

(integer) 1

カテゴリ

説明

構文

EXZLEXCOUNT key min max

時間計算量

O(log(N))。ここで、N は TairZset 内の要素数です。

コマンドの説明

辞書式順序を保証するため、キー内のすべての要素が同じスコアを持つ場合、このコマンドはキー内で値が min と max の間にある要素の数を返します。

オプション

min、max：それぞれ最小メンバー名と最大メンバー名 (文字列として) を表します。文字範囲を指定します。例：

• 開区間：値の前に半角の丸括弧を追加します (例：(a)。

• 閉区間：値の前に角括弧を追加します (例：[a)。

戻り値

指定されたスコア範囲内の要素の数 (整数) を返します。

コマンド例

コマンド例：

EXZLEXCOUNT zzz [a [b

戻り値の例：

(integer) 2

カテゴリ

説明

構文

EXZRANKBYSCORE key score

時間計算量

O(log(N))

コマンドの説明

オプション

なし

戻り値

キー内の指定されたスコアのランクを返します。

コマンド例

コマンド例：

EXZRANKBYSCORE testkey 2#0#2 

戻り値の例：

(integer) 1

カテゴリ

説明

構文

EXZREVRANKBYSCORE key score

時間計算量

O(log(N))

コマンドの説明

オプション

なし

戻り値

キー内の指定されたスコアのランクを返します。

コマンド例

コマンド例：

EXZREVRANKBYSCORE testkey 2#0#2 

戻り値の例：

(integer) 1