在定位問題、測試等時候經常需要對memcache的數據進行一些操作,但是其本身沒有自帶的客戶端,所以只能通過telnet來進行操作。
通過telnet連接memcache。
復制代碼 代碼如下:
telnet 127.0.0.1 11211
memcache寫入操作
telnet寫入memcache命令格式
復制代碼 代碼如下:
<command name> <key> <flags> <exptime> <bytes>\r\n <data block>\r\n
參數詳解:
1.<command name> 可以是”set”, “add”, “replace”。
set:<key>不存在時添加,<key>存在時覆蓋。
add:<key>不存在時添加,<key>存在時則會操作失敗。
replace:<key>不存在時添加失敗,<key>存在時替換數據
2.<key> 保存數據的key
3.<flags> 是一個16位的無符號的整數(以十進制的方式表示)。
該標志將和需要存儲的數據一起存儲,並在客戶端get數據時返回。
客戶可以將此標志用做特殊用途,此標志對服務器來說是透明的。
4.<exptime> 過期的時間。
0表示存儲的數據永遠不過時(但可被服務器算法:LRU 等替換)。
非0(unix時間),當過期後,服務器可以保證用戶得不到該數據(以服務器時間為標准)。
5.<bytes> 需要存儲的字節數(不包含最後的”\r\n”),當用戶希望存儲空數據時,可以為0
6.最後客戶端需要加上”\r\n”作為”命令頭”的結束標志。
7.<data block>\r\n
緊接著”命令頭”結束之後就要發送數據塊(即希望存儲的數據內容),最後加上”\r\n”作為此次通訊的結束。
telnet響應命令
當以上數據發送結束之後,服務器將返回一個應答。可能有如下的情況:
1.STORED\r\n:表示存儲成功
2.NOT_STORED\r\n: 表示存儲失敗,但是該失敗不是由於錯誤。
> 通常這是由於”add”或者”replace”命令本身的要求所引起的,或者該項在刪除隊列之中。
示例
復制代碼 代碼如下:
set key 32 0 10\r\n
helloworld\r\n
STORED\r\n
獲取Key&Value
獲取命令格式
復制代碼 代碼如下:
get <key>*\r\n
參數詳解:
1.<key>*: 表示一個或者多個key(以空格分開)
2.\r\n:命令結束
響應結果
服務器端將返回0個或者多個的數據項。每個數據項都是由一個文本行和一個數據塊組成。當所有的數據項都接收完畢將收到END\r\n每一項的數據結構:
復制代碼 代碼如下:
VALUE <key> <flags> <bytes>\r\n
<data block>\r\n
參數詳解:
1.<key> 希望得到存儲數據的key
2.<falg> 發送set命令時設置的標志項
3.<bytes>發送數據塊的長度(不包含”\r\n”)
4.\r\n 文本行的結束標志
5.<data block> 希望接收的數據項。
6.\r\n 接收一個數據項的結束標志。
PS:如果有些key出現在get命令行中但沒有返回相應的數據,這意味著服務器中不存在改項,可能是超時了,或者被刪除了.
示例
復制代碼 代碼如下:
get key
VALUE key 32 10
helloworld
END
刪除KeyValue:
復制代碼 代碼如下:delete <key> <time>\r\n
參數詳解:
1.<key> 需要被刪除數據的key
2.<time> 客戶端希望服務器將該數據刪除的時間(unix時間或者從現在開始的秒數)
3.\r\n命令頭的結束
檢查Memcache服務器狀態
復制代碼 代碼如下:stats\r\n
在這裡可以看到memcache的獲取次數,當前連接數,寫入次數,已經命中率等;
復制代碼 代碼如下:
pid : 進程id
uptime :總的運行時間,秒數
time : 當前時間
version : 版本號
……
curr_items : 當前緩存中的KeyValue數量
total_items : 曾經總共經過緩存的KeyValue數量
bytes : 所有的緩存使用的內存量
curr_connections 當前連接數
….
cmd_get : 總獲取次數
cmd_set : 總的寫入次數
get_hits : 總的命中次數
miss_hits : 獲取失敗次數
…..
bytes_read : 總共讀取的流量字節數
bytes_written : 總的寫入流量字節
limit_maxbytes : 最大允許使用的內存量,字節
清空統計數據:
復制代碼 代碼如下:
stats reset
清空所有鍵值
復制代碼 代碼如下:
flush_all
注:flush並不會將items刪除,只是將所有的items標記為expired,因此這時memcache依舊占用所有內存。
退出
復制代碼 代碼如下:
quit\r\n
其他命令
1.顯示各個slab的信息,包括chunk的大小、數目、使用情況等
復制代碼 代碼如下:stats slabs
2.顯示各個slab中item的數目和最老item的年齡(最後一次訪問距離現在的秒數)
復制代碼 代碼如下:stats items
3.設置或者顯示詳細操作記錄
復制代碼 代碼如下:stats detail [on|off|dump]
參數為on,打開詳細操作記錄
參數為off,關閉詳細操作記錄
參數為dump,顯示詳細操作記錄(每一個鍵值get、set、hit、del的次數)
4.顯示某個slab中的前limit_num個key列表
復制代碼 代碼如下:stats cachedump slab_id limit_num
顯示格式如下:
復制代碼 代碼如下:ITEM <key_name> [ <value_length> b; <expire_time|access_time> s]
<key_name>:鍵名
<value_length>:值長度(單位字節)
<expire_time|access_time>:memcached 1.2.2及以前版本顯示的是 訪問時間(timestamp)