memcached 經常使用命令及使用說明

memcached 經常使用命令及使用說明

一、啓動Memcache 經常使用參數

 

-p <num>      設置TCP端口號(默認設置爲: 11211)
-U <num>      UDP監聽端口(默認: 11211, 0 時關閉) 
-l <ip_addr>  綁定地址(默認:全部都容許,不管內外網或者本機更換IP，有安全隱患，若設置爲127.0.0.1就只能本機訪問)
-c <num>      max simultaneous connections (default: 1024)
-d            以daemon方式運行
-u <username> 綁定使用指定用於運行進程<username>
-m <num>      容許最大內存用量，單位M (默認: 64 MB)
-P <file>     將PID寫入文件<file>，這樣可使得後邊進行快速進程終止, 須要與-d 一塊兒使用

 

 

更多可使用者 memcached -h
在linux下：./usr/local/bin/memcached -d -u root  -l 192.168.1.197 -m 2048 -p 12121
在window下：d:\App_Serv\memcached\memcached.exe -d RunService -l 127.0.0.1 -p 11211 -m 500
在windows下注冊爲服務後運行：
sc.exe create Memcached_srv binpath= 「d:\App_Serv\memcached\memcached.exe -d RunService -p 11211 -m 500″start= auto
net start Memcached

 

二、鏈接和退出

telnet 127.0.0.1 11211
quit

三、基本命令

五種基本 memcached 命令執行最簡單的操做。這些命令和操做包括：

set
add
replace
get
delete

前三個命令是用於操做存儲在 memcached 中的鍵值對的標準修改命令。它們都很是簡單易用，且都使用以下 所示的語法：

 

command <key> <flags> <expiration time> <bytes>
<value>

參數說明以下：
command set/add/replace
key     key 用於查找緩存值
flags     能夠包括鍵值對的整型參數，客戶機使用它存儲關於鍵值對的額外信息
expiration time     在緩存中保存鍵值對的時間長度（以秒爲單位，0 表示永遠）
bytes     在緩存中存儲的字節點
value     存儲的值（始終位於第二行）

 

如今，咱們來看看這些命令的實際使用。

3.1 set
set 命令用於向緩存添加新的鍵值對。若是鍵已經存在，則以前的值將被替換。
注意如下交互，它使用了 set 命令：

set userId 0 0 5
12345
STORED

若是使用 set 命令正確設定了鍵值對，服務器將使用單詞 STORED 進行響應。本示例向緩存中添加了一個鍵值對，其鍵爲userId，其值爲12345。並將過時時間設置爲 0，這將向 memcached 通知您但願將此值存儲在緩存中直到刪除它爲止。

3.2 add
僅當緩存中不存在鍵時，add 命令纔會向緩存中添加一個鍵值對。若是緩存中已經存在鍵，則以前的值將仍然保持相同，而且您將得到響應 NOT_STORED。
下面是使用 add 命令的標準交互：

 

set userId 0 0 5
12345
STORED
add userId 0 0 5
55555
NOT_STORED
add companyId 0 0 3
564
STORED

 

3.3 replace
僅當鍵已經存在時，replace 命令纔會替換緩存中的鍵。若是緩存中不存在鍵，那麼您將從 memcached 服務器接受到一條 NOT_STORED 響應。
下面是使用 replace 命令的標準交互：

replace accountId 0 0 5
67890
NOT_STORED
set accountId 0 0 5
67890
STORED
replace accountId 0 0 5
55555
STORED

 

最後兩個基本命令是 get 和 delete。這些命令至關容易理解，而且使用了相似的語法，以下所示：

command <key>

接下來看這些命令的應用。

3.4 get
get 命令用於檢索與以前添加的鍵值對相關的值。您將使用 get 執行大多數檢索操做。
下面是使用 get 命令的典型交互：

 

set userId 0 0 5
12345
STORED
get userId
VALUE userId 0 5
12345
END
get bob
END

 

如您所見，get 命令至關簡單。您使用一個鍵來調用 get，若是這個鍵存在於緩存中，則返回相應的值。若是不存在，則不返回任何內容。

3.5 delete
最後一個基本命令是 delete。delete 命令用於刪除 memcached 中的任何現有值。您將使用一個鍵調用delete，若是該鍵存在於緩存中，則刪除該值。若是不存在，則返回一條NOT_FOUND 消息。
下面是使用 delete 命令的客戶機服務器交互：

 

set userId 0 0 5
98765
STORED
delete bob
NOT_FOUND
delete userId
DELETED
get userId
END

 

能夠在 memcached 中使用的兩個高級命令是 gets 和 cas。gets 和cas 命令須要結合使用。您將使用這兩個命令來確保不會將現有的名稱/值對設置爲新值（若是該值已經更新過）。咱們來分別看看這些命令。

3.6 gets
gets 命令的功能相似於基本的 get 命令。兩個命令之間的差別在於，gets 返回的信息稍微多一些：64 位的整型值很是像名稱/值對的 「版本」 標識符。
下面是使用 gets 命令的客戶機服務器交互：

 

set userId 0 0 5
12345
STORED
get userId
VALUE userId 0 5
12345
END
gets userId
VALUE userId 0 5 4
12345
END

 

考慮 get 和 gets 命令之間的差別。gets 命令將返回一個額外的值 — 在本例中是整型值 4，用於標識名稱/值對。若是對此名稱/值對執行另外一個set 命令，則gets 返回的額外值將會發生更改，以代表名稱/值對已經被更新。顯示了一個例子：

 

set userId 0 0 5
33333
STORED
gets userId
VALUE userId 0 5 5
33333
END

您看到 gets 返回的值了嗎？它已經更新爲 5。您每次修更名稱/值對時，該值都會發生更改。

3.7 cas
cas（check 和 set）是一個很是便捷的 memcached 命令，用於設置名稱/值對的值（若是該名稱/值對在您上次執行 gets 後沒有更新過）。它使用與 set 命令相相似的語法，但包括一個額外的值：gets 返回的額外值。
注意如下使用 cas 命令的交互：

 

set userId 0 0 5
55555
STORED
gets userId
VALUE userId 0 5 6
55555
END
cas userId 0 0 5 6
33333
STORED

 

如您所見，我使用額外的整型值 6 來調用 gets 命令，而且操做運行很是順序。如今，咱們來看看中的一系列命令：
使用舊版本指示符的 cas 命令

 

set userId 0 0 5
55555
STORED
gets userId
VALUE userId 0 5 8
55555
END
cas userId 0 0 5 6
33333
EXISTS

 

注意，我並未使用 gets 最近返回的整型值，而且 cas 命令返回 EXISTS 值以示失敗。從本質上說，同時使用gets 和cas 命令能夠防止您使用自上次讀取後通過更新的名稱/值對。

緩存管理命令
最後兩個 memcached 命令用於監控和清理 memcached 實例。它們是 stats 和 flush_all 命令。

3.8 stats
stats 命令的功能正如其名：轉儲所鏈接的 memcached 實例的當前統計數據。在下例中，執行 stats 命令顯示了關於當前 memcached 實例的信息：

 

STAT pid 22459                             進程ID
STAT uptime 1027046                        服務器運行秒數
STAT time 1273043062                       服務器當前unix時間戳
STAT version 1.4.4                         服務器版本
STAT libevent 2.0.21-stable
STAT pointer_size 64                       操做系統字大小(這臺服務器是64位的)
STAT rusage_user 0.040000                  進程累計用戶時間
STAT rusage_system 0.260000                進程累計系統時間
STAT curr_connections 10                   當前打開鏈接數
STAT total_connections 82                  曾打開的鏈接總數
STAT connection_structures 13              服務器分配的鏈接結構數
STAT reserved_fds 20
STAT cmd_get 54                            執行get命令總數
STAT cmd_set 34                            執行set命令總數
STAT cmd_flush 3                           指向flush_all命令總數
STAT get_hits 9                            get命中次數
STAT get_misses 45                         get未命中次數
STAT delete_misses 5                       delete未命中次數
STAT delete_hits 1                         delete命中次數
STAT incr_misses 0                         incr未命中次數
STAT incr_hits 0                           incr命中次數
STAT decr_misses 0                         decr未命中次數
STAT decr_hits 0                           decr命中次數
STAT cas_misses 0                          cas未命中次數
STAT cas_hits 0                            cas命中次數
STAT cas_badval 0                          使用擦拭次數
STAT touch_hits 0
STAT touch_misses 0
STAT auth_cmds 0
STAT auth_errors 0
STAT bytes_read 15785                      讀取字節總數
STAT bytes_written 15222                   寫入字節總數
STAT limit_maxbytes 67108864               分配的內存數（字節）
STAT accepting_conns 1                     目前接受的連接數
STAT listen_disabled_num 0                
STAT time_in_listen_disabled_us 0
STAT threads 4                             線程數
STAT conn_yields 0
STAT hash_power_level 16
STAT hash_bytes 524288
STAT hash_is_expanding 0
STAT malloc_fails 0
STAT conn_yields 0
STAT bytes 0                               存儲item字節數
STAT curr_items 0                          item個數
STAT total_items 34                        item總數
STAT expired_unfetched 0
STAT evicted_unfetched 0
STAT evictions 0                           爲獲取空間刪除item的總數
STAT reclaimed 0
STAT crawler_reclaimed 0
STAT crawler_items_checked 0
STAT lrutail_reflocked 0

 

此處的大多數輸出都很是容易理解。咱們先來看看輸出，而後再使用新的鍵來運行一些 set 命令，並再次運行stats 命令，注意發生了哪些變化。

stats items
執行stats items，能夠看到STAT items行，若是memcached存儲內容不少，那麼這裏也會列出不少的STAT items行。

 

STAT items:1:number 3
STAT items:1:age 1698
STAT items:1:evicted 0
STAT items:1:evicted_nonzero 0
STAT items:1:evicted_time 0
STAT items:1:outofmemory 0
STAT items:1:tailrepairs 0
STAT items:1:reclaimed 0
STAT items:1:expired_unfetched 0
STAT items:1:evicted_unfetched 0
STAT items:1:crawler_reclaimed 0
STAT items:1:crawler_items_checked 0
STAT items:1:lrutail_reflocked 0
END

 

stats cachedump slabs_id limit_num
slabs_id:由stats items返回的結果（STAT items後面的數字）決定的
limit_num:返回的記錄數，0表示返回全部記錄
經過stats items、stats cachedump slab_id limit_num配合get命令能夠遍歷memcached的記錄。

 

stats cachedump 1 0
ITEM userId [5 b; 1467903379 s]
ITEM accountId [5 b; 1467903379 s]
ITEM companyId [3 b; 1467903379 s]
END
stats cachedump 1 2
ITEM userId [5 b; 1467903379 s]
ITEM accountId [5 b; 1467903379 s]
END

 

stats slabs 顯示各個slab的信息，包括chunk的大小、數目、使用狀況等

 

STAT 1:chunk_size 96
STAT 1:chunks_per_page 10922
STAT 1:total_pages 1
STAT 1:total_chunks 10922
STAT 1:used_chunks 3
STAT 1:free_chunks 10919
STAT 1:free_chunks_end 0
STAT 1:mem_requested 232
STAT 1:get_hits 9
STAT 1:cmd_set 14
STAT 1:delete_hits 1
STAT 1:incr_hits 0
STAT 1:decr_hits 0
STAT 1:cas_hits 0
STAT 1:cas_badval 0
STAT 1:touch_hits 0
STAT active_slabs 1
STAT total_malloced 1048512

 

stats sizes 輸出全部item的大小和個數

STAT 96 3

stats reset 清空統計數據

stats reset
RESET

3.9 flush_all
flush_all 是最後一個要介紹的命令。這個最簡單的命令僅用於清理緩存中的全部名稱/值對。若是您須要將緩存重置到乾淨的狀態，則 flush_all 能提供很大的用處。下面是一個使用 flush_all 的例子：

 

set userId 0 0 5
55555
STORED
get userId
VALUE userId 0 5
55555
END
flush_all
OK
get userId
END

 

追加與清除命令

3.10 append
append 將數據追加到當前緩存數據的以後，當緩存數據存在時才存儲。

 

set username 0 0 8
wayne173
STORED
get username
VALUE username 0 8
wayne173
END
append username 0 0 5
_ages
STORED
get username
VALUE username 0 13
wayne173_ages
END

 

3.11 prepend
prepend 將數據追加到當前緩存數據的以前，當緩存數據存在時才存儲。

 

set username 0 0 8
wayne173
STORED
get username
VALUE username 0 8
wayne173
END
prepend username 0 0 5
name_
STORED
get username
VALUE username 0 13
name_wayne173
END