Redis文字列機能を強化するコマンド - Tair (Redis® OSS-Compatible)

このトピックでは、文字列機能を改善するために使用できるTairインスタンスでサポートされる新しいコマンドについて説明します。コマンドは、CASおよびCADコマンドを含む。

前提条件

インスタンスは、マイナーバージョンが1.2.3以降のTair DRAMベースまたは永続メモリ最適化インスタンスです。

説明

最新のマイナーバージョンは、より多くの機能とより高い安定性を提供します。インスタンスを最新のマイナーバージョンに更新することを推奨します。詳細については、「インスタンスのマイナーバージョンの更新」をご参照ください。お使いのインスタンスがクラスターインスタンスまたは読み書き分離インスタンスの場合、すべてのコマンドを期待どおりに実行できるように、インスタンスのプロキシノードを最新のマイナーバージョンに更新することを推奨します。

注意事項

このトピックでは、管理する文字列はネイティブのRedis文字列です。

説明

TairインスタンスでRedis文字列とTairStringsを管理できます。ただし、CASおよびCADコマンドはRedis文字列にのみ適用できます。

サポートされるコマンド

表 1. 文字列機能を強化するコマンド

コマンド	構文	説明
CAS	`CASキーoldvalue newvalue`	既存の値が指定された値と一致する場合、指定されたキーの既存の値を変更します。それ以外の場合、既存の値は変更されません。説明このコマンドはRedis文字列にのみ適用されます。 TairString値を変更するには、EXCASコマンドを実行します。
CAD	`CADキー値`	キーの既存の値が指定された値と一致する場合、指定されたキーを削除します。それ以外の場合、キーは削除されません。説明このコマンドはRedis文字列にのみ適用されます。 TairStringキーを削除するには、EXCADコマンドを実行します。

説明

このトピックで使用されるコマンド構文の規則を次に示します。

Uppercase keyword: commandキーワードを示します。
イタリックテキスト: 変数を示します。
[options]: 囲まれたパラメータがオプションであることを示します。括弧で囲まれていないパラメータを指定する必要があります。
A | B: 縦棒 (|) で区切られたパラメータが相互に排他的であることを示します。指定できるパラメーターは1つだけです。
...: このシンボルの前にあるパラメーターを繰り返し指定できることを示します。

CAS

項目	説明
構文	`CASキーoldvalue newvalue`
時間の複雑さ	O(1)
コマンド説明	既存の値が指定された値と一致する場合、指定されたキーの既存の値を変更します。それ以外の場合、既存の値は変更されません。説明このコマンドはRedis文字列にのみ適用されます。 TairString値を変更するには、EXCASコマンドを実行します。
パラメーター	Key: コマンドを実行して管理するRedis文字列のキー。 oldvalue: キーの既存の値と比較する指定された値。 newvalue: 既存の値が指定された値と一致する場合に、キーの既存の値を変更する新しい値。
Output	操作が成功した場合、値1が返されます。操作が失敗した場合、値0が返されます。キーが存在しない場合、-1の値が返されます。それ以外の場合、エラーメッセージが返されます。
例：	`SET foo bar`コマンドは事前に実行されます。サンプルコマンド: `CAS foo bar bzz` サンプル出力： `(integer) 1` このコマンドの実行後に`GET foo`コマンドを実行すると、`"bzz"` が返されます。

CAD

項目	説明
構文	`CADキー値`
時間の複雑さ	O(1)
コマンド説明	キーの既存の値が指定された値と一致する場合、指定されたキーを削除します。それ以外の場合、キーは削除されません。説明このコマンドはRedis文字列にのみ適用されます。 TairStringキーを削除するには、EXCADコマンドを実行します。
パラメーター	Key: コマンドを実行して管理するRedis文字列のキー。 value: キーの既存の値と比較する指定された値。
Output	操作が成功した場合、値1が返されます。操作が失敗した場合、値0が返されます。キーが存在しない場合、-1の値が返されます。それ以外の場合、エラーメッセージが返されます。
例：	`SET foo bar`コマンドは事前に実行されます。サンプルコマンド: `CAD foo bar` サンプル出力： `(integer) 1` このコマンドの実行後、fooキーは削除されます。次に、`GET foo`コマンドを実行すると、`(nil)` が返されます。