Memcached各个存储命令的语法格式都类似,且有相同的参数和参数含义,先将可能出现的各个参数的意义说明如下:
key: 键值 key-value 结构中的 key,用于查找缓存值。
flags: 可以包括键值对的整型参数,客户机使用它存储关于键值对的额外信息 。
exptime:在缓存中保存键值对的时间长度(以秒为单位,0 表示永远)
bytes: 在缓存中存储的字节数
noreply(可选): 该参数告知服务器不需要返回数据
value: 存储的值(始终位于第二行)(可直接理解为key-value结构中的value)
unique_cas_token:通过 gets 命令获取的一个唯一的64位值。
1. Memcached set命令:
Memcached set 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果set的key已经存在,该命令可以更新该key所对应的原来的数据,也就是实现更新的作用。
语法:
set key flags exptime bytes [noreply]
value
输出信息说明(若设置了noreply参数则没有输出):
STORED: 保存成功后输出。
ERROR: 在保持失败后输出。
2. Memcached add命令:
Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果 add 的 key 已经存在,则不会更新数据,之前的值将仍然保持相同,并且您将获得响应 NOT_STORED。
语法:
add key flags exptime bytes [noreply]
value
输出信息说明(若设置了noreply参数则没有输出):
STORED: 保存成功后输出。
NOT_STORED:在保存失败后输出。
注:add命令和set命令的区别在于,当键名已存在时,set会更新键名对应的数据,而add则不会跟新数据。
3. Memcached replace命令:
Memcached replace 命令用于替换已存在的 key(键) 的 value(数据值)。
如果 key 不存在,则替换失败,并且您将获得响应 NOT_STORED。
语法:
replace key flags exptime bytes [noreply]
value
输出信息说明:
STORED:保存成功后输出。
NOT_STORED:执行替换失败后输出。
注:replace命令和set的更新功能一样。
4. Memcached append命令:
Memcached append 命令用于向已存在 key(键) 的 value(数据值) 后面追加数据。
语法:
append key flags exptime bytes [noreply]
value
输出信息说明:
STORED:保存成功后输出。
NOT_STORED:该键在 Memcached 上不存在。
CLIENT_ERROR:执行错误。
5. Memcached prepend命令:
Memcached prepend 命令用于向已存在 key(键) 的 value(数据值) 前面追加数据。
语法:
prepend key flags exptime bytes [noreply]
value
输出信息说明:
STORED:保存成功后输出。
NOT_STORED:该键在 Memcached 上不存在。
CLIENT_ERROR:执行错误。
6. Memcached CAS命令:
Memcached CAS(Check-And-Set 或 Compare-And-Swap) 命令用于执行一个"检查并设置"的操作。它仅在当前客户端最后一次取值后,该key 对应的值没有被其他客户端修改的情况下, 才能够将值写入。检查是通过cas_token参数进行的, 这个参数是Memcach指定给已经存在的元素的一个唯一的64位值。
语法:
cas key flags exptime bytes unique_cas_token [noreply]
value
输出信息说明:
STORED:保存成功后输出。
ERROR:保存出错或语法错误。
EXISTS:在最后一次取值后另外一个用户也在更新该数据。
NOT_FOUND:Memcached 服务上不存在该键值。
注:要在 Memcached 上使用 CAS 命令,你需要从 Memcached 服务商通过 gets 命令获取令牌(token)。
使用示例: