Memcache及telnent命令具体解释

1、启动Memcache 经常使用參数
memcached 1.4.3
-p <num>      设置port号(默认不设置为: 11211)
-U <num>      UDP监听port (默认: 11211, 0 时关闭)  
-l <ip_addr>  绑定地址 (默认:全部都同意,不管内外网或者本机更换IP，有安全隐患，若设置为127.0.0.1就仅仅能本机訪问)
-d            duli进程执行
-u <username> 绑定使用指定用于执行进程 <username>
-m <num>      同意最大内存用量，单位M (默认: 64 MB)
-P <file>     将PID写入文件<file>，这样能够使得后边进行高速进程终止, 须要与 -d 一起使用
如：
在linux下：./usr/local/bin/memcached -d -u jb-mc -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 jb-Memcached binpath= “d:\App_Serv\memcached\memcached.exe -d RunService -p 11211 -m 500″ start= auto
net start jb-Memcached

2、telnet连接

telnet 127.0.0.1 11211

3、写入memcache

3.1 memcached Telnet Interface

Command	Description	Example
get	Reads a value	get mykey
set	Set a key unconditionally	set mykey 0 60 5
add	Add a new key	add newkey 0 60 5
replace	Overwrite existing key	replace key 0 60 5
append	Append data to existing key	append key 0 60 15
prepend	Prepend data to existing key	prepend key 0 60 15
incr	Increments numerical key value by given number	incr mykey 2
decr	Decrements numerical key value by given number	decr mykey 5
delete	Deletes an existing key	delete mykey
flush_all	Invalidate specific items immediately	flush_all
	Invalidate all items in n seconds	flush_all 900
stats	Prints general statistics	stats
	Prints memory statistics	stats slabs
	Prints memory statistics	stats malloc
	Print higher level allocation statistics	stats items
		stats detail
		stats sizes
	Resets statistics	stats reset
version	Prints server version.	version
verbosity	Increases log level	verbosity
quit	Terminate telnet session	quit

3.2 telnet请求命令格式

<command name> <key> <flags> <exptime> <bytes>\r\n <data block>\r\n
a) <command name> 能够是”set”, “add”, “replace”。
“set”表示依照对应的<key>存储该数据。没有的时候添加，有的覆盖。
“add”表示依照对应的<key>加入该数据,可是假设该<key>已经存在则会操作失败。
“replace”表示依照对应的<key>替换数据,可是假设该<key>不存在则操作失败

b) <key> client须要保存数据的key。

c) <flags> 是一个16位的无符号的整数(以十进制的方式表示)。
该标志将和须要存储的数据一起存储,并在clientget数据时返回。

客户能够将此标志用做特殊用途，此标志对server来说是不透明的。

d) <exptime> 过期的时间。
若为0表示存储的数据永远只是时(但可被server算法：LRU 等替换)。

假设非0(unix时间或者距离此时的秒数),当过期后,server能够保证用户得不到该数据(以server时间为标准)。

e) <bytes> 须要存储的字节数(不包括最后的”\r\n”),当用户希望存储空数据时,<bytes>能够为0

f) 最后client须要加上”\r\n”作为”命令头”的结束标志。
<data block>\r\n

紧接着”命令头”结束之后就要发送数据块(即希望存储的数据内容),最后加上”\r\n”作为此次通讯的结束。

3.3 telnet响应命令

结果响应：reply
当以上数据发送结束之后,server将返回一个应答。可能有例如以下的情况:

a) “STORED\r\n”：表示存储成功
b) “NOT_STORED\r\n” ： 表示存储失败,可是该失败不是因为错误。

通常这是因为”add”或者”replace”命令本身的要求所引起的,或者该项在删除队列之中。

如： set key 33 0 4\r\n
ffff\r\n

4、获取/检查KeyValue
get <key>*\r\n
a) <key>* 表示一个或者多个key(以空格分开)
b) “\r\n” 命令头的结束

结果响应：reply
server端将返回0个或者多个的数据项。每个数据项都是由一个文本行和一个数据块组成。当全部的数据项都接收完成将收到”END\r\n”
每一项的数据结构：
VALUE <key> <flags> <bytes>\r\n
<data block>\r\n

a) <key> 希望得到存储数据的key
b) <falg> 发送set命令时设置的标志项
c) <bytes> 发送数据块的长度(不包括”\r\n”)
d) “\r\n” 文本行的结束标志
e) <data block> 希望接收的数据项。

f) “\r\n” 接收一个数据项的结束标志。

假设有些key出如今get命令行中可是没有返回对应的数据，这意味着server中不存在这些项，这些项过时了，或者被删除了
如：get aa
VALUE aa 33 4
ffff
END

5、删除KeyValue：
delete <key> <time>\r\n

a) <key> 须要被删除数据的key
b) <time> client希望server将该数据删除的时间(unix时间或者从如今開始的秒数)
c) “\r\n” 命令头的结束

6、检查Memcacheserver状态：
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 ： 最大同意使用的内存量，字节

7、高级缓存细节查看方法：
stats reset
清空统计数据

stats malloc
显示内存分配数据

stats cachedump slab_id limit_num
显示某个slab中的前limit_num个key列表，显示格式例如以下
ITEM key_name [ value_length b; expire_time|access_time s]
当中，memcached 1.2.2及以前版本号显示的是  訪问时间(timestamp)
1.2.4以上版本号，包括1.2.4显示 过期时间(timestamp)
假设是永只是期的key，expire_time会显示为server启动的时间

stats cachedump 7 2
ITEM copy_test1 [250 b; 1207795754 s]
ITEM copy_test [248 b; 1207793649 s]

stats slabs
显示各个slab的信息。包括chunk的大小、数目、使用情况等

stats items
显示各个slab中item的数目和最老item的年龄(最后一次訪问距离如今的秒数)

stats detail [on|off|dump]
设置或者显示具体操作记录

參数为on，打开具体操作记录
參数为off，关闭具体操作记录
參数为dump，显示具体操作记录(每个键值get、set、hit、del的次数)

8、清空全部键值
flush_all
注：flush并不会将items删除，仅仅是将全部的items标记为expired。因此这时memcache依然占用全部内存。

9、退出
quit\r\n