Memcached 经常使用指令

1、经常使用的存储数据的三个指令

主要的三个存储数据的指令分别是：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数据内容，发送完数据之后，客户端通常等待服务器端的返回；

一、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

二、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 ：在保持失败后输出。

三、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：执行替换失败后输出。~~~~

四、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：执行错误。

五、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：执行错误。
六、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 服务上不存在该键值。

.
2、经常使用的查找命令
一、 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

二、 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 令牌。

三、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 不存在。

四、 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 其余错误，如语法错误等。

五、 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：已过时的数据条目来存储新数据的数目

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

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

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

stats sizes 命令的基本语法格式以下：
stats sizes
实例
stats sizes STAT 96 1 END
九、 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