Tair (Redis® OSS-Compatible):exHash

パラメーター

説明

構文

EXHSETキーフィールド値 [EX time] [EXAT time] [PX time] [PXAT time] [NX | XX] [VER | ABSバージョン] [KEEPTL]

時間の複雑さ

O(1)

コマンド説明

TairHashキーにフィールドを追加します。 キーが存在しない場合は、キーが作成されます。 フィールドがすでに存在する場合、このコマンドはフィールドの現在の値を上書きします。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• value: フィールドの値。 フィールドは単一の値のみを持つことができます。

• EX: フィールドの相対的な有効期限。 単位は秒です。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• EXAT: フィールドの絶対有効期限。 単位は秒です。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• PX: フィールドの相対的な有効期限。 単位：ミリ秒。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• PXAT: フィールドの絶対有効期限。 単位：ミリ秒。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• NX: フィールドが存在しない場合にのみフィールドを追加することを指定します。

• XX: フィールドが存在する場合にのみフィールドを追加することを指定します。

• VER: フィールドのバージョン番号。

  • フィールドが存在する場合、このパラメーターで指定されたバージョン番号は現在のバージョン番号と照合されます。

    • バージョン番号が一致すると、システムはコマンドを実行し続け、バージョン番号を1だけ増やします。

    • バージョン番号が一致しない場合、エラーメッセージが返されます。

  • フィールドが存在しない場合、またはフィールドの現在のバージョン番号が0の場合、このパラメーターは無視され、このコマンドは引き続き実行されます。 操作が成功すると、バージョン番号は1に設定されます。

• ABS: フィールドがすでに存在するかどうかに関係なく、フィールドが追加されたときにフィールドに割り当てることができる絶対バージョン番号。

• KEPTTL: EX、EXAT、PX、およびPXATパラメーターのいずれも指定されていない場合、フィールドの現在の有効期間 (TTL) を保持します。

  説明

  デフォルトでは、KEEPTTLパラメーターが指定されていない場合、EXHSETコマンドはフィールドの現在のTTLを削除します。

Output

• フィールドが作成され、そのフィールドに値が設定されている場合、値1が返されます。

• フィールドがすでに存在し、指定された値がフィールドの現在の値を上書きする場合、値0が返されます。

• XXパラメーターが指定され、フィールドが存在しない場合、-1の値が返されます。

• NXパラメーターが指定され、フィールドが存在する場合、-1の値が返されます。

• VERパラメーターが指定され、VER値が現在のバージョン番号と一致しない場合、「ERR update version is stale」メッセージが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHSET myhash field1 val EX 10

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHGETキーフィールド

時間の複雑さ

O(1)

コマンド説明

TairHashキーからフィールドの値を取得します。 キーまたはフィールドが存在しない場合、nilが返されます。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• フィールドが存在し、操作が成功した場合、フィールドの値が返されます。

• キーまたはフィールドが存在しない場合、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHSET myhash field1 valコマンドは事前に実行されます。

サンプルコマンド:

EXHGET myhash field1

サンプル出力：

"val"

パラメーター

説明

構文

EXHMSETキーフィールド値 [フィールド値...]

時間の複雑さ

O(N)

コマンド説明

TairHashキーに複数のフィールドを追加します。 キーが存在しない場合は、キーが作成されます。 これらのフィールドがすでにキーに存在する場合、このコマンドはこれらのフィールドの値を上書きします。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• value: フィールドの値。 フィールドは単一の値のみを持つことができます。

Output

• 操作が成功した場合、OKが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHMSET myhash field1 val1 field2 val2

サンプル出力：

OK

パラメーター

説明

構文

EXHPEXPIREATキーフィールドミリ秒-timestamp [VER | ABSバージョン]

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドの絶対有効期限を指定します。 単位：ミリ秒。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• ミリ秒-timestamp: ミリ秒の正確なUNIXタイムスタンプ。

• VER: フィールドのバージョン番号。

  • フィールドが存在する場合、このパラメーターで指定されたバージョン番号は現在のバージョン番号と照合されます。

    • バージョン番号が一致すると、システムはコマンドを実行し続け、バージョン番号を1だけ増やします。

    • バージョン番号が一致しない場合、エラーメッセージが返されます。

  • フィールドが存在しない場合、またはフィールドの現在のバージョン番号が0の場合、このパラメーターは無視され、このコマンドは引き続き実行されます。 操作が成功すると、バージョン番号は1に設定されます。

• ABS: フィールドの絶対バージョン番号。 このパラメーターを設定すると、フィールドがすでに存在するかどうかに関係なく、フィールドが強制的にキーに追加されます。 フィールドが追加されると、バージョン番号は指定されたABS値に設定されます。

Output

• フィールドが存在し、値がフィールドに設定されている場合、値1が返されます。

• フィールドが存在しない場合、0の値が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHPEXPIREAT myhash field1 1293840000

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHPEXPIREキーフィールドミリ秒 [VER | ABSバージョン]

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドの相対有効期限を指定します。 単位：ミリ秒。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• ミリ秒: 相対的な有効期限。 単位：ミリ秒。

• VER: フィールドのバージョン番号。

  • フィールドが存在する場合、このパラメーターで指定されたバージョン番号は現在のバージョン番号と照合されます。

    • バージョン番号が一致すると、システムはコマンドを実行し続け、バージョン番号を1だけ増やします。

    • バージョン番号が一致しない場合、エラーメッセージが返されます。

  • フィールドが存在しない場合、またはフィールドの現在のバージョン番号が0の場合、このパラメーターは無視され、このコマンドは引き続き実行されます。 操作が成功すると、バージョン番号は1に設定されます。

• ABS: フィールドの絶対バージョン番号。 このパラメーターを設定すると、フィールドがすでに存在するかどうかに関係なく、フィールドが強制的にキーに追加されます。 フィールドが追加されると、バージョン番号は指定されたABS値に設定されます。

Output

• フィールドが存在し、値がフィールドに設定されている場合、値1が返されます。

• フィールドが存在しない場合、0の値が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHPEXPIRE myhash field1 1000

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHEXPIREATキーフィールドtimestamp [VER | ABSバージョン]

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドの絶対有効期限を指定します。 単位は秒です。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• timestamp: 1秒まで正確なUNIXタイムスタンプ。

• VER: フィールドのバージョン番号。

  • フィールドが存在する場合、このパラメーターで指定されたバージョン番号は現在のバージョン番号と照合されます。

    • バージョン番号が一致すると、システムはコマンドを実行し続け、バージョン番号を1だけ増やします。

    • バージョン番号が一致しない場合、エラーメッセージが返されます。

  • フィールドが存在しない場合、またはフィールドの現在のバージョン番号が0の場合、このパラメーターは無視され、このコマンドは引き続き実行されます。 操作が成功すると、バージョン番号は1に設定されます。

• ABS: フィールドの絶対バージョン番号。 このパラメーターを設定すると、フィールドがすでに存在するかどうかに関係なく、フィールドが強制的にキーに追加されます。 フィールドが追加されると、バージョン番号は指定されたABS値に設定されます。

Output

• フィールドが存在し、値がフィールドに設定されている場合、値1が返されます。

• フィールドが存在しない場合、0の値が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHEXPIREAT myhash field1 1293840000

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHEXPIREキーフィールド秒 [VER | ABSバージョン]

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドの相対有効期限を指定します。 単位は秒です。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• 秒: 相対的な有効期限。 単位は秒です。

• VER: フィールドのバージョン番号。

  • フィールドが存在する場合、このパラメーターで指定されたバージョン番号は現在のバージョン番号と照合されます。

    • バージョン番号が一致すると、システムはコマンドを実行し続け、バージョン番号を1だけ増やします。

    • バージョン番号が一致しない場合、エラーメッセージが返されます。

  • フィールドが存在しない場合、またはフィールドの現在のバージョン番号が0の場合、このパラメーターは無視され、このコマンドは引き続き実行されます。 操作が成功すると、バージョン番号は1に設定されます。

• ABS: フィールドの絶対バージョン番号。 このパラメーターを設定すると、フィールドがすでに存在するかどうかに関係なく、フィールドが強制的にキーに追加されます。 フィールドが追加されると、バージョン番号は指定されたABS値に設定されます。

Output

• フィールドが存在し、値がフィールドに設定されている場合、値1が返されます。

• フィールドが存在しない場合、0の値が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHEXPIRE myhash field1 100

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHPTTLキーフィールド

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドのTTLを照会します。 単位：ミリ秒。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• フィールドが存在し、フィールドにTTLが設定されていない場合、-1の値が返されます。

• キーまたはフィールドが存在しない場合、-2の値が返されます。

• フィールドが存在しない場合、-3の値が返されます。

• フィールドが存在し、フィールドにTTLが設定されている場合、TTLが返されます。 単位：ミリ秒。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHSET myhash field1 val1 EX 100コマンドは事前に実行されます。

サンプルコマンド:

EXHPTTL myhash field1

サンプル出力：

(integer) 97213

パラメーター

説明

構文

EXHTTLキーフィールド

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドのTTLを照会します。 単位は秒です。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーまたはフィールドが存在しない場合、-2の値が返されます。

• フィールドが存在し、フィールドにTTLが設定されていない場合、-1の値が返されます。

• フィールドが存在し、フィールドにTTLが設定されている場合、TTLが返されます。 単位は秒です。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHSET myhash field1 val1 EX 100コマンドは事前に実行されます。

サンプルコマンド:

EXHTTL myhash field1

サンプル出力：

(integer) 85

パラメーター

説明

構文

EXHVERキーフィールド

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドの現在のバージョン番号を照会します。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーが存在しない場合、-1の値が返されます。

• フィールドが存在しない場合、-2の値が返されます。

• 操作が成功した場合、フィールドのバージョン番号が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHVER myhash field1

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHSETVERキーフィールドのバージョン

時間の複雑さ

O(1)

コマンド説明

TairHashキーのフィールドのバージョン番号を指定します。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーまたはフィールドが存在しない場合、値0が返されます。

• バージョン番号が指定されている場合、値1が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHSETVER myhash field1 3

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHINCRBYキーフィールドnum [EX time] [EXAT time] [PX time] [PXAT time] [VER | ABSバージョン] [MIN minval] [MAX maxval] [KEPTTL]

時間の複雑さ

O(1)

コマンド説明

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• num: フィールドの値を増やす整数。

• EX: フィールドの相対的な有効期限。 単位は秒です。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• EXAT: フィールドの絶対有効期限。 単位は秒です。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• PX: フィールドの相対的な有効期限。 単位：ミリ秒。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• PXAT: フィールドの絶対有効期限。 単位：ミリ秒。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• VER: フィールドのバージョン番号。

  • フィールドが存在する場合、このパラメーターで指定されたバージョン番号は現在のバージョン番号と照合されます。

    • バージョン番号が一致すると、システムはコマンドを実行し続け、バージョン番号を1だけ増やします。

    • バージョン番号が一致しない場合、エラーメッセージが返されます。

  • フィールドが存在しない場合、またはフィールドの現在のバージョン番号が0の場合、このパラメーターは無視され、このコマンドは引き続き実行されます。 操作が成功すると、バージョン番号は1に設定されます。

• ABS: フィールドの絶対バージョン番号。 このパラメーターを設定すると、フィールドがすでに存在するかどうかに関係なく、フィールドが強制的にキーに書き込まれます。 同時に、フィールドが追加されると、バージョン番号は指定されたABS値に設定されます。

• MIN: フィールドの最小値。 フィールド値がこの下限未満の場合、エラーメッセージが返されます。

• MAX: フィールドの最大値。 フィールド値がこの上限より大きい場合、エラーメッセージが返されます。

• KEPTTL: EX、EXAT、PX、およびPXATパラメーターのいずれも指定されていない場合、フィールドの現在のTTLを保持します。

Output

• 操作が成功した場合、num値だけ増加した値が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhash field1 10コマンドは事前に実行されます。

サンプルコマンド:

EXHINCRBY myhash field1 100

サンプル出力：

(integer) 110

パラメーター

説明

構文

EXHINCRBYFLOATキーフィールドnum [EX time] [EXAT time] [PX time] [PXAT time] [VER | ABSバージョン] [MIN minval] [MAX maxval] [KEEPTL]

時間の複雑さ

O(1)

コマンド説明

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

• num: フィールドの値を増やす浮動小数点数。

• EX: フィールドの相対的な有効期限。 単位は秒です。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• EXAT: フィールドの絶対有効期限。 単位は秒です。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• PX: フィールドの相対的な有効期限。 単位：ミリ秒。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• PXAT: フィールドの絶対有効期限。 単位：ミリ秒。 値0は、フィールドがすぐに期限切れになることを示します。 このパラメーターが指定されていない場合、フィールドは有効期限が切れません。

• VER: フィールドのバージョン番号。

  • フィールドが存在する場合、このパラメーターで指定されたバージョン番号は現在のバージョン番号と照合されます。

    • バージョン番号が一致すると、システムはコマンドを実行し続け、バージョン番号を1だけ増やします。

    • バージョン番号が一致しない場合、エラーメッセージが返されます。

  • フィールドが存在しない場合、またはフィールドの現在のバージョン番号が0の場合、このパラメーターは無視され、このコマンドは引き続き実行されます。 操作が成功すると、バージョン番号は1に設定されます。

• ABS: フィールドの絶対バージョン番号。 このパラメーターを設定すると、フィールドがすでに存在するかどうかに関係なく、フィールドが強制的にキーに追加されます。 フィールドが追加されると、バージョン番号は指定されたABS値に設定されます。

• MIN: フィールドの最小値。 フィールド値がこの下限未満の場合、エラーメッセージが返されます。

• MAX: フィールドの最大値。 フィールド値がこの上限より大きい場合、エラーメッセージが返されます。

• KEPTTL: EX、EXAT、PX、およびPXATパラメーターのいずれも指定されていない場合、フィールドの現在のTTLを保持します。

Output

• 操作が成功した場合、num値だけ増加した値が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhash field1 10コマンドは事前に実行されます。

サンプルコマンド:

EXHINCRBYFLOAT myhash field1 9.235

サンプル出力：

「19.235」

パラメーター

説明

構文

EXHGETWITHVERキーフィールド

時間の複雑さ

O(1)

コマンド説明

TairHashキーからフィールドの値とバージョン番号を取得します。 キーまたはフィールドが存在しない場合、nilが返されます。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• フィールドが存在し、操作が成功した場合、フィールドの値とバージョン番号が返されます。

• キーまたはフィールドが存在しない場合、nilが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHGETWITHVER myhash field1

サンプル出力：

1) "19.235"
2) (integer) 5

パラメーター

説明

構文

EXHMGETキーフィールド [field ...]

時間の複雑さ

O(1)

コマンド説明

各クエリのTairHashキーから複数のフィールド値を取得します。 キーが存在しない場合、またはフィールドが存在しない場合は、nilが返されます。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーが存在しない場合は、nilが返されます。

• キーとフィールドが存在する場合、配列が返されます。 配列内の各要素は、フィールド値に対応する。

• キーが存在し、特定のフィールドが存在しない場合、配列が返されます。 配列内の各要素は、フィールド値に対応する。 存在しないフィールドに対応する要素は、nilとして表示されます。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhash field1 10 field2 var1コマンドは事前に実行されます。

サンプルコマンド:

EXHMGET myhash field1 field2

サンプル出力：

1) "10"
2) "var1" 

パラメーター

説明

構文

EXHMGETWITHVERキーフィールド [フィールド...]

時間の複雑さ

O(1)

コマンド説明

各クエリのTairHashキーから複数のフィールドの値とバージョン番号を取得します。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーが存在しない場合は、nilが返されます。

• キーとフィールドが存在する場合、配列が返されます。 配列内の各要素は、フィールド値およびバージョン番号に対応する。

• キーが存在し、特定のフィールドが存在しない場合、配列が返されます。 配列内の各要素は、フィールド値およびバージョン番号に対応する。 存在しないフィールドに対応する要素は、nilとして表示されます。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhash field1 10 field2 var1コマンドは事前に実行されます。

サンプルコマンド:

EXHMGETWITHVER myhash field1 field2

サンプル出力：

1) 1) "10"
   2) (integer) 1
2) 1) "var1"
   2) (integer) 1

パラメーター

説明

構文

EXHLENキー [NOEXP]

時間の複雑さ

時間複雑度は、NOEXPパラメータが指定されていない場合はO(1) であり、NOEXPパラメータが指定されている場合はO(N) である。

コマンド説明

TairHashキーのフィールド数を取得します。 出力は、このコマンドが期限切れフィールドの受動的な削除をトリガしないか、または期限切れフィールドを除外しないので、削除されない期限切れフィールドの数を含むことができる。 有効期限が切れていないフィールドの数だけを取得する場合は、コマンドでNOEXPパラメーターを設定できます。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• NOEXP: 期限切れになっていないフィールドの数を返すように指定します。 デフォルトでは、このコマンドは期限切れフィールドの受動的な削除をトリガーしたり、除外したりしません。 このため、このコマンドの出力には、削除されない期限切れのフィールドの数が含まれる場合があります。 有効期限が切れていないフィールドの数だけを取得する場合は、NOEXPパラメーターを設定できます。 NOEXPパラメーターを設定するときは、次の項目に注意してください。

  • システムはキー内のすべてのデータをスキャンするため、EXHLENコマンドの応答時間はキーのサイズによって決まります。

  • EXHLENコマンドの出力には期限切れフィールドの数は含まれません。これは、このコマンドが期限切れフィールドを除外しますが、それらを削除しないためです。

Output

• キーが存在しないか、キーにフィールドが存在しない場合、値0が返されます。

• 操作が成功した場合、キー内のフィールドの数が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHLEN myhash

サンプル出力：

(integer) 2

パラメーター

説明

構文

EXHEXISTSキーフィールド

時間の複雑さ

O(1)

コマンド説明

TairHashキーにフィールドが存在するかどうかをチェックします。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーまたはフィールドが存在しない場合、値0が返されます。

• フィールドが存在する場合、値1が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHEXISTS myhash field1

サンプル出力：

(integer) 1

パラメーター

説明

構文

EXHSTRLENキーフィールド

時間の複雑さ

O(1)

コマンド説明

TairHashキーからフィールド値の長さを取得します。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーまたはフィールドが存在しない場合、値0が返されます。

• 操作が成功した場合、フィールド値の長さが返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHSTRLEN myhash field1

サンプル出力：

(integer) 2

パラメーター

説明

構文

EXHKEYSキー

時間の複雑さ

O(N)

コマンド説明

TairHashキーからすべてのフィールドを取得します。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

Output

• キーが存在しない場合は、空の配列が返されます。

• キーが存在する場合、配列が返されます。 配列内の各要素は、キー内のフィールドに対応する。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhash field1 10 field2 var1コマンドは事前に実行されます。

サンプルコマンド:

EXHKEYS myhash

サンプル出力：

1) "field1"
2) "field2" 

パラメーター

説明

構文

EXHVALSキー

時間の複雑さ

O(N)

コマンド説明

TairHashキーからすべてのフィールド値を取得します。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

Output

• キーが存在しない場合は、空の配列が返されます。

• キーが存在する場合、配列が返されます。 配列の各要素は、キーのフィールド値に対応します。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhash field1 10 field2 var1コマンドは事前に実行されます。

サンプルコマンド:

EXHVALS myhash

サンプル出力：

1) "10"
2) "var1" 

パラメーター

説明

構文

EXGETALLキー

時間の複雑さ

O(N)

コマンド説明

TairHashキーからすべてのフィールドとその値を取得します。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

Output

• キーが存在しない場合は、空の配列が返されます。

• キーが存在する場合、配列が返されます。 配列内の各要素は、キー内のフィールドと値のペアに対応します。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhash field1 10 field2 var1コマンドは事前に実行されます。

サンプルコマンド:

EXHGETALL myhash

サンプル出力：

1) "field1"
2) "10"
3) "field2"
4) "var1" 

パラメーター

説明

構文

EXHSCANキーopサブキー [マッチパターン] [カウント数]

時間の複雑さ

時間の複雑さは、すべての呼に対してO(1) であり、完全な反復に対してO(N) である。

コマンド説明

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• op: スキャンの開始位置。 有効な値：

  • >: スキャンは、サブキー値よりも大きい値を持つ最初のフィールドから開始されます。

  • >=: スキャンは、サブキー値以上の値を持つ最初のフィールドから開始されます。

  • <: スキャンは、サブキー値未満の値を持つ最初のフィールドから開始されます。

  • <=: スキャンは、サブキー値以下の値を持つ最初のフィールドから開始されます。

  • ==: スキャンは、サブキー値に等しい値を持つ最初のフィールドから開始されます。

  • ^: 最初のフィールドからスキャンを開始します。

  • $: スキャンは最後のフィールドから始まります。

• subkey: スキャンの開始位置を決定するためにopパラメータと一緒に使用されるパラメータ。 opパラメーターが ^ または $に設定されている場合、このパラメーターは無視されます。

• MATCH: 正規表現パターンに基づいてスキャンするサブキーをフィルタリングします。

• COUNT: 各クエリでスキャンできるフィールドの数を指定します。 デフォルト値は 10 です。

  説明

  COUNTパラメーターは、各クエリでスキャンされるフィールドの数を指定します。返されるフィールドの数がスキャンされたフィールドの数であることを保証しません。 返されるフィールドの数は、キーに存在するフィールドの数と、MATCHパラメーターが指定されているかどうかによって決まります。

Output

• キーが存在しない場合は、空の配列が返されます。

• キーが存在する場合、2つの要素を含む配列が返されます。

  • 最初の要素は、次のスキャンが開始する最初のフィールドです。 キースキャンが完了すると、この要素は空のままになります。

  • 2番目の要素は、フィールドと値を含むスキャン結果です。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhashkey field1 val1 field2 val2 field3 val3 field4 val4 field5 val5コマンドは事前に実行されます。

サンプルコマンド:

EXHSCAN myhashkey ^ xx COUNT 3

サンプル出力：

1) "field4"
2) 1) "field1"
   2) "val1"
   3) "field2"
   4) "val2"
   5) "field3"
   6) "val3" 

パラメーター

説明

構文

EXHSCANUNORDERキーカーソル [マッチパターン] [カウント数]

時間の複雑さ

時間の複雑さは、すべての呼に対してO(1) であり、完全な反復に対してO(N) である。

コマンド説明

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• cursor: このスキャンで使用されるカーソル。

• MATCH: 正規表現パターンに基づいてスキャンするフィールドをフィルタリングします。

• COUNT: 各クエリでスキャンできるフィールドの数を指定します。 デフォルト値は 10 です。

  説明

  COUNTパラメーターは、各クエリでスキャンされるフィールドの数を指定します。返されるフィールドの数がスキャンされたフィールドの数であることを保証しません。 返されるフィールドの数は、キーに存在するフィールドの数と、MATCHパラメーターが指定されているかどうかによって決まります。

Output

• キーが存在しない場合は、空の配列が返されます。

• キーが存在する場合、2つの要素を含む配列が返されます。

  • 配列の最初の要素は、次のスキャンに使用されるカーソルです。 キースキャンが完了すると、値0が返されます。

  • 2番目の要素は、フィールドと値を含むスキャン結果です。

• それ以外の場合、エラーメッセージが返されます。

例：

EXHMSET myhashkey field1 val1 field2 val2 field3 val3 field4 val4 field5 val5コマンドは事前に実行されます。

サンプルコマンド:

EXHSCANUNORDER myhashkey 0 COUNT 3

サンプル出力：

1) "1"
2) 1) "field5"
   2) "val5"
   3) "field2"
   4) "val2" 

パラメーター

説明

構文

EXHDELキーフィールド [field ...]

時間の複雑さ

O(1)

コマンド説明

TairHashキーからフィールドを削除します。 キーまたはフィールドが存在しない場合、値0が返されます。 フィールドが削除されると、値1が返されます。

パラメーター

• Key: このコマンドを実行して管理するTairHashデータを指定するキー。

• field: キーの要素。 キーには複数のフィールドを含めることができます。

Output

• キーまたはフィールドが存在しない場合、値0が返されます。

• 操作が成功した場合、値1が返されます。

• それ以外の場合、エラーメッセージが返されます。

例：

サンプルコマンド:

EXHDEL myhash field1

サンプル出力：

(integer) 1