Redis | Redis常用命令及示例總結(API)

多氯環己烷發表於2021-12-03

目錄


前言

參考文件http://doc.redisfans.com/index.html

本篇主要總結Redis的常用命令,筆者在記錄命令時的格式如下:

  • 命令關鍵字命令示例;命令說明;
    • 命令引數解釋及一些說明;

其中命令關鍵字使用小寫是為了方便記憶,按規範來說應該採用大寫字母。實際中大小寫不區分,大寫小寫Redis都能識別命令。Redis在設定命令時有一些互通的思想,如下:

設定操作有則覆蓋,無則新建。 在設定鍵值對時,若key已經存在,則將新值覆蓋舊值;反之則建立一個新的鍵值對;
索引操作可以負數。 一些 start 和 end 的偏移量可以使用負數。負數偏移量表示從字串最後開始計數, -1 表示最後一個字元,而 -2 表示倒數第二個位,以此類推;
使用inf表示最值。 inf可以在不知道有序集的最低和最高 score 值的情況下,使用 ZRANGEBYSCORE 這類命令;

文章會根據筆者的學習進度持續更新……


1. Key(鍵)

key為鍵值對的鍵;value為鍵值對的值;[]為可省內容;pattern為給定格式,類比正則式;seconds和timestamp表示時間;timeout表示時間,單位ms;host:port為主機名:埠號;ttl為毫秒值;

1.1 鍵的基本操作功能

del move sort rename renamenx migrate

  • delDEL key [key ...];刪除給定的一個或多個 key;

  • moveMOVE key db;將當前資料庫的 key 移動到給定的資料庫 db 當中;

  • sortSORT key [BY pattern] [LIMIT offset count] [GET pattern [GET pattern ...]] [ASC | DESC] [ALPHA] [STORE destination];返回或儲存給定列表、集合、有序集合 key 中經過排序的元素。排序預設以數字作為物件,值被解釋為雙精度浮點數,然後進行比較;

    • SORT key 返回鍵值從小到大排序的結果;
    • SORT key DESC 返回鍵值從大到小排序的結果;
  • renameRENAME key newkey;將 key 改名為 newkey;

  • renamenxRENAMENX key newkey;當且僅當 newkey 不存在時,將 key 改名為 newkey;

  • migrateMIGRATE host port key destination-db timeout [COPY] [REPLACE];將 key 原子性地從當前例項傳送到目標例項 host:port 的指定資料庫上,一旦傳送成功, key 保證會出現在目標例項上,而當前例項上的 key 會被刪除;

    • COPY :不移除源例項上的 key;
    • REPLACE :替換目標例項上已存在的 key;

1.2 鍵的獲取功能

type exists randomkey keys

  • typeTYPE key;返回資料庫鍵對應的型別;
  • existsEXISTS key;檢查給定 key 是否存在;
  • randomkeyRANDOMKEY;從當前資料庫中隨機返回(不刪除)一個 key ;
  • keysKEYS pattern;查詢所有符合給定模式 pattern 的 key;
    • KEYS * 匹配資料庫中所有 key;
    • KEYS h?llo 匹配 hello , hallo 和 hxllo 等;
    • KEYS h*llo 匹配 hllo 和 heeeeello 等;
    • KEYS h[ae]llo 匹配 hello 和 hallo ,但不匹配 hillo;
    • 特殊符號用 \ 隔開;

1.3 生存時間的功能

expire pexpire expireat persist ttl pttl

  • expireEXPIRE key seconds;將鍵key的生存時間設定為 seconds 秒;
  • pexpirePEXPIRE key milliseconds;與 EXPIRE 命令的作用類似,將鍵key的生存時間設定為 milliseconds 毫秒;
  • expireatEXPIREAT key timestamp;將鍵 key 的過期時間設定為 timestamp 所指定的秒數時間戳;
  • pexpireatPEXPIREAT key milliseconds-timestamp;與 EXPIREAT 命令的作用類似,將鍵 key 的過期時間設定為 milliseconds-timestamp 所指定的毫秒數時間戳;
  • persistPERSIST key;移除給定 key 的生存時間,將這個 key 從『易失的』(帶生存時間 key )轉換成『持久的』(一個不帶生存時間、永不過期的 key );
  • ttlTTL key;以秒為單位,返回給定 key 的剩餘生存時間(TTL, time to live);
  • pttlPTTL key;這個命令類似於 TTL 命令,但它以毫秒為單位返回 key 的剩餘生存時間,而不是像 TTL 命令那樣,以秒為單位;

1.4 序列化與反序列化的功能

dump restore

  • dumpDUMP key;序列化給定 key ,並返回被序列化的值,使用 RESTORE 命令可以將這個值反序列化為 Redis 鍵。序列化生成的值有以下幾個特點:
    • 它帶有 64 位的校驗和,用於檢測錯誤, RESTORE 在進行反序列化之前會先檢查校驗和;
    • 值的編碼格式和 RDB 檔案保持一致;
    • RDB 版本會被編碼在序列化值當中,如果因為 Redis 的版本不同造成 RDB 格式不相容,那麼 Redis 會拒絕對這個值進行反序列化操作;
  • restoreRESTORE key ttl serialized-value;反序列化給定的序列化值,並將它和給定的 key 關聯。引數 ttl 以毫秒為單位為 key 設定生存時間;如果 ttl 為 0 ,那麼不設定生存時間;

1.5 鍵的迭代遍歷功能

scan

  • scanSCAN cursor [MATCH pattern] [COUNT count];SCAN 命令是一個基於遊標的迭代器(cursor based iterator): SCAN 命令每次被呼叫之後, 都會向使用者返回一個新的遊標, 使用者在下次迭代時需要使用這個新遊標作為 SCAN 命令的遊標引數, 以此來延續之前的迭代過程;
    • 當 SCAN 命令的遊標引數被設定為 0 時, 伺服器將開始一次新的迭代;
    • 而當伺服器向使用者返回值為 0 的遊標時, 表示迭代已結束;

1.6 OBJECT命令

refcount ecoding idletime

  • object refcountOBJECT REFCOUNT key;返回給定 key 引用所儲存的值的次數。此命令主要用於除錯;
  • object ecodingOBJECT ENCODING key;檢視一個資料庫鍵的值物件編碼;
  • object idletimeOBJECT IDLETIME key;返回給定 key 自儲存以來的空轉時間,單位秒;

2. String(字串)

key為鍵值對的鍵;value為鍵值對的值;increment為浮點數增量;offset為數字,表示偏移量;start和end為數字,表示索引;destkey表示結果;

2.1 鍵值對的操作功能

set get setnx getset mset mget msetnx setex psetex

  • setSET key "value";設定鍵值對;
  • getGET key;根據鍵獲取值;
  • setnxSETNX key value;將 key 的值設為 value ,當且僅當 key 不存在;
  • getsetGETSET key value;將給定 key 的值設為 value ,並返回 key 的舊值(old value);
  • msetMSET key value [key value ...];同時設定一個或多個 key-value 對;
  • mgetMGET key [key ...];返回所有(一個或多個)給定 key 的值value;
  • msetnxMSETNX key value [key value ...];同時設定一個或多個 key-value 對,當且僅當所有給定 key 都不存在才成功;
  • setexSETEX key seconds value;將值 value 關聯到 key ,並將 key 的生存時間設為 seconds (以秒為單位);
  • psetexPSETEX key milliseconds value;這個命令和 SETEX 命令相似,但它以毫秒為單位設定 key 的生存時間,而不是像 SETEX 命令那樣,以秒為單位;

2.2 獲取與追加的功能

strlen append setrange getrange

  • strlenSTRLEN key;返回 key 所儲存的字串值的長度;
  • appendAPPEND key value;如果 key 已經存在並且是一個字串, APPEND 命令將 value 追加到 key 原來的值的末尾;
  • setrangeSETRANGE key offset value;用 value 引數覆寫(overwrite)給定 key 所儲存的字串值,從偏移量 offset 開始;
  • getrangeGETRANGE key [start] [end];返回 key 中字串值的子字串,字串的擷取範圍由 start 和 end 兩個偏移量決定(包括 start 和 end 在內)(負數偏移量表示從字串最後開始計數, -1 表示最後一個字元);

2.3 數字與浮點數的操作功能

incrby incr incrbyfloat decrby decr

  • incrbyINCRBY key increment;將 key 所儲存的整數值加上增量 increment;
  • incrINCR key;將 key 中儲存的數字值增 1;
  • incrbyfloatINCRBYFLOAT key increment;為 key 中所儲存的值加上浮點數增量 increment;
  • decrbyDECRBY key decrement;將 key 所儲存的值減去減量 decrement;
  • decrDECR key;將 key 中儲存的數字值減 1;

2.4 二進位制位操作的功能

setbit getbit bitcount bitop

  • setbitSETBIT key offset value;對 key 所儲存的字串值,設定或清除指定偏移量上的位(bit);
  • getbitGETBIT key offset;對 key 所儲存的字串值,獲取指定偏移量上的位(bit);
  • bitcountBITCOUNT key [start] [end];計算給定字串中,被設定為 1 的位元位的數量;
  • bitopBITOP operation destkey key [key ...];對一個或多個儲存二進位制位的字串 key 進行位元操作,並將結果儲存到 destkey 上(operation 可以是 AND 、 OR 、 NOT 、 XOR 這四種操作中的任意一種);

3. List(列表)

key為鍵值對的鍵;value為鍵值對的值;[]為可省內容,這裡表示一個或多個;timeout為數字,表示超時時間;index為數字,表示下標;pivot為某個值;start和stop為區間的下標;count為數字,表示計數器;source和destination為兩個連結串列的key,前者表示來源,後者表示目的;

3.1 新增與修改元素的功能

rpush rpushx lpush lpushx linsert lset

  • rpushRPUSH key value [value ...];將一個或多個值 value 插入到列表 key 的表尾(最右邊),當 key 不存在時,會建立空列表並執行 LPUSH 操作;
  • rpushxRPUSHX key value;將值 value 插入到列表 key 的表尾,當且僅當 key 存在並且是一個列表時操作成功;
  • lpushLPUSH key value [value ...];將一個或多個值 value 插入到列表 key 的表頭(最左邊)。當 key 不存在時,會建立空列表並執行 LPUSH 操作;
  • lpushxLPUSHX key value;將值 value 插入到列表 key 的表頭,當且僅當 key 存在並且是一個列表時操作成功;
  • linsert ... before|afterLINSERT key BEFORE|AFTER pivot value;將值 value 插入到列表 key 當中,位於值 pivot 之前或之後;
  • lsetLSET key index value;將列表 key 下標為 index 的元素的值設定為 value;

3.2 移除元素的功能

lpop blpop rpop brpop lrem

  • lpopLPOP key;移除並返回列表 key 的頭元素;
  • blpopBLPOP key [key ...] timeout;列表的阻塞式(blocking)彈出原語。當給定多個 key 引數時,按引數 key 的先後順序依次檢查各個列表,彈出第一個非空列表的頭元素;
  • rpopRPOP key;移除並返回列表 key 的尾元素;
  • brpopBRPOP key [key ...] timeout;列表的阻塞式(blocking)彈出原語。當給定多個 key 引數時,按引數 key 的先後順序依次檢查各個列表,彈出第一個非空列表的尾部元素;
  • lremLREM key count value;根據引數 count 的值,移除列表中與引數 value 相等的元素;
    • count > 0 : 從表頭開始向表尾搜尋,移除與 value 相等的元素,數量為 count;
    • count < 0 : 從表尾開始向表頭搜尋,移除與 value 相等的元素,數量為 count 的絕對值;
    • count = 0 : 移除表中所有與 value 相等的值;

3.3 列表與元素的獲取功能

llen lingex lrange

  • llenLLEN key;返回列表 key 的長度;
  • lingexLINDEX key index;返回列表 key 中,下標為 index 的元素;
  • lrangeLRANGE key start stop;返回列表 key 中指定區間 [start, stop] 內的元素;

3.4 列表的操作功能

ltrim rpoplpush brpoplpush

  • ltrimLTRIM key start stop;對一個列表進行修剪(trim),保留區間 [start, stop] 內的元素;
  • rpoplpushRPOPLPUSH source destination;在一個原子時間內,執行以下兩個動作:
    • 將列表 source 中的最後一個元素(尾元素)彈出,並返回給客戶端;
    • 將 source 彈出的元素插入到列表 destination ,作為 destination 列表的的頭元素;
  • brpoplpushBRPOPLPUSH source destination timeout;是 RPOPLPUSH 的阻塞版本;
    • 當給定列表 source 不為空時, BRPOPLPUSH 的表現和 RPOPLPUSH 一樣;
    • 當列表 source 為空時, BRPOPLPUSH 命令將阻塞連線,直到等待超時,或有另一個客戶端對 source 執行 LPUSH 或 RPUSH 命令為止;

4. Hash(雜湊表)

key為雜湊表;field為鍵值對的鍵,也稱域;value為鍵值對的值;increment為數字,表示增量;

4.1 新增和修改鍵值對的功能

hset mhset hsetnx hincrby hincrbyfloat

  • hsetHSET key field value;將雜湊表 key 中的域 field 的值設為 value;
  • mhsetHMSET key field value [field value ...];同時將多個 field-value (域-值)對設定到雜湊表 key 中;
  • hsetnxHSETNX key field value;將雜湊表 key 中的域 field 的值設定為 value ,當且僅當域 field 不存在。若域 field 已經存在,該操作無效;
  • hincrbyHINCRBY key field increment;為雜湊表 key 中的域 field 的值加上整數增量 increment;
  • hincrbyfloatHINCRBYFLOAT key field increment;為雜湊表 key 中的域 field 加上浮點數增量 increment;

4.2 移除鍵值對的功能

hdel

  • hdelHDEL key field [field ...];刪除雜湊表 key 中的一個或多個指定域,不存在的域將被忽略;

4.3 鍵值對的獲取功能

hkeys hvals hgetall hexists hget hmget hlen

  • hkeysHKEYS key;返回雜湊表 key 中的所有域 field;
  • hvalsHVALS key;返回雜湊表 key 中所有域的值 value;
  • hgetallHGETALL key;返回雜湊表 key 中,所有的域 field 和值 value;
  • hexistsHEXISTS key field;檢視雜湊表 key 中,給定域 field 是否存在;
  • hgetHGET key field;返回雜湊表 key 中給定域 field 的值;
  • hmgetHMGET key field [field ...];返回雜湊表 key 中,一個或多個給定域的值;
  • hlenHLEN key;返回雜湊表 key 中域的數量;

4.4 雜湊表的迭代遍歷功能

hscan

  • hscanHSCAN key cursor [MATCH pattern] [COUNT count];參考《鍵的迭代遍歷功能 scan》;

5. Set(集合)

key為集合的鍵;member為元素;[]為可省內容,這裡表示一個或多個;source為源頭集合;destination為目標集合;count為數字;

5.1 新增和修改元素的功能

sadd

  • saddSADD key member [member ...];將一個或多個 member 元素加入到集合 key 當中,已經存在於集合的 member 元素將被忽略;

5.2 移除元素的功能

spop srem

  • spopSPOP key;移除並返回集合中的一個隨機元素;
  • sremSREM key member [member ...];移除集合 key 中的一個或多個 member 元素,不存在的 member 元素會被忽略;

5.3 元素的獲取功能

smembers sismember srandmember

  • smembersSMEMBERS key;返回集合 key 中的所有成員;
  • sismemberSISMEMBER key member;判斷集合 key 是否包含 member 元素;
  • srandmemberSRANDMEMBER key [count];如果命令執行時,只提供了 key 引數,那麼返回集合中的一個隨機元素;
    • 如果 count 為正數,且小於集合基數,那麼命令返回一個包含 count 個元素的陣列,陣列中的元素各不相同。如果 count 大於等於集合基數,那麼返回整個集合;
    • 如果 count 為負數,那麼命令返回一個陣列,陣列中的元素可能會重複出現多次,而陣列的長度為 count 的絕對值;

5.4 集合的獲取功能

scard sdiff sdiffstore sinter sinterstore sunion sunionstore

  • scardSCARD key;返回集合 key 中元素的數量;
  • sdiffSDIFF key [key ...];返回一個集合的全部成員,該集合是所有給定集合之間的差集;
  • sdiffstoreSDIFFSTORE destination key [key ...];這個命令的作用和 SDIFF 類似,但它將結果儲存到 destination 集合,而不是簡單地返回結果集;
  • sinterSINTER key [key ...];返回一個集合的全部成員,該集合是所有給定集合的交集;
  • sinterstoreSINTERSTORE destination key [key ...];這個命令類似於 SINTER 命令,但它將結果儲存到 destination 集合,而不是簡單地返回結果集;
  • sunionSUNION key [key ...];返回一個集合的全部成員,該集合是所有給定集合的並集;
  • sunionstoreSUNIONSTORE destination key [key ...];這個命令類似於 SUNION 命令,但它將結果儲存到 destination 集合,而不是簡單地返回結果集;

5.5 集合的操作功能

smove

  • smoveSMOVE source destination member;將 member 元素從 source 集合移動到 destination 集合;

5.6 集合的迭代遍歷功能

sscan

  • sscanSSCAN key cursor [MATCH pattern] [COUNT count];參考《鍵的迭代遍歷功能 scan》;

6. SortedSet(有序集合)

key為鍵值對的鍵;member為元素;score為分數權重值;[]為可省內容,這裡表示一個或多個;destination為目標集合;count為數字;min和max表示浮點數範圍區間;start和stop為區間的下標;

6.1 新增和修改元素的功能

zadd zincrby

  • zaddZADD key score member [[score member] [score member] ...];將一個或多個 member 元素及其 score 值加入到有序集 key 當中;
  • zincrbyZINCRBY key increment member;為有序集 key 的成員 member 的 score 值加上增量 increment ;

6.2 移除元素的功能

zrem zremrangebyrank zremrangebyscore

  • zremZREM key member [member ...];移除有序集 key 中的一個或多個成員,不存在的成員將被忽略;
  • zremrangebyrankZREMRANGEBYRANK key start stop;移除有序集 key 中,指定下標排名(rank)區間 [start, stop] 內的所有成員;
  • zremrangebyscoreZREMRANGEBYSCORE key min max;移除有序集 key 中,所有 score 值介於 [min, max] 之間;

6.3 元素的獲取功能

zrange zrevrange zrangebyscore zrevrangebyscore zrank zrevrank zscore

  • zrangeZRANGE key start stop [WITHSCORES];返回有序集 key 中,指定下標區間 [start, stop] 內的元素。其中成員的位置按 score 值遞增(從小到大)來排序;
  • zrevrangeZREVRANGE key start stop [WITHSCORES];返回有序集 key 中,指定區間 [start, stop] 內的元素。其中成員的位置按 score 值遞減(從大到小)來排列;
  • zrangebyscoreZRANGEBYSCORE key min max [WITHSCORES] [LIMIT offset count];返回有序集 key 中,所有 score 值介於 [min, max] 之間的成員有序整合員按 score 值遞增(從小到大)次序排列;
    • WITHSCORES 引數決定結果集是單單返回有序集的成員,還是將有序整合員及其 score 值一起返回;
    • 可以使用 (min(max 來指定開區間;
  • zrangebyscore ... -inf +infZRANGEBYSCORE key -inf +inf;顯示整個有序集;
    • 相當於min取負無窮,max取正無窮,inf可以在不知道有序集的最低和最高 score 值的情況下,使用 ZRANGEBYSCORE 這類命令;
  • zrevrangebyscoreZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count];返回有序集 key 中, score 值介於 [min, max] 之間的所有的成員。有序整合員按 score 值遞減(從大到小)的次序排列;
    • 其他類似同上;
  • zrankZRANK key member;返回有序集 key 中元素的排名 rank。其中有序整合員按 score 值遞增(從小到大)順序排列;
  • zrevrankZREVRANK key member;返回有序集 key 中元素的排名 rank。其中有序整合員按 score 值遞減(從大到小)排序;
  • zscoreZSCORE key member;返回有序集 key 中,成員 member 的 score 值;

6.4 集合的獲取功能

zcard zcount zunionstore zinterstore

  • zcardZCARD key;返回集合 key 中元素的數量;
  • zcountZCOUNT key min max;返回有序集 key 中, score 值在 min 和 max 之間(預設包括 score 值等於 min 或 max )的成員的數量;
  • zunionstoreZUNIONSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX];計算給定的一個或多個有序集的並集,其中給定 key 的數量必須以 numkeys 引數指定,並將該並集(結果集)儲存到 destination 。
    • 預設情況下,結果集中某個成員的 score 值是所有給定集下該成員 score 值之和;
    • WEIGHTS表示乘法因子,預設為1,並集後的元素的分值 score 為 score*weight;
    • AGGREGATE可以指定並集的結果集的聚合方式;
  • zinterstoreZINTERSTORE destination numkeys key [key ...] [WEIGHTS weight [weight ...]] [AGGREGATE SUM|MIN|MAX];計算給定的一個或多個有序集的交集,其中給定 key 的數量必須以 numkeys 引數指定,並將該交集(結果集)儲存到 destination ;
    • 類似性質同上;

6.5 集合的迭代遍歷功能

zscan

  • zscanZSCAN key cursor [MATCH pattern] [COUNT count];參考《鍵的迭代遍歷功能 scan》;

7. Pub/Sub(釋出/訂閱)

channel表示頻道名;pattern為一個萬用字元,表示模式名;message表示訊息;

7.1 頻道的訂閱與退訂

subscribe unsubscribe

  • subscribeSUBSCRIBE channel [channel ...];訂閱給定的一個或多個頻道的資訊;
  • subscribeSUBSCRIBE channel:message;關注 “某個鍵執行了什麼命令”,返回鍵空間通知;
  • subscribeSUBSCRIBE channel:del;關注 “某個命令被什麼鍵執行了”,返回鍵事件通知;
  • unsubscribeUNSUBSCRIBE [channel [channel ...]];退訂給定的頻道;

7.2 模式的訂閱與退訂

psubscribe punsubscribe

  • psubscribePSUBSCRIBE pattern [pattern ...];訂閱一個或多個符合給定模式的頻道。以 /* 作為匹配符;
  • punsubscribePUNSUBSCRIBE [pattern [pattern ...]];退訂所有給定模式;

7.3 傳送訊息

publish

  • publishPUBLISH channel message;資訊 message 傳送到指定的頻道 channel ;

7.4 檢視訂閱資訊

pubsub channels/numsub/bumpat

  • pubsub channelsPUBSUB CHANNELS [pattern];列出當前的活躍頻道。給出 pattern 引數,那麼只列出和給定模式 pattern 相匹配的那些活躍頻道;
  • pubsub numsubPUBSUB NUMSUB [channel-1 ... channel-N];返回給定頻道的訂閱者數量, 訂閱模式的客戶端不計算在內。;
  • pubsub bumpatPUBSUB NUMPAT;返回訂閱模式的數量;

8. Transaction(事務)

key為鍵值對的鍵;

watch unwatch multi exec discard

  • watchWATCH key [key ...];監視一個(或多個) key ,如果在事務執行之前這個(或這些) key 被其他命令所改動,那麼事務將被打斷;
  • unwatchUNWATCH;取消 WATCH 命令對所有 key 的監視;
  • multiMULTI;標記一個事務塊的開始;
  • execEXEC;執行所有事務塊內的命令。事務成功與否與 WATCH 命令相關;
  • discardDISCARD;取消事務,放棄執行事務塊內的所有命令;

9. Script(指令碼)

sha1表示校驗碼;script表示指令碼;numkeys為數字,表示引數個數; arg表示引數;

9.1 校驗相關

eval evalsha

  • evalEVAL script numkeys key [key ...] arg [arg ...];對 Lua 指令碼進行求值;
  • evalshaEVALSHA sha1 numkeys key [key ...] arg [arg ...];根據給定的 sha1 校驗碼,對快取在伺服器中的指令碼進行求值;

9.2 SCRIPT 命令

script exists/flush/kill/load

  • script existsSCRIPT EXISTS script [script ...];給定一個或多個指令碼的 SHA1 校驗和,返回一個包含 0 和 1 的列表,表示校驗和所指定的指令碼是否已經被儲存在快取當中;
  • script flushSCRIPT FLUSH;清除所有 Lua 指令碼快取;
  • script killSCRIPT KILL;殺死當前正在執行的 Lua 指令碼,當且僅當這個指令碼沒有執行過任何寫操作時,這個命令才生效;
  • script loadSCRIPT LOAD;將指令碼 script 新增到指令碼快取中,但並不立即執行這個指令碼;

10. Connection(連線)

password表示密碼;message表示資訊;index為數字,表示下標;

select ping quit auth echo

  • selectSELECT index;切換到指定的資料庫,資料庫索引號 index 用數字值指定,以 0 作為起始索引值;
  • pingPING;使用客戶端向 Redis 伺服器傳送一個 PING ,如果伺服器運作正常的話,會返回一個 PONG。通常用於測試與伺服器的連線是否仍然生效,或者用於測量延遲值;
  • quitQUIT;請求伺服器關閉與當前客戶端的連線;
  • authAUTH password;鍵入密碼。通過設定配置檔案中 requirepass 項的值(使用命令 CONFIG SET requirepass password ),可以使用密碼來保護 Redis 伺服器;
  • echoECHO message;列印一個特定的資訊 message ,測試時使用;

11. Server(伺服器)

section為可選引數;connection-name為字串,表示當前連線的名字;ip表示IP地址;port表示埠號;parameter表示配置;value表示配置的引數;argument表示引數;

11.1 伺服器的獲取功能

dbsize time lastsave monitor

  • dbsizeDBSIZE;返回當前資料庫的 key 的數量;
  • timeTIME;返回當前伺服器時間;
  • lastsaveLASTSAVE;返回最近一次 Redis 成功將資料儲存到磁碟上的時間,以 UNIX 時間戳格式表示;
  • monitorMONITOR;實時列印出 Redis 伺服器接收到的命令,除錯用;

11.2 伺服器的操作的功能

flushdb flushall shutdown salveof

  • flushdbFLUSHDB;清空當前資料庫中的所有 key;
  • flushallFLUSHALL;清空整個 Redis 伺服器的資料(刪除所有資料庫的所有 key)。此命令從不失敗;
  • shutdownSHUTDOWN;停止所有客戶端;如果有至少一個儲存點在等待,執行 SAVE 命令;如果 AOF 選項被開啟,更新 AOF 檔案;關閉 redis 伺服器;
  • slaveofSLAVEOF ip port;在 Redis 執行時動態地修改複製(replication)功能的行為。可以將當前伺服器轉變為指定伺服器的從屬伺服器;
  • slaveof no oneSLAVEOF NO ONE;使得這個從屬伺服器關閉複製功能,並從從屬伺服器轉變回主伺服器,原來同步所得的資料集不會被丟棄;
  • syncSYNC;用於複製功能(replication)的內部命令;
  • psyncPSYNC <MASTER_RUN_ID> <OFFSET>;用於複製功能(replication)的內部命令;

11.3 伺服器持久化相關

save bgsave bgrewriteaof

  • saveSAVE;執行一個同步儲存操作,將當前 Redis 例項的所有資料快照以 RDB 檔案的形式儲存到硬碟;
  • bgsaveBGSAVE;在後臺非同步(Asynchronously)儲存當前資料庫的資料到磁碟;
  • bgrewriteaofBGREWRITEAOF;AOF 檔案後臺重寫;

11.4 客戶端相關操作

client list/setname/getname/kill

  • client listCLIENT LIST;以易讀的格式,返回所有連線到伺服器的客戶端資訊和統計資料;
  • client setnameCLIENT SETNAME connection-name;為當前連線分配一個名字;
  • client getnameCLIENT GETNAME;返回 CLIENT SETNAME 命令為連線設定的名字;
  • client killCLIENT KILL ip:port;關閉地址為 ip:port 的客戶端;

11.5 伺服器的配置引數相關

config set/get/rewrite/resetstat

  • config setCONFIG SET parameter value;動態地調整 Redis 伺服器的配置(configuration)而無須重啟;
  • config getCONFIG GET parameter;取得執行中的 Redis 伺服器的配置引數(;
  • config rewriteCONFIG REWRITE;對啟動 Redis 伺服器時所指定的 redis.conf 檔案進行改寫。通過儘可能少的修改, 將伺服器當前所使用的配置記錄到 redis.conf 檔案中;
  • config resetstatCONFIG RESETSTAT;重置 INFO 命令中的某些統計資料;

11.6 Slow log 查詢執行時間日誌系統相關

slowlog get/len

  • slowlogSLOWLOG subcommand [argument];用來記錄查詢執行時間的日誌系統;
  • slowlogSLOWLOG GET [number];列印所有 slow log ,最大長度取決於 slowlog-max-len 選項的值;
  • slowlogSLOWLOG GET number;列印指定數量的日誌;
  • slowlog SLOWLOG LEN;檢視當前日誌的數量;

11.7 獲取Redis伺服器的各種資訊和統計數值

info

  • infoINFO [section];以一種易於解釋(parse)且易於閱讀的格式,返回關於 Redis 伺服器的各種資訊和統計數值。可選引數 section 如下:
    • server : 一般 Redis 伺服器資訊,包含以下域:
      • redis_version : Redis 伺服器版本;
      • redis_git_sha1 : Git SHA1;
      • redis_git_dirty : Git dirty flag;
      • os : Redis 伺服器的宿主作業系統;
      • arch_bits : 架構(32 或 64 位);
      • multiplexing_api : Redis 所使用的事件處理機制;
      • gcc_version : 編譯 Redis 時所使用的 GCC 版本;
      • process_id : 伺服器程式的 PID;
      • run_id : Redis 伺服器的隨機識別符號(用於 Sentinel 和叢集);
      • tcp_port : TCP/IP 監聽埠;
      • uptime_in_seconds : 自 Redis 伺服器啟動以來,經過的秒數;
      • uptime_in_days : 自 Redis 伺服器啟動以來,經過的天數;
      • lru_clock : 以分鐘為單位進行自增的時鐘,用於 LRU 管理;
    • clients : 已連線客戶端資訊,包含以下域:
      • connected_clients : 已連線客戶端的數量(不包括通過從屬伺服器連線的客戶端);
      • client_longest_output_list : 當前連線的客戶端當中,最長的輸出列表;
      • client_longest_input_buf : 當前連線的客戶端當中,最大輸入快取;
      • blocked_clients : 正在等待阻塞命令(BLPOP、BRPOP、BRPOPLPUSH)的客戶端的數量
    • memory : 記憶體資訊,包含以下域:
      • used_memory : 由 Redis 分配器分配的記憶體總量,以位元組(byte)為單位;
      • used_memory_human : 以人類可讀的格式返回 Redis 分配的記憶體總量;
      • used_memory_rss : 從作業系統的角度,返回 Redis 已分配的記憶體總量(俗稱常駐集大小)。這個值和 top 、 ps 等命令的輸出一致;
      • used_memory_peak : Redis 的記憶體消耗峰值(以位元組為單位);
      • used_memory_peak_human : 以人類可讀的格式返回 Redis 的記憶體消耗峰值;
      • used_memory_lua : Lua 引擎所使用的記憶體大小(以位元組為單位);
      • mem_fragmentation_ratio : used_memory_rss 和 used_memory 之間的比率;
      • mem_allocator : 在編譯時指定的, Redis 所使用的記憶體分配器。可以是 libc 、 jemalloc 或者 tcmalloc;
    • persistence : RDB 和 AOF 的相關資訊;
    • stats : 一般統計資訊;
    • replication : 主/從複製資訊;
    • cpu : CPU 計算量統計資訊;
    • commandstats : Redis 命令統計資訊;
    • cluster : Redis 叢集資訊;
    • keyspace : 資料庫相關的統計資訊;
    • all : 返回所有資訊;
    • default : 返回預設選擇的資訊;


最後

新人制作,如有錯誤,歡迎指出,感激不盡!
歡迎關注公眾號,會分享一些更日常的東西!
如需轉載,請標註出處!
Redis | Redis常用命令及示例總結(API)

相關文章