一、儲存命令格式
<command> <key> <flags> <exptime> <bytes>\r\n
<data block>\r\n
command:set/add/replace/append/prepend/cas
flags:客戶端自定義標記(如壓縮、序列化標識)
exptime:過期時間(Unix 時間戳或秒數,0=永不過期)
bytes:資料區塊位元組數
二、核心儲存命令
| 命令 | 行為 | 回應 |
set | 無條件儲存(新增或覆蓋) | STORED / NOT_STORED |
add | 鍵不存在時新增 | STORED / NOT_STORED |
replace | 鍵存在時覆蓋 | STORED / NOT_STORED |
append | 在現有值後附加 | STORED / NOT_STORED |
prepend | 在現有值前置入 | STORED / NOT_STORED |
cas | 檢查並設定(需搭配 gets 取得版本號) | STORED / EXISTS / NOT_FOUND |
實戰範例
# set 命令
set mykey 0 60 5
hello
> STORED
# 讀取驗證
get mykey
> VALUE mykey 0 5
> hello
> END
# 刪除
delete mykey
> DELETED
# 僅新增
add newkey 0 60 5
world
> STORED
# 僅覆蓋
replace mykey 0 60 5
newval
> STORED
三、讀取命令
| 命令 | 說明 |
get key1 key2 ... | 讀取一或多個鍵值 |
gets key1 key2 ... | 同 get,但額外回傳 CAS 版本號(用於樂觀鎖) |
cas key flags exptime bytes cas_token | 僅當版本號匹配時寫入 |
CAS 樂觀鎖範例
# 取得值與版本號
gets counter
> VALUE counter 0 1 10
> 5
> 1234567890 # 這是 CAS token
> END
# 嘗試更新(版本號匹配成功)
cas counter 0 60 1 1234567890
6
> STORED
# 另一客戶端已修改,版本號不匹配
cas counter 0 60 1 1234567890
7
> EXISTS
四、統計與監控命令
| 命令 | 用途 |
stats | 通用統計(命中率、連線數、記憶體用量等) |
stats items | 列出所有 slab 及其項目數 |
stats slabs | slab 記憶體分配細節 |
stats sizes | 項目大小分佈統計 |
stats cachedump <slab_id> <limit> | 導出指定 slab 的鍵列表(limit=0 為全部) |
stats reset | 重置統計計數器 |
遍歷所有鍵值流程
# 1. 取得 slab 列表
stats items
> STAT items:1:number 50
> STAT items:2:number 30
> END
# 2. 導出 slab 1 的所有鍵
stats cachedump 1 0
> ITEM key1 [100 b; 1234567890 s]
> ITEM key2 [200 b; 1234567891 s]
> END
# 3. 逐一 get 取得值
get key1 key2 ...
五、其他常用命令
| 命令 | 說明 |
incr key value | 數值遞增(需為 64 位無號整數) |
decr key value | 數值遞減 |
flush_all [delay] | 立即或延遲使所有項目失效(不釋放記憶體,採惰性刪除) |
version | 查看版本 |
verbosity | 增加日誌詳細度 |
quit | 關閉連線 |
六、效能調優關鍵指標
- 命中率 =
get_hits / (get_hits + get_misses),建議 > 90%
- 驅逐數 (
evictions) 增長快表示記憶體不足,需增加 -m
- 連線數 接近
-c 限制需擴容或優化連線池