Memcached存储命令

时间:2022-02-26 15:07:14

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)。

使用示例:

Memcached存储命令