---

Memcached add 命令文档

简介

Memcached 是一款基于内存的键值存储系统，它的设计目标是通过减少数据库负载来提高数据检索效率。add 命令是 Memcached 的一个常用命令，用于向缓存中添加一个新的键值对。

语法

add key flags exptime bytes [noreply]\r\n
value\r\n

参数说明

• key：要添加的键名。
• flags：一个整数值，用于标记值的属性。可以用于指定数据的压缩算法、序列化格式等。
• exptime：过期时间，以整数值表示。在此时间之后，该数据会被自动删除。
• bytes：要保存的数据长度（以字节为单位）。
• noreply（可选）：表示不需要返回结果，如果指定，Memcached 将忽略响应，直接返回客户端。

返回值

如果该键已经存在，则 add 命令会返回 NOT_STORED。如果添加成功，则返回 STORED。

add 命令也可能返回其他的错误消息，例如：

• CLIENT_ERROR：参数错误，比如字节的数量不正确或 key 的长度超出了限制。
• SERVER_ERROR：服务器出现了内部错误。

示例

add mykey 0 300 10\r\nhello world\r\n

上述命令尝试向缓存中添加一个名为 “mykey” 的键值对，这个值的属性为 0，过期时间为 300 秒，长度为 10 字节。如果添加成功，该命令会返回 STORED。如果该键已经存在，则返回 NOT_STORED。

注意事项

• add 命令只是在键不存在的情况下才添加，如果键已经存在，则该操作不会有任何效果。
• 在内存空间有限的情况下，使用 add 命令可能会导致缓存空间不足，建议使用 replace 命令，以防数据被覆盖。
• 因为 add 命令不支持更新一个已经存在的键值对，所以一些客户端程序可能会使用 Cas 命令来实现类似 add 命令的功能。

结论

add 命令是 Memcached 的一个常用命令，用于向缓存中添加一个新的键值对。在使用 add 命令时，需要注意键是否已经存在以及内存空间的限制。同时，如果需要更新已经存在的键值对，应该使用 replace 或 Cas 命令。