命令原型 |
時間復雜度 | 命令描述 | 返回值 |
APPENDkeyvalue |
O(1) | 如果該Key已經存在,APPEND命令將參數Value的數據追加到已存在Value的末尾。如果該Key不存在,APPEND命令將會創(chuàng)建一個新的Key/Value。 | 追加后Value的長度。 |
DECRkey | O(1) | 將指定Key的Value原子性的遞減1。如果該Key不存在,其初始值為0,在decr之后其值為-1。如果Value的值不能轉換為整型值,如Hello,該操作將執(zhí)行失敗并返回相應的錯誤信息。注意:該操作的取值范圍是64位有符號整型。 | 遞減后的Value值。 |
INCRkey | O(1) | 將指定Key的Value原子性的遞增1。如果該Key不存在,其初始值為0,在incr之后其值為1。如果Value的值不能轉換為整型值,如Hello,該操作將執(zhí)行失敗并返回相應的錯誤信息。注意:該操作的取值范圍是64位有符號整型。 | 遞增后的Value值。 |
DECRBYkey decrement | O(1) | 將指定Key的Value原子性的減少decrement。如果該Key不存在,其初始值為0,在decrby之后其值為-decrement。如果Value的值不能轉換為整型值,如Hello,該操作將執(zhí)行失敗并返回相應的錯誤信息。注意:該操作的取值范圍是64位有符號整型。 | 減少后的Value值。 |
INCRBYkey increment | O(1) | 將指定Key的Value原子性的增加increment。如果該Key不存在,其初始值為0,在incrby之后其值為increment。如果Value的值不能轉換為整型值,如Hello,該操作將執(zhí)行失敗并返回相應的錯誤信息。注意:該操作的取值范圍是64位有符號整型。 | 增加后的Value值。 |
GETkey | O(1) | 獲取指定Key的Value。如果與該Key關聯(lián)的Value不是string類型,Redis將返回錯誤信息,因為GET命令只能用于獲取string Value。 | 與該Key相關的Value,如果該Key不存在,返回nil。 |
SETkey value | O(1) |
設定該Key持有指定的字符串Value,如果該Key已經存在,則覆蓋其原有值。 | 總是返回"OK"。 |
GETSETkey value | O(1) | 原子性的設置該Key為指定的Value,同時返回該Key的原有值。和GET命令一樣,該命令也只能處理string Value,否則Redis將給出相關的錯誤信息。 | 返回該Key的原有值,如果該Key之前并不存在,則返回nil。 |
STRLENkey | O(1) | 返回指定Key的字符值長度,如果Value不是string類型,Redis將執(zhí)行失敗并給出相關的錯誤信息。 | 返回指定Key的Value字符長度,如果該Key不存在,返回0。 |
SETEXkey seconds value | O(1) | 原子性完成兩個操作,一是設置該Key的值為指定字符串,同時設置該Key在Redis服務器中的存活時間(秒數)。該命令主要應用于Redis被當做Cache服務器使用時。 | |
SETNXkey value | O(1) | 如果指定的Key不存在,則設定該Key持有指定字符串Value,此時其效果等價于SET命令。相反,如果該Key已經存在,該命令將不做任何操作并返回。 | 1表示設置成功,否則0。 |
SETRANGEkey offset value | O(1) | 替換指定Key的部分字符串值。從offset開始,替換的長度為該命令第三個參數value的字符串長度,其中如果offset的值大于該Key的原有值Value的字符串長度,Redis將會在Value的后面補齊(offset - strlen(value))數量的0x00,之后再追加新值。如果該鍵不存在,該命令會將其原值的長度假設為0,并在其后添補offset個0x00后再追加新值。鑒于字符串Value的最大長度為512M,因此offset的最大值為536870911。最后需要注意的是,如果該命令在執(zhí)行時致使指定Key的原有值長度增加,這將會導致Redis重新分配足夠的內存以容納替換后的全部字符串,因此就會帶來一定的性能折損。 | 修改后的字符串Value長度。 |
GETRANGEkey start end | O(1) | 如果截取的字符串長度很短,我們可以該命令的時間復雜度視為O(1),否則就是O(N),這里N表示截取的子字符串長度。該命令在截取子字符串時,將以閉區(qū)間的方式同時包含start(0表示第一個字符)和end所在的字符,如果end值超過Value的字符長度,該命令將只是截取從start開始之后所有的字符數據。 | 子字符串 |
SETBITkey offset value | O(1) | 設置在指定Offset上BIT的值,該值只能為1或0,在設定后該命令返回該Offset上原有的BIT值。如果指定Key不存在,該命令將創(chuàng)建一個新值,并在指定的Offset上設定參數中的BIT值。如果Offset大于Value的字符長度,Redis將拉長Value值并在指定Offset上設置參數中的BIT值,中間添加的BIT值為0。最后需要說明的是Offset值必須大于0。 | 在指定Offset上的BIT原有值。 |
GETBITkey offset | O(1) | 返回在指定Offset上BIT的值,0或1。如果Offset超過string value的長度,該命令將返回0,所以對于空字符串始終返回0。 | 在指定Offset上的BIT值。 |
MGETkey [key ...] | O(N) | N表示獲取Key的數量。返回所有指定Keys的Values,如果其中某個Key不存在,或者其值不為string類型,該Key的Value將返回nil。 | 返回一組指定Keys的Values的列表。 |
MSETkey value [key value ...] | O(N) | N表示指定Key的數量。該命令原子性的完成參數中所有key/value的設置操作,其具體行為可以看成是多次迭代執(zhí)行SET命令。 | 該命令不會失敗,始終返回OK。 |
MSETNXkey value [key value ...] | O(N) | N表示指定Key的數量。該命令原子性的完成參數中所有key/value的設置操作,其具體行為可以看成是多次迭代執(zhí)行SETNX命令。然而這里需要明確說明的是,如果在這一批Keys中有任意一個Key已經存在了,那么該操作將全部回滾,即所有的修改都不會生效。 | 1表示所有Keys都設置成功,0則表示沒有任何Key被修改。 |
三、命令示例:
1. SET/GET/APPEND/STRLEN: