Tair執行個體新增的String增強類命令介紹 - Tair (Redis® OSS-Compatible)

本文介紹Tair執行個體新增的String增強類命令，包括CAS和CAD。

前提條件

執行個體為Tair記憶體型或持久記憶體型（小版本為1.2.3及以上）。

說明

最新小版本將提供更豐富的功能與穩定的服務，建議將執行個體的小版本升級到最新，具體操作請參見升級小版本。如果您的執行個體為叢集執行個體或讀寫分離架構，請將代理節點的小版本也升級到最新，否則可能出現命令無法識別的情況。

本文的操作對象為Redis String（即Redis原生String）。

說明

Tair執行個體中可同時設定Redis String和TairString，本文的命令無法對TairString使用。

表 1. String增強命令

命令	文法	說明
CAS	`CAS key oldvalue newvalue [EX\|PX\|EXAT\|PXAT time]`	CAS（Compare And Set），查看指定的oldvalue是否與目標Key的Value相等，若相等則將Value修改成新的值（newvalue），不相等則不修改。說明該命令僅適用於操作Redis String類型的資料，如需對TairString做相同的操作，請使用EXCAS。
CAD	`CAD key value`	CAD（Compare And Delete），查看指定Value值是否與目標Key的Value相等，若相等則刪除該Key，不相等則不刪除。說明該命令僅適用於操作Redis String類型的資料，如需對TairString做相同的操作，請使用EXCAD。

說明

本文的命令文法定義如下：

類別	說明
文法	`CAS key oldvalue newvalue [EX\|PX\|EXAT\|PXAT time]`
時間複雜度	O(1)
命令描述	CAS（Compare And Set），查看指定的oldvalue是否與目標Key的Value相等，若相等則將Value修改成新的值（newvalue），不相等則不修改。說明該命令僅適用於操作Redis String類型的資料，如需對TairString做相同的操作，請使用EXCAS。
選項	Key：目標Key，String類型。 oldvalue：原Value值，用於跟現有Key的Value進行比較。 newvalue：當oldvalue與Key現有Value相等時，將Value修改為newvalue。 EX：指定Key的相對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。 EXAT：指定Key的絕對到期時間，單位為秒，為0表示馬上到期，不傳此參數表示不到期。 PX：指定Key的相對到期時間，單位為毫秒，為0表示馬上到期，不傳此參數表示不到期。 PXAT：指定Key的絕對到期時間，單位為毫秒，為0表示馬上到期，不傳此參數表示不到期。說明若原String已設定TTL，在執行CAS命令時不加上TTL，該Key將不到期。
傳回值	執行成功：1 執行失敗：0 若Key不存在：-1 其它情況返回相應的異常資訊。
樣本	提前執行`SET foo bar`命令。命令樣本： `CAS foo bar bzz EX 10` 返回樣本： `(integer) 1` 若此時執行`GET foo`，將返回`“bzz”`。

類別	說明
文法	`CAD key value`
時間複雜度	O(1)
命令描述	CAD（Compare And Delete），查看指定Value值是否與目標Key的Value相等，若相等則刪除該Key，不相等則不刪除。說明該命令僅適用於操作Redis String類型的資料，如需對TairString做相同的操作，請使用EXCAD。
選項	Key：目標Key，String類型。 value：指定Value，用於跟現有Key的Value進行比較。
傳回值	執行成功：1 執行失敗：0 若Key不存在：-1 其它情況返回相應的異常資訊。
樣本	提前執行`SET foo bar`命令。命令樣本： `CAD foo bar` 返回樣本： `(integer) 1` 執行成功，則foo Key被刪除，若此時執行`GET foo`，將返回`(nil)`。