Memcached 命令
程序员文章站
2022-03-10 20:20:32
...
memcached 安装配置：http://donald-draper.iteye.com/blog/2395580
Memcached 教程 ：http://www.runoob.com/memcached/memcached-tutorial.html
上一篇文章讲了memcached的安装配置，今天来看一下memcached先关操作命令。
启动memcached
连接Memcached
set 命令
Memcached set 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果set的key已经存在，该命令可以更新该key所对应的原来的数据，也就是实现更新的作用。
set 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
get 命令
get 命令获取存储在 key(键) 中的 value(数据值) ，如果 key 不存在，则返回空。
语法：
get 命令的基本语法格式如下：
多个 key 使用空格隔开，如下:
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
示例：
replace 命令
Memcached replace 命令用于替换已存在的 key(键) 的 value(数据值)。
如果 key 不存在，则替换失败，并且您将获得响应 NOT_STORED。
语法：
replace 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
append 命令
Memcached append 命令用于向已存在 key(键) 的 value(数据值) 后面追加数据 。
语法：
append 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
prepend 命令
Memcached prepend 命令用于向已存在 key(键) 的 value(数据值) 前面追加数据 。
语法：
prepend 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
delete 命令
Memcached delete 命令用于删除已存在的 key(键)。
语法：
delete 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
noreply（可选）： 该参数告知服务器不需要返回数据
示例：
gets 命令
Memcached gets 命令获取带有 CAS 令牌存 的 value(数据值) ，如果 key 不存在，则返回空。
语法：
gets 命令的基本语法格式如下：
gets key
多个 key 使用空格隔开，如下:
gets key1 key2 key3
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
示例：
在使用 gets 命令的输出结果中，在最后一列的数字 7 代表了 key 为 name 的 CAS 令牌。
CAS 命令
Memcached CAS（Check-And-Set 或 Compare-And-Swap） 命令用于执行一个"检查并设置"的操作
它仅在当前客户端最后一次取值后，该key 对应的值没有被其他客户端修改的情况下， 才能够将值写入。检查是通过cas_token参数进行的， 这个参数是Memcach指定给已经存在的元素的一个唯一的64位值。
语法：
CAS 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
unique_cas_token通过 gets 命令获取的一个唯一的64位值。
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
incr 与 decr 命令
Memcached incr 与 decr 命令用于对已存在的 key(键) 的数字值进行自增或自减操作。
incr 与 decr 命令操作的数据必须是十进制的32位无符号整数。
如果 key 不存在返回 NOT_FOUND，如果键的值不为数字，则返回 CLIENT_ERROR，其他错误返回 ERROR。
incr 命令
语法：
incr 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
increment_value： 增加的数值。
decr 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
decrement_value： 减少的数值。
示例：
add 命令
Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果 add 的 key 已经存在，则不会更新数据(过期的 key 会更新)，之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。
语法：
add 命令的基本语法格式如下：
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
stats 命令
Memcached stats 命令用于返回统计信息例如 PID(进程号)、版本号、连接数等。
语法：
stats 命令的基本语法格式如下：
stats
示例：
END
下边详细解释每个状态项：
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
示例：
stats slabs 命令
Memcached stats slabs 命令用于显示各个slab的信息，包括chunk的大小、数目、使用情况等。
语法：
stats slabs
命令的基本语法格式如下：
stats slabs
示例：
flush_all 命令
Memcached flush_all 命令用于用于清理缓存中的所有 key=>value(键=>值) 对。
该命令提供了一个可选参数 time，用于在制定的时间后执行清理缓存操作。
语法：
flush_all 命令的基本语法格式如下：
示例：
stats sizes 命令
Memcached stats sizes 命令用于显示所有item的大小和个数。
该信息返回两列，第一列是 item 的大小，第二列是 item 的个数。
语法：
stats sizes 命令的基本语法格式如下：
Memcached 教程 ：http://www.runoob.com/memcached/memcached-tutorial.html
上一篇文章讲了memcached的安装配置，今天来看一下memcached先关操作命令。
启动memcached
[memcached@zabbix Desktop]$ memcached -p 11211 -d -u memcached -l 192.168.126.128 -c 1024 [memcached@zabbix Desktop]$ ps -ef | grep memcached memcach+ 4030 1 0 21:43 ? 00:00:00 memcached -p 11211 -d -u memcached -l 192.168.126.128 -c 1024 memcach+ 4044 3991 0 21:43 pts/0 00:00:00 grep --color=auto memcached [memcached@zabbix Desktop]$
连接Memcached
[memcached@zabbix ~]$ telnet 192.168.126.128 11211 Trying 192.168.126.128... Connected to 192.168.126.128. Escape character is '^]'.
set 命令
Memcached set 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果set的key已经存在，该命令可以更新该key所对应的原来的数据，也就是实现更新的作用。
set 命令的基本语法格式如下：
set key flags exptime bytes [noreply] value
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
set name 0 0 6 donald STORED
get 命令
get 命令获取存储在 key(键) 中的 value(数据值) ，如果 key 不存在，则返回空。
语法：
get 命令的基本语法格式如下：
get key
多个 key 使用空格隔开，如下:
get key1 key2 key3
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
示例：
get name VALUE name 0 6 donald END 测试set 命令 过期时间 set age 0 10 2 27 STORED 获取age的值 get age VALUE age 0 2 27 END 经过10秒钟以后 get age END
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）
示例：
get name VALUE name 0 6 donald END replace name 0 0 5 jamel STORED get name VALUE name 0 5 jamel END
append 命令
Memcached append 命令用于向已存在 key(键) 的 value(数据值) 后面追加数据 。
语法：
append 命令的基本语法格式如下：
append key flags exptime bytes [noreply] value
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
append name 0 0 4 _han STORED get name VALUE name 0 9 jamel_han END
prepend 命令
Memcached prepend 命令用于向已存在 key(键) 的 value(数据值) 前面追加数据 。
语法：
prepend 命令的基本语法格式如下：
prepend key flags exptime bytes [noreply] value
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
prepend name 0 0 1 0 STORED get name VALUE name 0 0 0jamel_han END
delete 命令
Memcached delete 命令用于删除已存在的 key(键)。
语法：
delete 命令的基本语法格式如下：
delete key [noreply]
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
noreply（可选）： 该参数告知服务器不需要返回数据
示例：
get name VALUE name 0 10 0jamel_han END delete name DELETED get name END delete name NOT_FOUND
gets 命令
Memcached gets 命令获取带有 CAS 令牌存 的 value(数据值) ，如果 key 不存在，则返回空。
语法：
gets 命令的基本语法格式如下：
gets key
多个 key 使用空格隔开，如下:
gets key1 key2 key3
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
示例：
set name 0 0 6 donald STORED get name VALUE name 0 6 donald END gets name VALUE name 0 6 7 donald END
在使用 gets 命令的输出结果中，在最后一列的数字 7 代表了 key 为 name 的 CAS 令牌。
CAS 命令
Memcached 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）
示例：
<− 缺少 token cas name 0 0 5 ERROR <− token不一致 cas name 0 0 5 1 jamel CLIENT_ERROR bad data chunk ERROR cas name 0 0 5 7 jamel STORED get name VALUE name 0 5 jamel END <− 键 age 不存在 cas age 0 0 2 1 27 NOT_FOUND
incr 与 decr 命令
Memcached incr 与 decr 命令用于对已存在的 key(键) 的数字值进行自增或自减操作。
incr 与 decr 命令操作的数据必须是十进制的32位无符号整数。
如果 key 不存在返回 NOT_FOUND，如果键的值不为数字，则返回 CLIENT_ERROR，其他错误返回 ERROR。
incr 命令
语法：
incr 命令的基本语法格式如下：
incr key increment_value
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
increment_value： 增加的数值。
decr 命令的基本语法格式如下：
decr key decrement_value
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
decrement_value： 减少的数值。
示例：
set age 0 0 2 27 STORED get age VALUE age 0 2 27 END incr age 1 28 get age VALUE age 0 2 28 END incr age 2 30 get age VALUE age 0 2 30 END decr age 1 29 get age VALUE age 0 2 29 END decr age 2 27 get age VALUE age 0 2 27 END 重新设置age值，过期时间为10秒 set age 0 10 2 19 STORED get age VALUE age 0 2 19 END 过10秒钟： get age END
add 命令
Memcached add 命令用于将 value(数据值) 存储在指定的 key(键) 中。
如果 add 的 key 已经存在，则不会更新数据(过期的 key 会更新)，之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。
语法：
add 命令的基本语法格式如下：
add key flags exptime bytes [noreply] value
参数说明如下：
key：键值 key-value 结构中的 key，用于查找缓存值。
flags：可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息 。
exptime：在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）
bytes：在缓存中存储的字节数
noreply（可选）： 该参数告知服务器不需要返回数据
value：存储的值（始终位于第二行）（可直接理解为key-value结构中的value）
示例：
get name VALUE name 0 6 donald END key 已经存在 add name 0 10 5 jamel NOT_STORED get name VALUE name 0 6 donald END 重新设置过期时间 set name 0 10 5 jamel STORED 过10秒钟 get name END add name 0 10 6 donald STORED get name END add name 0 20 5 jamel STORED get name VALUE name 0 5 jamel END 过20秒以后 get name END 针对key不存在 get age END delete age NOT_FOUND add age 0 0 2 27 STORED get age VALUE age 0 2 27 END
stats 命令
Memcached stats 命令用于返回统计信息例如 PID(进程号)、版本号、连接数等。
语法：
stats 命令的基本语法格式如下：
stats
示例：
stats STAT pid 4030 STAT uptime 4497 STAT time 1507561106 STAT version 1.5.2 STAT libevent 2.1.8-stable STAT pointer_size 64 STAT rusage_user 0.956704 STAT rusage_system 0.956704 STAT max_connections 1024 STAT curr_connections 5 STAT total_connections 8 STAT rejected_connections 0 STAT connection_structures 6 STAT reserved_fds 20 STAT cmd_get 53 STAT cmd_set 24 STAT cmd_flush 0 STAT cmd_touch 0 STAT get_hits 37 STAT get_misses 16 STAT get_expired 3 STAT get_flushed 0 STAT delete_misses 2 STAT delete_hits 3 STAT incr_misses 0 STAT incr_hits 2 STAT decr_misses 0 STAT decr_hits 2 STAT cas_misses 1 STAT cas_hits 1 STAT cas_badval 0 STAT touch_hits 0 STAT touch_misses 0 STAT auth_cmds 0 STAT auth_errors 0 STAT bytes_read 1369 STAT bytes_written 1779 STAT limit_maxbytes 67108864 STAT accepting_conns 1 STAT listen_disabled_num 0 STAT time_in_listen_disabled_us 0 STAT threads 4 STAT conn_yields 0 STAT hash_power_level 16 STAT hash_bytes 524288 STAT hash_is_expanding 0 STAT slab_reassign_rescues 0 STAT slab_reassign_chunk_rescues 0 STAT slab_reassign_evictions_nomem 0 STAT slab_reassign_inline_reclaim 0 STAT slab_reassign_busy_items 0 STAT slab_reassign_busy_deletes 0 STAT slab_reassign_running 0 STAT slabs_moved 0 STAT lru_crawler_running 0 STAT lru_crawler_starts 3060 STAT lru_maintainer_juggles 8631 STAT malloc_fails 0 STAT log_worker_dropped 0 STAT log_worker_written 0 STAT log_watcher_skipped 0 STAT log_watcher_sent 0 STAT bytes 64 STAT curr_items 1 STAT total_items 18 STAT slab_global_page_pool 0 STAT expired_unfetched 2 STAT evicted_unfetched 0 STAT evicted_active 0 STAT evictions 0 STAT reclaimed 3 STAT crawler_reclaimed 0 STAT crawler_items_checked 1 STAT lrutail_reflocked 40 STAT moves_to_cold 40 STAT moves_to_warm 22 STAT moves_within_lru 0 STAT direct_reclaims 0 STAT lru_bumps_dropped 0
END
下边详细解释每个状态项：
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
示例：
stats items STAT items:1:number 2 STAT items:1:number_hot 0 STAT items:1:number_warm 0 STAT items:1:number_cold 2 STAT items:1:age_hot 0 STAT items:1:age_warm 0 STAT items:1:age 27 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 3 STAT items:1:expired_unfetched 2 STAT items:1:evicted_unfetched 0 STAT items:1:evicted_active 0 STAT items:1:crawler_reclaimed 0 STAT items:1:crawler_items_checked 1 STAT items:1:lrutail_reflocked 40 STAT items:1:moves_to_cold 42 STAT items:1:moves_to_warm 23 STAT items:1:moves_within_lru 0 STAT items:1:direct_reclaims 0 STAT items:1:hits_to_hot 0 STAT items:1:hits_to_warm 0 STAT items:1:hits_to_cold 39 STAT items:1:hits_to_temp 0 END
stats slabs 命令
Memcached stats slabs 命令用于显示各个slab的信息，包括chunk的大小、数目、使用情况等。
语法：
stats slabs
命令的基本语法格式如下：
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 69 STAT 1:get_hits 2 STAT 1:cmd_set 2 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 1048576 END
flush_all 命令
Memcached flush_all 命令用于用于清理缓存中的所有 key=>value(键=>值) 对。
该命令提供了一个可选参数 time，用于在制定的时间后执行清理缓存操作。
语法：
flush_all 命令的基本语法格式如下：
flush_all [time] [noreply]
示例：
flush_all 5 OK get name VALUE name 0 6 donald END get age END get name END
stats sizes 命令
Memcached stats sizes 命令用于显示所有item的大小和个数。
该信息返回两列，第一列是 item 的大小，第二列是 item 的个数。
语法：
stats sizes 命令的基本语法格式如下：
stats sizes
上一篇： springboot:memcached
下一篇： Gmail：添加任务列表