memcachedコマンドリスト

検索コマンド

検索を行うコマンド

戻値書式


VALUE []\r\n
\r\n

key 送信したキー
flags ストレージコマンドで送信したflag
bytes 取得データのデータ長
cas unique casコマンドで使用するキー(getsコマンドで取得)
data block キーのデータ
getコマンド

実行例


get hoge
VALUE hoge 0 4
test
END

getsコマンド

実行例


gets hoge
VALUE hoge 0 4 7
test
END

ストレージコマンド

データ操作を行うコマンド

実行書式


[noreply]\r\n

flags サーバがデータとともに格納して返送する値
exptime 有効期限(unix time)。もし0を指定した場合、項目が期限切れになることはありません
byte データブロックのバイト数です。
noreply オプションパラメータ。サーバーが応答を返さない
setコマンド

キーのデータを保存

実行例


set hoge1 0 0 4
hoge

addコマンド

キーのデータがまだ作成されていない場合にのみ、キーのデータを保存

実行例


add hoge2 0 2147483647 4
hoge

replaceコマンド

キーのデータが存在する場合にのみ、キーのデータを置き換えて保存

実行例


replace hoge3 0 2147483647 4
hoge

appendコマンド

キーのデータが存在する場合にのみ、キーのデータの後ろにデータを追加

実行例


append hoge2 0 2147483647 4
hoge

prependコマンド

キーのデータが存在する場合にのみ、キーのデータの前にデータを追加

実行例


prepend hoge2 0 2147483647 4
hoge

casコマンド

「Check and Set」の略でクライアントが最後にキーを取得して以降に 他のクライアントによるそのキーの更新がなかった場合にのみ保存

実行書式


[noreply]\r\n

flags サーバがデータとともに格納して返送する値
exptime 有効期限(unix time)。もし0を指定した場合、項目が期限切れになることはありません
byte データブロックのバイト数です。
cas unique getsコマンドで取得するユニークキー
noreply オプションパラメータ。サーバーが応答を返さない

実行例


gets hoge2
VALUE hoge2 1 4 6
hoge
END
cas hoge2 0 2147483647 4 5
test
EXISTS
get hoge2
VALUE hoge2 1 4
hoge
END
cas hoge2 0 2147483647 4 6
test
STORED

状態表示コマンド

memcachedの統計データなど状態表示を行うコマンド

statsコマンド

表示内容

pid プロセスID
uptime memcachedの起動時間(秒)
time 現在時刻のタイムスタンプ
version memcacheのバージョン
pointer_size OSが32bit又は64bit
rusage_user プロセスがユーザモードで動作した累計時間?(秒.マイクロ秒)
rusage_system プロセスがカーネルモードで動作した累計時間?(秒.マイクロ秒)
curr_connections 現在のコネクション数
total_connections memcacheの起動からの累計コネクション数
connection_structures memcacheが確保したコネクション構造体数
cmd_get GETコマンド発行の累計
cmd_set SETコマンド発行の累計
cmd_flush flushコマンド発行の累計
get_hits GETコマンド成功回数
get_misses GETコマンド失敗回数
delete_misses DELETEコマンド失敗回数
delete_hits DELETEコマンド成功回数
incr_misses INCRコマンド失敗成功
incr_hits INCRコマンド成功回数
decr_misses DECRコマンド失敗回数
decr_hits DECRコマンド成功回数
cas_misses CASコマンドでキーがヒットしなかった失敗回数
cas_hits CASコマンド成功回数
cas_badval CASコマンドで更新されてて失敗回数
auth_cmds
auth_errors
bytes_read ネットワークから受信したバイト数
bytes_written ネットワークへ送信したバイト数
limit_maxbytes memcacheの最大容量(バイト)
accepting_conns
listen_disabled_num
threads リクエスト当たりに動作するスレッド数
conn_yields
bytes 現在の使用メモリ
curr_items 現在のデータ数
total_items 累計のデータ数
evictions 容量(メモリ)不足でmemcacheから追い出した回数
reclaimed
stats itemsコマンド

表示内容

number スラブに保存されているレコード数
age スラブ内のもっとも古いデータの保存期間
evicted 期限切れの追い出されたレコード数
evicted_time 最後の追い出しからの期間 1.3以降?
evicted_nonzero 最後に非ゼロエントリが追い出された期間 1.4以降
outofmemory スラブ内でout of memoryエラーとなったレコード数 (-M指定時のみ)
tailrepairs 修復を必要とするレコード数
stats slabsコマンド

表示内容

chunk_size スラブ内のチャンクサイズ
chunks_per_page 1ページに保存できるチャンク数
total_pages スラブに割り当てられたページ数
total_chunks スラブに割り当てられたチャンク数
used_chunks 割り当て済チャンク数
free_chunks 未割り当てチャンク数
free_chunks_end 最後にページが割り当てられてからの未割当チャンク数
get_hits チャンクへのGETコマンドのヒット数 1.3以降
cmd_set チャンクへのSETコマンドでのセット数 1.3以降
delete_hits チャンクへのDELETEコマンドのヒット数 1.3以降
incr_hits チャンクへのINCRコマンドのヒット数 1.3以降
decr_hits チャンクへのDECRコマンドのヒット数 1.3以降
cas_hits チャンクへのCASコマンドのヒット数 1.3以降
cas_badval チャンクへのCASコマンドでEXISTS値がマッチしなかった数 1.3以降
active_slabs 割り当て済スラブ数
total_malloced メモリ使用量総計
stats sizesコマンド

サイズの統計情報キャッシュ内の各サイズのアイテムのサイズと数に関する情報
情報が2つの列として返され、最初の列は項目の大きさ(近似値の32バイト境界に切り上げ)で、
2番目の列は、キャッシュ内のそのサイズの項目数のカウントです。


stats sizes
128 195
160 91
192 348
224 83697
256 72150
288 5757
320 2441
〜略〜

※実際のチャンクの割り当てとは厳密に結びつかないのであまり使えない情報

stats detail onコマンド

memcached 1.3以降で利用可能な統計情報の取得コマンド

stats detail dumpコマンド

memcached 1.3以降で利用可能な統計情報の出力コマンド

stats cachedumpコマンド

指定スラブのキーの一覧を取得
(ただし、バッファが2MBらしいので2MB以上のデータは取得できない)

書式


stats cachedump

slab no スラブ番号
limit 表示件数

結果書式


ITEM [ b; s]

表示内容

item_key データのキー
item_size データのサイズ
expiration_timestamp 有効期限(unix time)

実行例


stats cachedump 1 3
ITEM hoge1 [4 b; 1314542107 s]
ITEM hoge2 [10 b; 1314542107 s]
ITEM hoge3 [1 b; 1600000000 s]

stats settingsコマンド(memcached 1.4〜)

起動オプションの確認

表示内容

maxbytes
maxconns
tcpport
udpport
inter
verbosity
oldest
evictions
domain_socket
umask
growth_factor
chunk_size
num_threads
stat_key_prefix
detail_enabled
reqs_per_event
cas_enabled
binding_protocol
auth_enabled_sasl
item_size_max

その他コマンド

incr/decrコマンド

値をインクリメント/デクリメントする

実行書式


incr [noreply]\r\n

key キー値
value 加算/減算する値
noreply オプションパラメータ。サーバーが応答を返さない

実行例


incr hoge2 10


deleteコマンド

キーのデータを削除

実行書式


delete [

key 削除データのキー
time 指定時間まで(unix time)addやreplaceコマンドを成功させない(setコマンドは成功する)
noreply オプションパラメータ。サーバーが応答を返さない


delete hoge

flush_allコマンド

すべてのデータを削除

versionコマンド

バージョン表示

quitコマンド

接続を切断