Redis String的CAS与CAD增强命令-云数据库 Tair（兼容 Redis®）-阿里云

本文介绍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)`。