Memcached 入门学习二（命令操作）

Memcached 基本操作

1、set 操作
Memcached set 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果set的key已经存在，该命令可以更新该key所对应的原来的数据，也就是实现更新的作用。
set 命令的基本语法格式如下：

set key flags exptime bytes [noreply] value 

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
• exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
• bytes：在缓存中存储的字节数
• noreply（可选）： 该参数告知服务器不需要返回数据
• value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
注：字节数必须与bytes 设置的字节数相等。
如下所示：

Set  java_test  32  900 4Test输出：Stored

注意：针对于第二个参数：flags , JAVA客户端flags字段填写的都是32，不是32的是无法通过java客户端get出来的
输出信息说明：
• STORED：保存成功后输出。
• ERROR：在保持失败后输出。

2、add 操作
Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果 add 的 key 已经存在，则不会更新数据(过期的 key 会更新)，之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。
add 命令的基本语法格式如下：

add key flags exptime bytes [noreply]value

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
• exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
• bytes：在缓存中存储的字节数
• noreply（可选）： 该参数告知服务器不需要返回数据
• value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）

add  new_test  32  900  4test输出：stored

输出信息说明：
• STORED：保存成功后输出。
• NOT_STORED ：在保持失败后输出。

3、replace 命令
Memcached replace 命令用于替换已存在的 key(键) 的 value(数据值)。
如果 key 不存在，则替换失败，并且您将获得响应 NOT_STORED。

replace 命令的基本语法格式如下：

replace key flags exptime bytes [noreply]value

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
• exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
• bytes：在缓存中存储的字节数
• noreply（可选）： 该参数告知服务器不需要返回数据
• value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）

replace new_test 32  900 7replacestored

输出信息说明：
• STORED：保存成功后输出。
• NOT_STORED：执行替换失败后输出。

4、append 命令
Memcached append 命令用于向已存在 key(键) 的 value(数据值) 后面追加数据。
append 命令的基本语法格式如下：

append key flags exptime bytes [noreply]value

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
• exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
• bytes：在缓存中存储的字节数
• noreply（可选）： 该参数告知服务器不需要返回数据
• value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
操作命令：

append new_test 32 900 5new s输出：stored

输出信息说明：
• STORED：保存成功后输出。
• NOT_STORED：该键在 Memcached 上不存在。
• CLIENT_ERROR：执行错误。

5、prepend 命令
Memcached prepend 命令用于向已存在 key(键) 的 value(数据值) 前面追加数据 。
prepend 命令的基本语法格式如下：

prepend key flags exptime bytes [noreply]value

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
• exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
• bytes：在缓存中存储的字节数
• noreply（可选）： 该参数告知服务器不需要返回数据
• value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）

输出信息说明：
• STORED：保存成功后输出。
• NOT_STORED：该键在 Memcached 上不存在。
• CLIENT_ERROR：执行错误。

6、cas 命令

Memcached CAS（Check-And-Set 或 Compare-And-Swap） 命令用于执行一个”检查并设置”的操作它仅在当前客户端最后一次取值后，该key 对应的值没有被其他客户端修改的情况下， 才能够将值写入。
Memcached提供了cas命令，可以保证多个并发访问操作同一份数据的一致性问题。
CAS 命令的基本语法格式如下：

cas key flags exptime bytes unique_cas_token [noreply]value

• key：键值 key-value 结构中的 key，用于查找缓存值。
• flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
• exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
• bytes：在缓存中存储的字节数
• unique_cas_token通过 gets 命令获取的一个唯一的64位值。
• noreply（可选）： 该参数告知服务器不需要返回数据
• value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
要在 Memcached 上使用 CAS 命令，你需要从 Memcached 服务商通过 gets 命令获取令牌（token）。gets 命令的功能类似于基本的 get 命令。两个命令之间的差异在于，gets 返回的信息稍微多一些：64 位的整型值非常像名称/值对的 “版本” 标识符。
如果没有设置唯一令牌，则 CAS 命令执行错误。如果键 key 不存在，执行失败。

输出信息说明：
• STORED：保存成功后输出。
• ERROR：保存出错或语法错误。
• EXISTS：在最后一次取值后另外一个用户也在更新该数据。
• NOT_FOUND：Memcached 服务上不存在该键值。

7、get命令
Memcached get 命令获取存储在 key(键) 中的 value(数据值) ，如果 key 不存在，则返回空。
get 命令的基本语法格式如下：

get key

多个 key 使用空格隔开，如下:

get key1 key2 key3

8、gets 命令
Memcached gets 命令获取带有 CAS 令牌 的 value(数据值) ，如果 key 不存在，则返回空。
gets 命令的基本语法格式如下：

gets key

多个 key 使用空格隔开，如下:

gets key1 key2 key3

9、delete 命令

Memcached delete 命令用于删除已存在的 key(键)。
delete 命令的基本语法格式如下：

delete key [noreply]

参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
noreply（可选）： 该参数告知服务器不需要返回数据

10、incr 与 decr 命令
Memcached incr 与 decr 命令用于对已存在的 key(键) 的数字值进行自增或自减操作。
incr 与 decr 命令操作的数据必须是十进制的32位无符号整数。
如果 key 不存在返回 NOT_FOUND，如果键的值不为数字，则返回 CLIENT_ERROR，其他错误返回 ERROR。
incr 命令的基本语法格式如下：

incr key increment_value

decr 命令的基本语法格式如下：

decr key decrement_value

参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
increment_value： 增加的数值。