一、概述:
在系列的前幾篇部落格中,主要講述的是與Redis資料型態相關的指令,如String、List、Set、Hashes和Sorted-Set。這些命令都具有一個共同點,即所有的操作都是針對與Key關聯的Value的。而這篇部落格將主要講述與Key相關的Redis指令。學習這些指令對於學習Redis是非常重要的基礎,也是能夠充分挖掘Redis潛力的利器。
在該篇部落格中,我們將一如既往的給出所有相關命令的明細列表和典型示例,以便於我們現在的學習和今後的查閱。
二、相關指令列表:
指令原型 | 時間複雜度 | 指令描述 | 回傳值 |
KEYS pattern | O( | KEYS pattern | 取得所有符合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 ...]] [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"
3. TYPE/RANDOMKEY/SORT :
#为后面的示例准备的测试数据。 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