TairString(exString)是一種帶版本號的String類型數據結構,本文介紹TairString數據支持的命令。
TairString簡介
Redis的String僅由key和value組成,而TairString不僅包含key和value,還攜帶了版本(version),可用于樂觀鎖等場景。除此之外,TairString在Redis String加減功能的基礎上支持了邊界設置,可以將INCRBY、INCRBYFLOAT的結果限制在一定的范圍內,超出范圍則提示錯誤。
主要特性- value攜帶版本號。
- 使用INCRBY、INCRBYFLOAT遞增數據時可設置變更范圍。
該Module已開源,更多信息請參見TairString。
最佳實踐
前提條件
注意事項
本文的操作對象為Tair實例中的TairString數據。
命令列表
命令 | 語法 | 簡介 |
EXSET | EXSET key value [EX|PX|EXAT|PXAT time] [NX|XX] [VER|ABS version] [KEEPTTL] | 若key不存在,則創建新的key,并將value保存到key中;若key已存在,則覆蓋原來value的值。 |
EXGET | EXGET key | 獲取TairString的value和version。 |
EXSETVER | EXSETVER key version | 設置目標key的version。 |
EXINCRBY | EXINCRBY key num [EX|PX|EXAT|PXAT time] [NX|XX] [VER|ABS version] [MIN minval] [MAX maxval] [KEEPTTL] | 對TairString的value進行自增自減操作,num的范圍為long。 |
EXINCRBYFLOAT | EXINCRBYFLOAT key num [EX|PX|EXAT|PXAT time] [NX|XX] [VER|ABS version] [MIN minval] [MAX maxval] [KEEPTTL] | 對TairString的value進行自增自減操作,num的范圍為double。 |
EXCAS | EXCAS key newvalue version | 當目標key的version值與指定的version相等時,則更新key的value值;version不相等,則返回舊的value和version。 |
EXCAD | EXCAD key version | 當目標key的version值與指定的version相等時,則刪除Key。 |
DEL | DEL key [key ...] | 使用原生Redis的DEL命令可以刪除一條或多條TairString數據。 |
大寫關鍵字
:命令關鍵字。斜體
:變量。[options]
:可選參數,不在括號中的參數為必選。A|B
:該組參數互斥,請進行二選一或多選一。...
:前面的內容可重復。
EXSET
類別 | 說明 |
語法 | EXSET key value [EX|PX|EXAT|PXAT time] [NX|XX] [VER|ABS version] [KEEPTTL] |
時間復雜度 | O(1) |
命令描述 | 若key不存在,則創建新的key,并將value保存到key中;若key已存在,則覆蓋原來value的值。 |
選項 |
|
返回值 |
|
示例 | 命令示例:
返回示例:
|
EXGET
類別 | 說明 |
語法 | EXGET key |
時間復雜度 | O(1) |
命令描述 | 獲取TairString的value和version。 |
選項 |
|
返回值 |
|
示例 | 命令示例:
返回示例:
|
EXSETVER
類別 | 說明 |
語法 | EXSETVER key version |
時間復雜度 | O(1) |
命令描述 | 設置目標key的version。 |
選項 |
|
返回值 |
|
示例 | 命令示例:
返回示例:
|
EXINCRBY
類別 | 說明 |
語法 | EXINCRBY key num [EX|PX|EXAT|PXAT time] [NX|XX] [VER|ABS version] [MIN minval] [MAX maxval] [KEEPTTL] |
時間復雜度 | O(1) |
命令描述 | 對TairString的value進行自增自減操作,num的范圍為long。 |
選項 |
|
返回值 |
|
示例 | 提前執行 命令示例:
返回示例:
|
EXINCRBYFLOAT
類別 | 說明 |
語法 | EXINCRBYFLOAT key num [EX|PX|EXAT|PXAT time] [NX|XX] [VER|ABS version] [MIN minval] [MAX maxval] [KEEPTTL] |
時間復雜度 | O(1) |
命令描述 | 對TairString的value進行自增自減操作,num的范圍為double。 |
選項 |
|
返回值 |
|
示例 | 提前執行 命令示例:
返回示例:
|
EXCAS
類別 | 說明 |
語法 | EXCAS key newvalue version |
時間復雜度 | O(1) |
命令描述 | 當目標key的version值與指定的version相等時,則更新key的value值;version不相等,則返回舊的value和version。 |
選項 |
|
返回值 |
|
示例 | 提前執行 命令示例:
返回示例:
|
EXCAD
類別 | 說明 |
語法 | EXCAD key version |
時間復雜度 | O(1) |
命令描述 | 當目標key的version值與指定的version相等時,則刪除Key。 |
選項 |
|
返回值 |
|
示例 | 提前執行 命令示例:
返回示例:
|