Memcached 常用指令

一、常用的存储数据的三个指令

主要的三个存储数据的指令分别是：set、add、replace。

• set指令：是直接保存到一个叫做key的数据到服务器上（不管这个数据是否存在）；
• add指令：是添加一个数据到memcached，如果这个key已存在，则不进行添加，若不存在，则执行添加；
• replace指令：也是添加一个数据到memcached，但其与add指令相反，如果这个key存在，那么就修改其key值，如果不存在，则返回错误，不进行任何操作；

上述三个指令的语法格式都是一样的，只是指令不一样而已，其指令的语法格式如下：

<命令> <键> <标记> <有效期> <数据长度>

在上述的语法格式中，解释如下：

• <命令>：就是add、set、replace等指令；
• <键> – key：就是保存在服务器上唯一的一个标识符，不可以与其他的key冲突，否则会覆盖掉原来的数据（使用set命令的话），这个key是为了能够准确的存取一个数据项目；
• <标记> – flag：标记的是一个16位的无符号整型数据，用来设置服务器跟客户端一些交互的操作；
• <有效期> -expiration time：是数据在服务器上的有效期限，如果是0，则数据永远有效，单位是秒，Memcached服务端会把一个数据的有效期设置为当前Unix时间+设置的有效时间；
• <数据长度> – bytes：数据的长度，block data数据块的长度，一般这这个长度结束后下一行跟着block data数据内容，发送完数据以后，客户端一般等待服务器端的返回；

1、set指令使用示例

[root@memcache1 ~]# telnet 192.168.171.132 11211   #连接到memcached数据库
set lisi 0 0  3    3       #插入一个数据
aaa              #插入的数据为aaa
STORED             #返回“STORED”则表示插入成功
get lisi                  #查询插入的数据
VALUE lisi 0 3          
aaa
END
set lisi 0 0 4          #修改“lisi”这个key的值为bbbb
bbbb
STORED
get lisi          #再次查看，确定更改成功
VALUE lisi 0 4
bbbb

2、add指令使用示例

以下实例中我们设置：
• 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 ：在保持失败后输出。

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）

使用实例

以下实例中将设置：
• key → mykey
• flag → 0
• exptime → 900 (以秒为单位)
• bytes → 10 (数据存储的字节数)
• value → data_value

以下实例中我们使用的键位 ‘mykey’ 并存储对应的值 data_value。执行后我们替换相同的 key 的值为’some_other_value’。

add mykey 0 900 10
data_value
STORED
get mykey
VALUE mykey 0 10
data_value
END
replace mykey 0 900 16
some_other_value
get mykey
VALUE mykey 0 16
some_other_value
END

如果数据添加成功，则输出：
STORED
输出信息说明：
• STORED：保存成功后输出。
• NOT_STORED：执行替换失败后输出。~~~~

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

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
• exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
• bytes：在缓存中存储的字节数
• noreply（可选）： 该参数告知服务器不需要返回数据
• value：存储的值（始终位于第二行）（可直接理解为 key-value 结构中的 value）
.
实例如下：
• 首先我们在 Memcached 中存储一个键 runoob，其值为 memcached。
• 然后，我们使用 get 命令检索该值。
• 然后，我们使用 append 命令在键为 runoob 的值后面追加 "redis"。
• 最后，我们再使用 get 命令检索该值。

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END
append runoob 0 900 5
redis
STORED
get runoob
VALUE runoob 0 14
memcachedredis
END

输出
如果数据添加成功，则输出：
STORED

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

5、prepend 命令
prepend 命令用于向已存在 key( 键) ) 的 value( 数据值) ) 前面追加数据 ，与append正好相反。
语法：
prepend 命令的基本语法格式如下：
prepend key flags exptime bytes [noreply] value

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

实例如下：
• 首先我们在 Memcached 中存储一个键 runoob，其值为 memcached。
• 然后，我们使用 get 命令检索该值。
• 然后，我们使用 prepend 命令在键为 runoob 的值后面追加 "redis"。
• 最后，我们再使用 get 命令检索该值。

set runoob 0 900 9

> memcached
> STORED
> get runoob
> VALUE runoob 0 14
> memcached
> END
> prepend runoob 0 900 5
> redis
> STORED
> get runoob
> VALUE runoob 0 14
> redismemcached
END 

如果数据添加成功，则输出：
STORED
输出信息说明：
• STORED：保存成功后输出。
• NOT_STORED：该键在 Memcached 上不存在。
• CLIENT_ERROR：执行错误。
6、cas命令
CAS（Check-And-Set 或 Compare-And-Swap） 命令用于执行一个"检查并设置"的操作它仅在当前客户端最后一次取值后，该 key 对应的值没有被其他客户端修改的情况下， 才能够将值写入。检查是通过 cas_token 参数进行的， 这个参数是 Memcach 指定给已经存在的元素的一个唯一的 64 位值。

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 不存在，执行失败。
• 添加键值对。
• 通过 gets 命令获取唯一令牌。
• 使用 cas 命令更新数据
• 使用 get 命令查看数据是否更新

cas tp 0 900 9
ERROR <− 缺少 token
cas tp 0 900 9 2
memcached
NOT_FOUND <− 键 tp 不存在
set tp 0 900 9
memcached
STORED
gets tp
VALUE tp 0 9 1
memcached
END
cas tp 0 900 5 1
redis
STORED
get tp
VALUE tp 0 5
redis
END
输出
如果数据添加成功，则输出：
STORED
输出信息说明：
• STORED：保存成功后输出。
• ERROR：保存出错或语法错误。
• EXISTS：在最后一次取值后另外一个用户也在更新该数据。
• NOT_FOUND：Memcached 服务上不存在该键值。

.
二、常用的查找命令
1、 get命令
get 命令获取存储在 key( 键) ) 中的 value( 数据值) ) ，如果 key 不存在，则返回空。

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

多个 key 使用空格隔开，如下:
get key1 key2 key3
参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
实例
在以下实例中，我们使用 runoob 作为 key，过期时间设置为 900 秒。

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END

2、 gets 命令
gets 命令获取带有 CAS 令牌存 的 value( 数据值) ) ，如果 key 不存在，则返回空。

gets 命令的基本语法格式如下：
gets key
多个 key 使用空格隔开，如下:
gets key1 key2 key3
参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
实例
在以下实例中，我们使用 runoob 作为 key，过期时间设置为 900 秒。

set runoob 0 900 9
memcached
STORED
gets runoob
VALUE runoob 0 9 1
memcached
END 

在 使用 gets 命令的输出结果中，在最后一列的数字 1 代表了 key 为 runoob 的 CAS 令牌。

3、delete 命令
delete 命令用于删除已存在的 key(键)。

delete 命令的基本语法格式如下：
delete key [noreply]

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

实例
在以下实例中，我们使用 runoob 作为 key，过期时间设置为 900 秒。之后我们使用 delete 命令删除该 key。

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END
delete runoob
DELETED
get runoob
END
delete runoob
NOT_FOUND 

输出信息说明：
• DELETED：删除成功。
• ERROR：语法错误或删除失败。
• NOT_FOUND：key 不存在。

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

incr 命令的基本语法格式如下：
incr key increment_value

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• increment_value： 增加的数值。
实例
在以下实例中，我们使用 visitors 作为 key，初始值为 10，之后进行加 5 操作。

set visitors 0 900 2
10
STORED
get visitors
VALUE visitors 0 2
10
END
incr visitors 5
15
get visitors
VALUE visitors 0 2
15
END
输出信息说明：
• NOT_FOUND：key 不存在。
• CLIENT_ERROR：自增值不是对象。
• ERROR 其他错误，如语法错误等。

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

参数说明如下：
• key：键值 key-value 结构中的 key，用于查找缓存值。
• decrement_value： 减少的数值。
实例

set visitors 0 900 2
10
STORED
get visitors
VALUE visitors 0 2
10
END
decr visitors 5
5
get visitors
VALUE
visitors 0 1
5
END
输出信息说明：
• NOT_FOUND：key 不存在。
• CLIENT_ERROR：自增值不是对象。
• ERROR 其他错误，如语法错误等。

5、 stats 命令
stats 命令用于返回统计信息例如 PID(进程号)、版本号、连接数等。

stats 命令的基本语法格式如下：
stats
实例
在以下实例中，我们使用了 stats 命令来输出 Memcached 服务信息。
stats

这里显示了很多状态信息，下边详细解释每个状态项：
• pid： memcache 服务器进程 ID
• uptime：服务器已运行秒数
• time：服务器当前 Unix 时间戳
• version：memcache 版本
• pointer_size：操作系统指针大小
• rusage_user：进程累计用户时间
• rusage_system：进程累计系统时间
• curr_connections：当前连接数量
• total_connections：Memcached 运行以来连接总数
• connection_structures：Memcached 分配的连接结构数量
• cmd_get：get 命令请求次数
• cmd_set：set 命令请求次数
• cmd_flush：flush 命令请求次数
• get_hits：get 命令命中次数
• get_misses：get 命令未命中次数
• delete_misses：delete 命令未命中次数
• delete_hits：delete 命令命中次数
• incr_misses：incr 命令未命中次数
• incr_hits：incr 命令命中次数
• decr_misses：decr 命令未命中次数
• decr_hits：decr 命令命中次数
• cas_misses：cas 命令未命中次数
• cas_hits：cas 命令命中次数
• cas_badval：使用擦拭次数
• auth_cmds：认证命令处理的次数
• auth_errors：认证失败数目
• bytes_read：读取总字节数
• bytes_written：发送总字节数
• limit_maxbytes：分配的内存总大小（字节）
• accepting_conns：服务器是否达到过最大连接（0/1）
• listen_disabled_num：失效的监听数
• threads：当前线程数
• conn_yields：连接操作主动放弃数目
• bytes：当前存储占用的字节数
• curr_items：当前存储的数据总数
• total_items：启动以来存储的数据总数
• evictions：LRU 释放的对象数目
• reclaimed：已过期的数据条目来存储新数据的数目

6、stats items 命令
stats items 命令用于显示各个 slab 中 item 的数目和存储时长(最后一次访问距离现在的秒数)。

stats items 命令的基本语法格式如下：
stats items
7、stats slabs 命令
stats slabs 命令用于显示各个 slab 的信息，包括 chunk 的大小、数目、使用情况等。

stats slabs 命令的基本语法格式如下：
stats slabs
8、 stats sizes 命令
Memcached stats sizes 命令用于显示所有 item 的大小和个数。
该信息返回两列，第一列是 item 的大小，第二列是 item 的个数。

stats sizes 命令的基本语法格式如下：
stats sizes
实例
stats sizes STAT 96 1 END
9、 flush_all 命令
flush_all 命令用于用于清理缓存中的所有 key=>value( 键 => 值) ) 对。
该命令提供了一个可选参数 time，用于在指定的时间后执行清理缓存操作。

flush_all 命令的基本语法格式如下：
flush_all [time] [noreply]
实例
清理缓存:

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END
flush_all
OK
get runoob
END