Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果 add 的 key 已经存在,则不会更新数据,之前的值将仍然保持相同,并且您将获得响应 NOT_STORED。
语法:
add 命令的基本语法格式如下:
add key flags exptime bytes [noreply]
value
参数说明如下:
-
key:键值 key-value 结构中的 key,用于查找缓存值。
-
flags:可以包括键值对的整型参数,客户机使用它存储关于键值对的额外信息 。
-
exptime:在缓存中保存键值对的时间长度(以秒为单位,0 表示永远)
-
bytes:在缓存中存储的字节数
-
noreply(可选): 该参数告知服务器不需要返回数据
-
value:存储的值(始终位于第二行)(可直接理解为key-value结构中的value)
实例
以下实例中我们设置:
- key → new_key
- flag → 0
- exptime → 900 (以秒为单位)
- bytes → 10 (数据存储的字节数)
- value → data_value
add new_key 0 900 10
data_value
STORED
get new_key
VALUE new_key 0 10
data_value
END
输出
如果数据添加成功,则输出:
STORED
输出信息说明:
-
STORED:保存成功后输出。
-
NOT_STORED :在保持失败后输出。