memcached命令解析
-
- 标准协议
- No Reply
- 存储命令
- set命令
- add命令
- replace命令
- append命令
- prepend命令
- cas命令
- 读取命令
- get命令
- gets命令
- 删除命令
- incr/decr命令
- 查看memcached使用状态
- stats命令
- stats items命令
- stats slabs命令
- stats sizes命令
- flush_all命令
- 标准协议
memcached 命令
memcached 所有的标准协议包含在对item 执行命令过程中，一个item 包含：
· 一个key
· 一个32 位的标志值
· 以秒为单位的失效时间
· 一个64 为的CAS 值，这个是唯一的
· 数据
CAS 是可选的，可以使用“
-C
” 禁止CAS 。
大多数ascii 命令允许“noreply” 。建议大家在ascii 协议下别用“noreply” ，因为那样不会报请求错误。“noreply” 的目的是在执行交互命令（如：set 、add ）后，避免等待返回的包。
二进制协议将“noreply” 定义为声明。如果你的客户端支持或者使用二进制协议，那么你将会用到它。
首先客户端向服务器按照如下格式发送命令行:
<command name> <key> <flags> <exptime> <bytes>\r\n
a) <command name> 可以是"set", "add", "replace" 。
"set" 表示按照相应的<key> 存储该数据。
"add" 表示按照相应的<key> 添加该数据, 但是如果该<key> 已经存在则会操作失败。
"replace" 表示按照相应的<key> 替换数据, 但是如果该<key> 不存在则操作失败
b) <key> 客户端需要保存数据的key 。
c) <flags> 是一个16 位的无符号的整数( 以十进制的方式表示) 。该标志将和需要存储的数据一起存储, 并在客户端get 数据时返回。客户可以将此标志用做特殊用途，此标志对服务器来说是不透明的。
d) <exptime> 过期的时间。如果该数值为0 表示存储的数据永远不过时( 但是, 该数据有可能被其他项所替换掉。因为服务器采用了LRU( 最近最久没有使用) 的算法替换) 。如果非0(unix 时间或者距离此时的秒数), 当过期后, 服务器可以保证用户得不到该数据( 以服务器时间为标准) 。
e) <bytes> 需要存储的字节数( 不包含最后的"\r\n"), 当用户希望存储空数据时,<bytes> 可以为0
f) 最后客户端需要加上"\r\n" 作为" 命令头" 的结束标志。
<data block>\r\n
紧接着" 命令头" 结束之后就要发送数据块( 即希望存储的数据内容), 最后加上"\r\n" 作为此次通讯的结束。
reply
当以上数据发送结束之后, 服务器将返回一个应答。可能有如下的情况:
a) "STORED\r\n"
表示存储成功
b) "NOT_STORED\r\n"
表示存储失败, 但是该失败不是由于错误。通常这是由于"add" 或者"replace" 命令本身的要求所引起的, 或者该项在删除队列之中( 见delete 命令) 。
set 是保存数据命令。会覆盖已存在的数据，而新数据将在LRU 顶端
只有在该数据不存在时才保存该数据。如果是新加入的item ，那么将其直接放在LRU 顶端；如果item 已经存在导致add 失败，那么将这个item 从LRU 链表上摘下再放到LRU 顶端。
替换已经存在的数据。 这个操作几乎用不到。
紧接着已经存在的item 增加item 。这个操作不允许增加原来的item 限制，对管理链表很有用。
与append 命令类似，这个命令是在已存在的数据前加入新数据。
检查并存储(
Check And Set) 或者比较并更新(Compare And Swap) 。如果从上次读取到现在没有更新，那么存入数据，处理更新竞争很有用。
获取数据的格式:
get <key>*\r\n
a) <key>* 表示一个或者多个key( 以空格分开)
b) "\r\n" 命令头的结束
reply
服务器端将返回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 命令行中但是没有返回相应的数据，这意味着服务器中不存在这些项，这些项过时了，或者被删除了。
读取命令， 更具一个或多个key 查找数据，并返回所找到的数据。
使用CAS 的get 命令，返回的item 带有一个CAS 标识符 ( 一个唯一的64 位数) 。使用cas 命令返回数据。如果得到的item 的cas 值被更改了，这个数据将不会被保存。
如果存在，将item 从cache 中删除，
delete 命令格式:
delete <key> <time>\r\n
a) <key> 需要被删除数据的key
b) <time> 客户端希望服务器将该数据删除的时间(unix 时间或者从现在开始的秒数)
c) "\r\n" 命令头的结束
reply
a) "DELETED\r\n" 删除成功
b) "NOT_FOUND\r\n" 需要删除的key 不存在
incr/decr
Increment and Decrement. 如果item 是以64 为整型存储的，那么可以使用incr 和decr 命令修改那个数。
如果数据不存在，那么将返回失败。
命令格式:
incr <key> <value>\r\n
or
decr <key> <value>\r\n
a) <key> 数据项的key
b) <value> 用户希望增加/ 减少的数据的数值. 该数值是一个32 位十进制的无符号整形变量。
c) "\r\n" 命令行结束标志
reply
a) "NOT_FOUND\r\n" 没有找到需要操作的项。
b) "<value>\r\n" <value> 数据项有效期的最新剩余时间。
注意:
a) 如果一个数据项的有效期被设置为0, 这时使用decr 命令是无法减少数据。
b) 如果要执行 incr key -1 的操作不会有什么问题, 结果和你希望的一样。但是, 执行decr -1 时的结果一定会让你觉得很意外, 因为它的结果无论key 的数据是什么结果的都是0. 原因是: 在这两个命令的执行过程中都是吧-1 当做一个无符号的整形处理的。
c) 执行decr 命令时数据的长度不会随之而减小, 而是在返回数据的后面填补空格。但是执行incr 命令越界后会自动的增加数据的位数。
通过这些命令可以查看memcached 服务器的使用状态。
查看memcached 状态的基本命令，通过这个命令可以看到如下信息：
| STAT pid 22459 进程ID |
输出各个slab 中的item 信息。s
输出slab 中更详细的item 信息
输出所有item 的大小和个数
stats cachedump <slab_id> <limit_num>
根据<slab_id> 输出相同的<slab_id> 中的item 信息。<limit_num> 是输出的个数，当<limit_num> 为0 是输出所有的item 。
使在内存中所有的item 失效。加入参数则表示在N 秒后失效所有item 。这项操作会立即返回，不会暂停服务器。这个操作并不会真的释放内存空间，而是标志所有的item 为失效