memcached命令
comments 类型
1. storage commands: set add replace
2. retrieval commands: get
3. other commands: incr delete
error strings
1. "ERROR\r\n"
客户端发送了一个不存在的command
2. "CLIENT_ERROR <error>\r\n"
客户端的错误:客户端发送的数据或者格式方面有问题。 <error>表示具体错误的原因。
3. "SERVER_ERROR <error>\r\n"
服务器端的错误:服务器一系列的错误阻止了命令的执行。<error>表示具体错误的原因。当发生此错误时。服务器发送完了"SERVER_ERROR <error>\r\n"之后将会关闭connection。(这是唯一的关闭connection的情况)
descriptions of individual commands
1. storage commands
首先客户端向服务器按照如下格式发送命令行:
<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命令)。
2 retrieval command
获取数据的格式:
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命令行中但是没有返回相应的数据,这意味着服务器中不存在这些项,这些项过时了,或者被删除了。
3. delete
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不存在
ps:"flush_all" command 可以所有项都无效。
4. increment/decrement
command "incr" "decr" 是用来改变数据项数值的命令。设置数据项的数据被认为是一个10进制的无符号的整数。如果当前设置的值不能够被转换则认为是0.如果该数据项的key不存在,则执行命令失败!
命令格式:
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命令越界后会自动的增加数据的位数。
5. 其他命令
"stats": 用来查询服务器提供的内部数据。
stats <args>\r\n
查询特定的数据
reply
STAT <name> <value>\r\n
...
END\r\n
"quit"
"quit\r\n": 退出程序
分享到:
相关推荐
memcached 命令汇总,stats 系列命令因为返回的字段、数值比较多,比较复杂,而且都有他们自己的意思,所以特地抽出来。
本文实例讲述了PHP 扩展Memcached命令用法。分享给大家供大家参考,具体如下: 传送门:http://www.php.net/manual/zh/book.memcached.php windows 下没有memcached的扩展,只有memcache的扩展。亲测,两者之间还是...
它使用一个名为transport-memcached的插件提供Memcached命令映射到REST接口的功能,使得Memcached命令可以被同样的REST层处理。 Memcached支持的命令包括get、set、delete和quit等。其中,get命令用于获取存储在...
Memcached 学习Memcached 运行Memcached命令的运行:/usr/local/memcached/bin/memcached -d -m 64M -u root -l 127.0.0.1 -p 11211 -c 256 -P /tmp/memcached.pid注意:如果使用自动安装 memcached 命令位于 /usr/...
memcached-win64安装包 内含详细安装命令说明文件:说明.txt windows上保证安装成功。
计算机后端-PHP视频教程. Memcached04 memcached基本命令.wmv
在终端(也即cmd命令界面)下输入 ‘c:\memcached\memcached.exe -d install’ 安装 3. 再输入: ‘c:\memcached\memcached.exe -d start’ 启动。NOTE: 以后memcached将作为windows的一个服务每次开机时自动启动...
Memcached get 命令 Memcached get 命令获取存储在 key(键) 中的 value(数据值) ,如果 key 不存在,则返回空。 语法: get 命令的基本语法格式如下: get key 多个 key 使用空格隔开,如下: get key1 key2 key3...
Memcached delete 命令 Memcached delete 命令用于删除已存在的 key(键)。 语法: delete 命令的基本语法格式如下: delete key [noreply] 参数说明如下: key:键值 key-value 结构中的 key,用于查找缓存值。 no...
Memcached参考手册,内容有memecache的基本教程:安装、连接环境设置等; memcached命令:查找命令(get、gets、delete等)存储命令(set、add、replace、append等),以及源码使用样例
Memcached 是一个高性能的分布式内存对象缓存系统,用于动态Web应用以减轻数据库负载。它通过在内存中缓存数据和对象来减少读取数据库的次数,从而提高动态、数据库驱动网站的速度。... 运行命令: memcached.exe -vv
memcached几个常见的命令,比较有用。大型网站设计都需要这个技术,希望PHP程序员好好看看这个文档。
Memcached 是一个高性能的分布式内存对象缓存系统,用于动态Web应用以减轻数据库负载。它通过在内存中缓存数据和对象来减少读取数据库的次数,从而提高动态、数据库驱动网站的速度。... 运行命令: memcached.exe -vv
一、存储命令 存储命令的格式: <command> <key> <flags> <exptime> <bytes> 参数说明如下: set/add/replace 查找关键字 客户机使用它存储关于键值对的额外信息 ...这个set的命令在memcached中的使用
Memcached CAS 命令 Memcached CAS(Check-And-Set 或 Compare-And-Swap) 命令用于执行一个”检查并设置”的操作 它仅在当前客户端最后一次取值后,该key 对应的值没有被其他客户端修改的情况下, 才能够将值写入。...
在终端(也即cmd命令界面)下输入 ‘c:\memcached\memcached.exe -d install’ 安装 3. 再输入: ‘c:\memcached\memcached.exe -d start’ 启动。NOTE: 以后memcached将作为windows的一个服务每次开机时自动启动。...
命令提示符下运行 安装: memcached -d install memcached -d start net start "Memcached Server" 卸载: memcached -d stop memcached -d remove sc delete "Memcached Server" memcached的基本设置: -...
memcached安装包,附安装包libevent,memcached,安装命令指导文档