一、概述:
在該系列的前幾篇部落格中,主要講述的是與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 ...] | O(N) | 時間複雜度中的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 | O(1) | 将目前資料庫中指定的鍵Key移動到參數中指定的資料庫中。如果該Key在目标資料庫中已經存在,或者在目前 資料庫中并不存在,該指令将不做任何操作并傳回0。 | 移動成功傳回1,否則0。 |
RENAME key newkey | O(1) | 為指定指定的鍵重新命名,如果參數中的兩個Keys的指令相同,或者是源Key不存在,該指令都會傳回相關的 錯誤資訊。如果newKey已經存在,則直接覆寫。 | |
RENAMENX key newkey | O(1) | 如果新值不存在,則将參數中的原值修改為新值。其它條件和RENAME一緻。 | 1表示修改成功,否則0。 |
PERSIST key | O(1) | 如果Key存在過期時間,該指令會将其過期時間消除,使該Key不再有逾時,而是可以持久化存儲。 | 1表示Key的過期時間被移出,0表示該Key不存在或沒有過期時間。 |
EXPIRE key seconds | O(1) | 該指令為參數中指定的Key設定逾時的秒數,在超過該時間後,Key被自動的删除。如果該Key在逾時之前被 修改,與該鍵關聯的逾時将被移除。 | 1表示逾時被設定,0則表示Key不存在,或不能被設定。 |
EXPIREAT key timestamp | O(1) | 該指令的邏輯功能和EXPIRE完全相同,唯一的差别是該指令指定的逾時時間是絕對時間,而不是相對時間。 該時間參數是Unix timestamp格式的,即從1970年1月1日開始所流經的秒數。 | 1表示逾時被設定,0則表示Key不存在,或不能被設定。 |
TTL key | O(1) | 擷取該鍵所剩的逾時描述。 | 傳回所剩描述,如果該鍵不存在或沒有逾時設定,則傳回-1。 |
RANDOMKEY | O(1) | 從目前打開的資料庫中随機的傳回一個Key。 | 傳回的随機鍵,如果該資料庫是空的則傳回nil。 |
TYPE key | O(1) | 擷取與參數中指定鍵關聯值的類型,該指令将以字元串的格式傳回。 | 傳回的字元串為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的官方文檔。 | 傳回排序後的原始清單。 |
三、指令示例:
1. 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
OK
redis 127.0.0.1:6379> set mykey2 "hello"
OK
#添加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
(integer) 1
#将目前資料庫中的mysetkey鍵移入到ID為1的資料庫中,從結果可以看出已經移動成功。
redis 127.0.0.1:6379> move mysetkey 1
(integer) 1
#打開ID為1的資料庫。
redis 127.0.0.1:6379> select 1
OK
#檢視一下剛剛移動過來的Key是否存在,從傳回結果看已經存在了。
redis 127.0.0.1:6379[1]> exists mysetkey
(integer) 1
#在重新打開ID為0的預設資料庫。
redis 127.0.0.1:6379[1]> select 0
OK
#檢視一下剛剛移走的Key是否已經不存在,從傳回結果看已經移走。
redis 127.0.0.1:6379> exists mysetkey
(integer) 0
#準備新的測試資料。
redis 127.0.0.1:6379> set mykey "hello"
OK
#将mykey改名為mykey1
redis 127.0.0.1:6379> rename mykey mykey1
OK
#由于mykey已經被重新命名,再次擷取将傳回nil。
redis 127.0.0.1:6379> get mykey
(nil)
#通過新的鍵名擷取。
redis 127.0.0.1:6379> get mykey1
"hello"
#由于mykey已經不存在了,是以傳回錯誤資訊。
redis 127.0.0.1:6379> rename mykey mykey1
(error) ERR no such key
#為renamenx準備測試key
redis 127.0.0.1:6379> set oldkey "hello"
OK
redis 127.0.0.1:6379> set newkey "world"
OK
#由于newkey已經存在,是以該指令未能成功執行。
redis 127.0.0.1:6379> renamenx oldkey newkey
(integer) 0
#檢視newkey的值,發現它也沒有被renamenx覆寫。
redis 127.0.0.1:6379> get newkey
"world"
2. PERSIST/EXPIRE/EXPIREAT/TTL:
#為後面的示例準備的測試資料。
redis 127.0.0.1:6379> set mykey "hello"
OK
#将該鍵的逾時設定為100秒。
redis 127.0.0.1:6379> expire mykey 100
(integer) 1
#通過ttl指令檢視一下還剩下多少秒。
redis 127.0.0.1:6379> ttl mykey
(integer) 97
#立刻執行persist指令,該存在逾時的鍵變成持久化的鍵,即将該Key的逾時去掉。
redis 127.0.0.1:6379> persist mykey
(integer) 1
#ttl的傳回值告訴我們,該鍵已經沒有逾時了。
redis 127.0.0.1:6379> ttl mykey
(integer) -1
#為後面的expire指令準備資料。
redis 127.0.0.1:6379> del mykey
(integer) 1
redis 127.0.0.1:6379> set mykey "hello"
OK
#設定該鍵的逾時被100秒。
redis 127.0.0.1:6379> expire mykey 100
(integer) 1
#用ttl指令看一下目前還剩下多少秒,從結果中可以看出還剩下96秒。
redis 127.0.0.1:6379> ttl mykey
(integer) 96
#重新更新該鍵的逾時時間為20秒,從傳回值可以看出該指令執行成功。
redis 127.0.0.1:6379> expire mykey 20
(integer) 1
#再用ttl确認一下,從結果中可以看出果然被更新了。
redis 127.0.0.1:6379> ttl mykey
(integer) 17
#立刻更新該鍵的值,以使其逾時無效。
redis 127.0.0.1:6379> set mykey "world"
OK
#從ttl的結果可以看出,在上一條修改該鍵的指令執行後,該鍵的逾時也無效了。
redis 127.0.0.1:6379> ttl mykey
(integer) -1
3. 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
(integer) 2
#mysetkey的鍵是set,是以傳回字元串set。
redis 127.0.0.1:6379> type mysetkey
set
#傳回資料庫中的任意鍵。
redis 127.0.0.1:6379> randomkey
"oldkey"
#清空目前打開的資料庫。
redis 127.0.0.1:6379> flushdb
OK
#由于沒有資料了,是以傳回nil。
redis 127.0.0.1:6379> randomkey
(nil)