在該系列的前幾篇部落格中,主要講述的是與redis資料類型相關的指令,如string、list、set、hashes和sorted-set。這些指令都具有一個共同點,即所有的操作都是針對與key關聯的value的。而該篇部落格将主要講述與key相關的redis指令。學習這些指令對于學習redis是非常重要的基礎,也是能夠充分挖掘redis潛力的利器。
在這篇部落格中,我們将一如既往的給出所有相關指令的明細清單和典型示例,以便于我們現在的學習和今後的查閱。
指令原型
時間複雜度
指令描述
傳回值
keys pattern
o(n)
時間複雜度中的n表示資料庫中key的數量。擷取所有比對pattern參數的keys。需要說明的是,在我們的正常操作中應該盡量避免對該指令的調用,因為對于大型資料庫而言,該指令是非常耗時的,對redis伺服器的性能打擊也是比較大的。pattern支援glob-style的通配符格式,如*表示任意一個或多個字元,?表示任意字元,[abc]表示方括号中任意一個字母。
比對模式的鍵清單。
del key [key …]
時間複雜度中的n表示删除的key數量。從資料庫删除中參數中指定的keys,如果指定鍵不存在,則直接忽略。還需要另行指出的是,如果指定的key關聯的資料類型不是string類型,而是list、set、hashes和sorted set等容器類型,該指令删除每個鍵的時間複雜度為o(m),其中m表示容器中元素的數量。而對于string類型的key,其時間複雜度為o(1)。
實際被删除的key數量。
exists key
o(1)
判斷指定鍵是否存在。
1表示存在,0表示不存在。
move key db
将目前資料庫中指定的鍵key移動到參數中指定的資料庫中。如果該key在目标資料庫中已經存在,或者在目前資料庫中并不存在,該指令将不做任何操作并傳回0。
移動成功傳回1,否則0。
rename key newkey
為指定指定的鍵重新命名,如果參數中的兩個keys的指令相同,或者是源key不存在,該指令都會傳回相關的錯誤資訊。
如果newkey已經存在,則直接覆寫。
renamenx key newkey
如果新值不存在,則将參數中的原值修改為新值。其它條件和rename一緻。
1表示修改成功,否則0。
persist key
如果key存在過期時間,該指令會将其過期時間消除,使該key不再有逾時,而是可以持久化存儲。
1表示key的過期時間被移出,0表示該key不存在或沒有過期時間。
expire key seconds
該指令為參數中指定的key設定逾時的秒數,在超過該時間後,key被自動的删除。如果該key在逾時之前被修改,與該鍵關聯的逾時将被移除。
1表示逾時被設定,0則表示key不存在,或不能被設定。
expireat key timestamp
該指令的邏輯功能和expire完全相同,唯一的差别是該指令指定的逾時時間是絕對時間,而不是相對時間。該時間參數是unix timestamp格式的,即從1970年1月1日開始所流經的秒數。
ttl key
擷取該鍵所剩的逾時描述。
傳回所剩描述,如果該鍵不存在或沒有逾時設定,則傳回-1。
randomkey
從目前打開的資料庫中随機的傳回一個key。
傳回的随機鍵,如果該資料庫是空的則傳回nil。
type key
擷取與參數中指定鍵關聯值的類型,該指令将以字元串的格式傳回。
傳回的字元串為string、list、set、hash和zset,如果key不存在傳回none。
sort key [by pattern] [limit offset count] [get pattern [get pattern …]] [asc|desc] [alpha] [store destination]
o(n+m*log(m))
這個指令相對來說是比較複雜的,是以我們這裡隻是給出最基本的用法,有興趣的網友可以去參考redis的官方文檔。 傳回排序後的原始清單。
keys/rename/del/exists/move/renamenx:
在shell指令行下啟動redis用戶端工具。
/> redis-cli
清空目前選擇的資料庫,以便于對後面示例的了解。
redis 127.0.0.1:6379> flushdb
ok
添加string類型的模拟資料。
redis 127.0.0.1:6379> set mykey 2
redis 127.0.0.1:6379> set mykey2 “hello”
添加set類型的模拟資料。
redis 127.0.0.1:6379> sadd mysetkey 1 2 3
(integer) 3
添加hash類型的模拟資料。
redis 127.0.0.1:6379> hset mmtest username “stephen”
(integer) 1
根據參數中的模式,擷取目前資料庫中符合該模式的所有key,從輸出可以看出,該指令在執行時并不區分與key關聯的value類型。
redis 127.0.0.1:6379> keys my*
1) “mysetkey”
2) “mykey”
3) “mykey2”
删除了兩個keys。
redis 127.0.0.1:6379> del mykey mykey2
(integer) 2
檢視一下剛剛删除的key是否還存在,從傳回結果看,mykey确實已經删除了。
redis 127.0.0.1:6379> exists mykey
(integer) 0
檢視一下沒有删除的key,以和上面的指令結果進行比較。
redis 127.0.0.1:6379> exists mysetkey
将目前資料庫中的mysetkey鍵移入到id為1的資料庫中,從結果可以看出已經移動成功。
redis 127.0.0.1:6379> move mysetkey 1
打開id為1的資料庫。
redis 127.0.0.1:6379> select 1
檢視一下剛剛移動過來的key是否存在,從傳回結果看已經存在了。
redis 127.0.0.1:6379[1]> exists mysetkey
在重新打開id為0的預設資料庫。
redis 127.0.0.1:6379[1]> select 0
檢視一下剛剛移走的key是否已經不存在,從傳回結果看已經移走。
準備新的測試資料。
redis 127.0.0.1:6379> set mykey “hello”
将mykey改名為mykey1
redis 127.0.0.1:6379> rename mykey mykey1
由于mykey已經被重新命名,再次擷取将傳回nil。
redis 127.0.0.1:6379> get mykey
(nil)
通過新的鍵名擷取。
redis 127.0.0.1:6379> get mykey1
“hello”
由于mykey已經不存在了,是以傳回錯誤資訊。
(error) err no such key
為renamenx準備測試key
redis 127.0.0.1:6379> set oldkey “hello”
redis 127.0.0.1:6379> set newkey “world”
由于newkey已經存在,是以該指令未能成功執行。
redis 127.0.0.1:6379> renamenx oldkey newkey
檢視newkey的值,發現它也沒有被renamenx覆寫。
redis 127.0.0.1:6379> get newkey
“world”
persist/expire/expireat/ttl:
為後面的示例準備的測試資料。
将該鍵的逾時設定為100秒。
redis 127.0.0.1:6379> expire mykey 100
通過ttl指令檢視一下還剩下多少秒。
redis 127.0.0.1:6379> ttl mykey
(integer) 97
立刻執行persist指令,該存在逾時的鍵變成持久化的鍵,即将該key的逾時去掉。
redis 127.0.0.1:6379> persist mykey
ttl的傳回值告訴我們,該鍵已經沒有逾時了。
(integer) -1
為後面的expire指令準備資料。
redis 127.0.0.1:6379> del mykey
設定該鍵的逾時被100秒。
用ttl指令看一下目前還剩下多少秒,從結果中可以看出還剩下96秒。
(integer) 96
重新更新該鍵的逾時時間為20秒,從傳回值可以看出該指令執行成功。
redis 127.0.0.1:6379> expire mykey 20
再用ttl确認一下,從結果中可以看出果然被更新了。
(integer) 17
立刻更新該鍵的值,以使其逾時無效。
redis 127.0.0.1:6379> set mykey “world”
從ttl的結果可以看出,在上一條修改該鍵的指令執行後,該鍵的逾時也無效了。
type/randomkey/sort:
由于mm鍵在資料庫中不存在,是以該指令傳回none。
redis 127.0.0.1:6379> type mm
none
mykey的值是字元串類型,是以傳回string。
redis 127.0.0.1:6379> type mykey
string
準備一個值是set類型的鍵。
redis 127.0.0.1:6379> sadd mysetkey 1 2
mysetkey的鍵是set,是以傳回字元串set。
redis 127.0.0.1:6379> type mysetkey
set
傳回資料庫中的任意鍵。
redis 127.0.0.1:6379> randomkey
“oldkey”
清空目前打開的資料庫。
由于沒有資料了,是以傳回nil。