Tair インスタンスの新しい文字列拡張コマンド - Tair (Redis® OSS-Compatible)

このトピックでは、Redis の文字列機能を強化する Tair インスタンスの新しい CAS および CAD コマンドについて説明します。

前提条件

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

説明

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

使用上の注意

このトピックのコマンドは、ネイティブの Redis 文字列に適用されます。

説明

Tair インスタンスには、Redis 文字列と TairString の両方を含めることができます。このトピックのコマンドは TairString には適用されません。

コマンド一覧

表 1. 文字列拡張コマンド

コマンド	構文	説明
CAS	`CAS key oldvalue newvalue [EX\|PX\|EXAT\|PXAT time]`	CAS (Compare And Set) は、ターゲットキーの値が指定された oldvalue と等しいかどうかをチェックします。等しい場合、コマンドは値を新しい newvalue に更新します。それ以外の場合、コマンドは何も行いません。説明このコマンドは Redis 文字列にのみ適用されます。TairString で同じ操作を実行するには、EXCAS コマンドを使用します。
CAD	`CAD key value`	CAD (Compare And Delete) は、ターゲットキーの値が指定された値と等しいかどうかをチェックします。等しい場合、コマンドはキーを削除します。それ以外の場合、コマンドは何も行いません。説明このコマンドは Redis 文字列にのみ適用されます。TairString で同じ操作を実行するには、EXCAD コマンドを使用します。

説明

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

Uppercase keyword: コマンドのキーワードを示します。
Italic text: 変数を示します。
[options]: 角括弧で囲まれたパラメーターがオプションであることを示します。角括弧で囲まれていないパラメーターは指定する必要があります。
A|B: 縦棒 (|) で区切られたパラメーターが相互に排他的であることを示します。パラメーターのいずれか 1 つのみを指定できます。
...: この記号の前のパラメーターを繰り返し指定できることを示します。

CAS

項目	説明
構文	`CAS key oldvalue newvalue [EX\|PX\|EXAT\|PXAT time]`
時間計算量	O(1)
コマンドの説明	CAS (Compare And Set) は、ターゲットキーの値が指定された oldvalue と等しいかどうかをチェックします。等しい場合、コマンドは値を新しい newvalue に更新します。それ以外の場合、コマンドは何も行いません。説明このコマンドは Redis 文字列にのみ適用されます。TairString で同じ操作を実行するには、EXCAS コマンドを使用します。
オプション	Key: 文字列型のターゲットキー。 oldvalue: キーの現在の値と比較する元の値。 newvalue: 新しい値。`oldvalue` がキーの現在の値と等しい場合、値は `newvalue` に更新されます。 EX: キーの相対的な有効期限を秒単位で設定します。値 0 は、キーがすぐに有効期限切れになることを意味します。このパラメーターを指定しない場合、キーは有効期限切れになりません。 EXAT: キーの絶対的な有効期限を UNIX タイムスタンプ (秒単位) として設定します。値 0 は、キーがすぐに有効期限切れになることを意味します。このパラメーターを指定しない場合、キーは有効期限切れになりません。 PX: キーの相対的な有効期限をミリ秒単位で設定します。値 0 は、キーがすぐに有効期限切れになることを意味します。このパラメーターを指定しない場合、キーは有効期限切れになりません。 PXAT: キーの絶対的な有効期限を UNIX タイムスタンプ (ミリ秒単位) として設定します。値 0 は、キーがすぐに有効期限切れになることを意味します。このパラメーターを指定しない場合、キーは有効期限切れになりません。説明元の文字列に Time to Live (TTL) が設定されている場合、TTL パラメーターなしで CAS コマンドを実行すると TTL が削除されます。その後、キーは有効期限切れになりません。
戻り値	1: 操作は成功しました。 0: 操作は失敗しました。 -1: キーが存在しません。その他の場合、エラーメッセージが返されます。
例	最初に `SET foo bar` コマンドを実行します。コマンドの例: `CAS foo bar bzz EX 10` 戻り値の例: `(integer) 1` その後 `GET foo` コマンドを実行すると、`"bzz"` が返されます。

CAD

項目	説明
構文	`CAD key value`
時間計算量	O(1)
コマンドの説明	CAD (Compare And Delete) は、ターゲットキーの値が指定された値と等しいかどうかをチェックします。等しい場合、コマンドはキーを削除します。それ以外の場合、コマンドは何も行いません。説明このコマンドは Redis 文字列にのみ適用されます。TairString で同じ操作を実行するには、EXCAD コマンドを使用します。
オプション	Key: 文字列型のターゲットキー。 value: キーの現在の値と比較する値。
戻り値	1: 操作は成功しました。 0: 操作は失敗しました。 -1: キーが存在しません。その他の場合、エラーメッセージが返されます。
例	最初に `SET foo bar` コマンドを実行します。コマンドの例: `CAD foo bar` サンプルの戻り値： `(integer) 1` foo キーは削除されます。その後、`GET foo` コマンドを実行すると、`(nil)` が返されます。