memcached 第2章 命令
1、Memcached 存储命令
①、set 命令
set 命令用于将 value(数据值) 存储在指定的 key(键) 中。如果set的key已经存在，该命令可以更新该key所对应的原来的数据，也就是实现更新的作用。
set key flags exptime bytes [noreply]
value
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
以下实例中我们设置：
key → lulublog
flag → 0
exptime → 900 (以秒为单位)
bytes → 9 (数据存储的字节数)
value → memcached
set lulublog 0 900 9
memcached
STORED
get lulublog
VALUE lulublog 0 9
memcached
END
输出信息说明：
STORED：保存成功后输出。
ERROR：在保存失败后输出。
②、add 命令
Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。 如果 add 的 key 已经存在，则不会更新数据(过期的 key 会更新)，之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。
add key flags exptime bytes [noreply]
value
add lulublog 0 900 9
memcached
NOT_STORED
输出信息说明：
STORED：保存成功后输出。
NOT_STORED ：在保存失败后输出。
③、replace 命令
Memcached replace 命令用于替换已存在的 key(键) 的 value(数据值)。 如果 key 不存在，则替换失败，并且您将获得响应 NOT_STORED。
replace key flags exptime bytes [noreply]
value
replace lulublog 0 900 5
redis
STORED
get lulublog
VALUE lulublog 0 5
redis
END
输出信息说明：
STORED：保存成功后输出。
NOT_STORED：执行替换失败后输出。
④、append 命令
Memcached append 命令用于向已存在 key(键) 的 value(数据值) 后面追加数据 。
append key flags exptime bytes [noreply]
value
append lulublog 0 900 4
test
STORED
get lulublog
VALUE lulublog 0 9
redistest
END
输出信息说明：
STORED：保存成功后输出。
NOT_STORED：该键在 Memcached 上不存在。
CLIENT_ERROR：执行错误。
⑤、prepend 命令
Memcached prepend 命令用于向已存在 key(键) 的 value(数据值) 前面追加数据 。
prepend key flags exptime bytes [noreply]
value
prepend lulublog 0 900 4
love
STORED
get lulublog
VALUE lulublog 0 13
loveredistest
END
输出信息说明：
STORED：保存成功后输出。
NOT_STORED：该键在 Memcached 上不存在。
CLIENT_ERROR：执行错误。
⑥、CAS 命令
Memcached CAS（Check-And-Set 或 Compare-And-Swap） 命令用于执行一个"检查并设置"的操作 它仅在当前客户端最后一次取值后，该key 对应的值没有被其他客户端修改的情况下， 才能够将值写入。 检查是通过cas_token参数进行的， 这个参数是Memcach指定给已经存在的元素的一个唯一的64位值。
cas key flags exptime bytes unique_cas_token [noreply]
value
unique_cas_token通过 gets 命令获取的一个唯一的64位值。
要在 Memcached 上使用 CAS 命令，你需要从 Memcached 服务商通过 gets 命令获取令牌（token）。 gets 命令的功能类似于基本的 get 命令。两个命令之间的差异在于，gets 返回的信息稍微多一些：64 位的整型值非常像名称/值对的 "版本" 标识符。
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：保存成功后输出。
ERROR：保存出错或语法错误。
EXISTS：在最后一次取值后另外一个用户也在更新该数据。
NOT_FOUND：Memcached 服务上不存在该键值。
2、Memcached 查找命令
①、get 命令
Memcached get 命令获取存储在 key(键) 中的 value(数据值) ，如果 key 不存在，则返回空。
get key
get key1 key2 key3
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
set lulublog 0 900 9
memcached
STORED
get lulublog
VALUE lulublog 0 9
memcached
END
②、gets 命令
Memcached gets 命令获取带有 CAS 令牌存 的 value(数据值) ，如果 key 不存在，则返回空。
gets key
gets key1 key2 key3
set lulublog 0 900 9
memcached
STORED
gets lulublog
VALUE lulublog 0 9 1
memcached
END
在 使用 gets 命令的输出结果中，在最后一列的数字 1 代表了 key 为 lulublog 的 CAS 令牌。
③、delete 命令
Memcached delete 命令用于删除已存在的 key(键)。
delete key [noreply]
set lulublog 0 900 9
memcached
STORED
get lulublog
VALUE lulublog 0 9
memcached
END
delete lulublog
DELETED
get lulublog
END
delete lulublog
NOT_FOUND
输出信息说明：
DELETED：删除成功。
ERROR：语法错误或删除失败。
NOT_FOUND：key 不存在。
④、incr 与 decr 命令
Memcached incr 与 decr 命令用于对已存在的 key(键) 的数字值进行自增或自减操作。 incr 与 decr 命令操作的数据必须是十进制的32位无符号整数。
incr key increment_value
decr key decrement_value
increment_value： 增加的数值。
decrement_value： 减少的数值。
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
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其他错误，如语法错误等。
3、Memcached 统计命令
①、stats 命令
Memcached stats 命令用于返回统计信息例如 PID(进程号)、版本号、连接数等。
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 命令
Memcached stats items 命令用于显示各个 slab 中 item 的数目和存储时长(最后一次访问距离现在的秒数)。
stats items
stats items
STAT items:1:number 1
STAT items:1:age 7
STAT items:1:evicted 0
STAT items:1:evicted_nonzero 0
STAT items:1:evicted_time 0
STAT items:1:outofmemory 0
STAT items:1:tailrepairs 0
STAT items:1:reclaimed 0
STAT items:1:expired_unfetched 0
STAT items:1:evicted_unfetched 0
END
③、stats slabs 命令
Memcached stats slabs 命令用于显示各个slab的信息，包括chunk的大小、数目、使用情况等。
stats slabs
stats slabs
STAT 1:chunk_size 96
STAT 1:chunks_per_page 10922
STAT 1:total_pages 1
STAT 1:total_chunks 10922
STAT 1:used_chunks 1
STAT 1:free_chunks 10921
STAT 1:free_chunks_end 0
STAT 1:mem_requested 71
STAT 1:get_hits 0
STAT 1:cmd_set 1
STAT 1:delete_hits 0
STAT 1:incr_hits 0
STAT 1:decr_hits 0
STAT 1:cas_hits 0
STAT 1:cas_badval 0
STAT 1:touch_hits 0
STAT active_slabs 1
STAT total_malloced 1048512
END
④、stats sizes 命令
Memcached stats sizes 命令用于显示所有item的大小和个数。 该信息返回两列，第一列是 item 的大小，第二列是 item 的个数。
stats sizes
stats sizes
STAT 96 1
END
⑤、flush_all 命令
Memcached flush_all 命令用于清理缓存中的所有 key=>value(键=>值) 对。 该命令提供了一个可选参数 time，用于在制定的时间后执行清理缓存操作。
flush_all [time] [noreply]
set lulublog 0 900 9
memcached
STORED
get lulublog
VALUE lulublog 0 9
memcached
END
flush_all
OK
get lulublog
END
4、memcached 进阶
①、Memcached 备份、还原的方式
—— 方法一：memcached-tool
A、设置 lulublog 缓存
telnet 127.0.0.1 11211
set lulublog 0 900 9
memcached
quit
B、备份本地的 memcached
cd /usr/local/src
wget https://raw.githubusercontent.com/memcached/memcached/master/scripts/memcached-tool --no-check-certificate
chmod +x ./memcached-tool
./memcached-tool 127.0.0.1:11211 dump > data #将文件备份在data中，在/usr/local/src会生成data文件
#输出
Dumping memcache contents
C、清除 lulublog 缓存
telnet 127.0.0.1 11211
delete lulublog
quit
D、安装 nc
Linux Netcat 命令用法简介 netcat(简写是nc)是linux上非常有用的网络工具，它能通过TCP和UDP在网络中读写数据。 通过配合使用其他工具和重定向，可以在脚本中以多种方式使用它。
yum install nc.x86_64
E、还原
cd /usr/local/src
nc 127.0.0.1 11211 < data #还原
F、验证
telnet 127.0.0.1 11211
get lulublog
#输出
VALUE lulublog 0 9
memcached
END
—— 方法二：php 版本
A、安装 php 扩展 php-memcache
B、下载 m.php 到服务器
C、设置 lulublog 缓存
telnet 127.0.0.1 11211
set lulublog 0 900 9
memcached
quit
D、备份
#切换到 m.php 所在目录
php m.php -h 127.0.0.1 -p 11211 -op backup
#输出
Memcached Data has been saved to file :memcacheData.txt
E、清除 lulublog 缓存
telnet 127.0.0.1 11211
delete lulublog
quit
F、还原
#切换到 m.php 所在目录
php m.php -h 127.0.0.1 -p 11211 -op restore
#输出
Memcached Data has been restored from file: memcacheData.txt
G、验证
telnet 127.0.0.1 11211
get lulublog
#输出
VALUE lulublog 0 9
memcached
END
