Memcached常用命令及使用说明

Memcached常用命令及使用说明

一、存储命令

存储命令的格式：

1 2	<command name> <key> <flags> <exptime> <bytes> <data block>

参数说明如下：

<command name>	set/add/replace
<key>	查找关键字
<flags>	客户机使用它存储关于键值对的额外信息
<exptime>	该数据的存活时间，0表示永远
<bytes>	存储字节数
<data block>	存储的数据块（可直接理解为key-value结构中的value）

1、添加

(1)、无论如何都存储的set

这个set的命令在memcached中的使用频率极高。set命令不但可以简单添加，如果set的key已经存在，该命令可以更新该key所对应的原来的数据，也就是实现更新的作用。

可以通过“get 键名”的方式查看添加进去的记录：

如你所知，我们也可以通过delete命令删除掉，然后重新添加。

(2)、只有数据不存在时进行添加的add

(3)、只有数据存在时进行替换的replace

 

2、删除

可以看到，删除已存在的键值和不存在的记录可以返回不同的结果。

 

二、读取命令

1、get

get命令的key可以表示一个或者多个键，键之间以空格隔开

2、gets

可以看到，gets命令比普通的get命令多返回了一个数字（上图中为13）。这个数字可以检查数据是否发生改变。当key对应的数据改变时，这个多返回的数字也会改变。

3、cas

cas即checked and set的意思，只有当最后一个参数和gets所获取的参数匹配时才能存储，否则返回“EXISTS”。

 

三、状态命令

1、stats

 

2、stats items

执行stats items，可以看到STAT items行，如果memcached存储内容很多，那么这里也会列出很多的STAT items行。

 

3、stats cachedump slab_id limit_num

我们执行stats cachedump 1 0 命令效果如下：

这里slab_id为1，是由2中的stats items返回的结果（STAT items后面的数字）决定的；limit_num看起来好像是返回多少条记录，猜的一点不错， 不过0表示显示出所有记录，而n(n>0)就表示显示n条记录，如果n超过该slab下的所有记录，则结果和0返回的结果一致。

通过stats items、stats cachedump slab_id limit_num配合get命令可以遍历memcached的记录。

 

4、其他stats命令

如stats slabs,stats sizes,stats reset等等使用也比较常见。

 

四、其他常见命令

1、append

在现有的缓存数据后添加缓存数据，如现有缓存的key不存在服务器响应为NOT_STORED。

 

2、prepend

和append非常类似，但它的作用是在现有的缓存数据前添加缓存数据。

 

3、flush_all

该命令有一个可选的数字参数。它总是执行成功，服务器会发送 “OK\r\n” 回应。它的效果是使已经存在的项目立即失效（缺省），或在指定的时间后。此后执行取回命令，将不会有任何内容返回（除非重新存储同样的键名）。 flush_all 实际上没有立即释放项目所占用的内存，而是在随后陆续有新的项目被储存时执行（这是由memcached的懒惰检测和删除机制决定的）。

flush_all 效果是它导致所有更新时间早于 flush_all 所设定时间的项目，在被执行取回命令时命令被忽略。

4、其他命令

memcached还有很多命令，比如对于存储为数字型的可以通过incr/decr命令进行增减操作等等，这里只列出开发和运维中经常使用的命令，其他的不再一一举例说明。

 

补充一则：简单认识.net framework中的几种缓存

web站点中缓存的重要性毋庸置疑。我想很多asp.net开发人员在开发web应用系统的时候优先考虑使用的缓存并不是第三方缓存解决方案（比如分布式缓存memcached、redis等等），而应该是.net framework已经提供的多种缓存解决方案。下面结合自己的开发经验谈谈对.net framework中缓存的认识。

1、System.Web.Caching.Cache

估计大部分做过asp.net开发的人都用过这个命名空间下的缓存，我们可以直接使用HttpContext.Current.Cache实例而不用实例化。当然这个命名空间下的Cache类是允许您实例化的，需要定制自己的缓存系统的当然可以完全自己控制如何初始化这个类。我在园子里看到过有很多文章介绍Cache的CRUD辅助类库大多数都是针对System.Web.Caching.Cache。

需要说明的是，我们还可以通过该命名空间下的HttpRuntime.Cache实现web、控制台、winform等不同表现形式下的缓存，而且完全无需自己实例化。HttpRuntime.Cache是之前个人开发中使用比较多的一个类，现在比较偏爱.net framework4.0中的增强型的缓存类MemoryCache。

 

2、Output Cache

众所周知，输出缓存主要分页面输出缓存和页面部分缓存。说白了，就是缓存整个页面的html或者部分html，本来没什么值得讨论的，但是最近看到dudu的这篇博客才恍然发现，想不到使用它还真是大有讲究，我以前怎么就没有发现这个问题呢？看来发现问题和解决问题的能力同样重要，有时候前者甚至更重要啊。

 

3、System.Runtime.Caching

现在个人开发中使用最多的类MemoryCache出自这个命名空间，使用前需要引用using System.Runtime.Caching。MemoryCache继承自ObjectCache, IEnumerable, IDisposable，其中ObjectCache是个抽象类。用过MemoryCache的人都知道，这个MemoryCache有一个属性叫Default，通常可以像下面这样使用：

private static ObjectCache memCache = MemoryCache.Default;

当然我们也完全可以通过public MemoryCache(string name, NameValueCollection config = null)构造函数初始化缓存对象。

接着我们可以在web.config文件中配置每个MemoryCache实例运行的内存使用配额方案和配额检查周期，下面示例参考MSDN：

  <system.runtime.caching>
    <memoryCache>
      <namedCaches>
        <add name="Default" cacheMemoryLimitMegabytes="10"  pollingInterval="00:02:00"/>
      </namedCaches>
    </memoryCache>
  </system.runtime.caching>

这些配置意义在于可以明确指定每个MemoryCache实例运行的内存使用配额方案和配额检查周期。比如我们可以通过配置来按需更改MemoryCache.Default实例的内存配额（不知道缓存可用最大内存是多少，可能还是传说中的800M左右）。缓存过期策略与其它的缓存框架大同小异，与System.Web.Caching.Cache的不同只是名称不叫CacheDependency，而叫ChangeMonitor，并且提供了基于文件和目录的缓存依赖策略。关于缓存过期策略也比较有探讨的必要，不过个人开发中比较偏重于数据缓存和替换，目前还没有接触和使用过比较完美的过期策略解决方案。

memcached常见命令

  1、启动Memcache 常用参数

-p <num>      设置端口号(默认不设置为: 11211)

-U <num>      UDP监听端口(默认: 11211, 0 时关闭) 

-l <ip_addr>  绑定地址(默认:所有都允许,无论内外网或者本机更换IP，有安全隐患，若设置为127.0.0.1就只能本机访问)

-d            独立进程运行

-u <username> 绑定使用指定用于运行进程<username>

-m <num>      允许最大内存用量，单位M (默认: 64 MB)

-P <file>     将PID写入文件<file>，这样可以使得后边进行快速进程终止, 需要与-d 一起使用

如：

在linux下：./usr/local/bin/memcached -d -u jb-mc -l 192.168.1.197 -m 2048 -p 12121

在window下：d:\App_Serv\memcached\memcached.exe -d RunService -l 127.0.0.1 -p 11211 -m 500

在windows下注册为服务后运行：

sc.exe create jb-Memcached binpath= “d:\App_Serv\memcached\memcached.exe -d RunService -p 11211 -m 500″start= auto

net start jb-Memcached

 

2、连接：telnet 127.0.0.1 11211

3、您将使用五种基本memcached 命令执行最简单的操作。这些命令和操作包括：

 

set: 用于向缓存添加新的键值对。如果键已经存在，则之前的值将被替换。

add :仅当缓存中不存在键时，add 命令才会向缓存中添加一个键值对。如果缓存中已经存在键，则之前的值将仍然保持相同，并且您将获得响应NOT_STORED 。

replace:仅当键已经存在时，replace 命令才会替换缓存中的键。如果缓存中不存在键，那么您将从memcached 服务器接受到一条NOT_STORED 响应。

get:用于检索与之前添加的键值对相关的值。

delete:用于删除memcached 中的任何现有值。您将使用一个键调用delete ，如果该键存在于缓存中，则删除该值。如果不存在，则返回一条NOT_FOUND 消息。

gets:功能类似于基本的get 命令。两个命令之间的差异在于，gets 返回的信息稍微多一些：64 位的整型值非常像名称/值对的 “版本” 标识符。 

前三个命令是用于操作存储在memcached 中的键值对的标准修改命令。它们都非常简单易用，且都使用清单5 所示的语法：

 

command <key> <flags> <expiration time> <bytes>

<value>

 

表1. memcached 修改命令参数

 

参数       用法

key  key 用于查找缓存值

flags       可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息

expiration time       在缓存中保存键值对的时间长度（以秒为单位，0 表示永远）

bytes       在缓存中存储的字节点

value       存储的值（始终位于第二行） 例子：

set useID 0 0 5

 

1234

 

 

 

4、缓存管理命令

 

最后两个memcached 命令用于监控和清理memcached 实例。它们是stats 和flush_all 命令。

 

stats ：转储所连接的memcached 实例的当前统计数据。

flush_all：用于清理缓存中的所有名称/值对。如果您需要将缓存重置到干净的状态，则flush_all 能提供很大的用处。

查看memcached状态的基本命令，通过这个命令可以看到如下信息：

 

STAT pid 22459                             进程ID

STAT uptime 1027046                        服务器运行秒数

STAT time 1273043062                       服务器当前unix时间戳

STAT version 1.4.4                         服务器版本

STAT pointer_size 64                       操作系统字大小(这台服务器是64位的)

STAT rusage_user 0.040000                  进程累计用户时间

STAT rusage_system 0.260000                进程累计系统时间

STAT curr_connections 10                   当前打开连接数

STAT total_connections 82                  曾打开的连接总数

STAT connection_structures 13              服务器分配的连接结构数

STAT cmd_get 54                            执行get命令总数

STAT cmd_set 34                            执行set命令总数

STAT cmd_flush 3                           指向flush_all命令总数

STAT get_hits 9                            get命中次数

STAT get_misses 45                         get未命中次数

STAT delete_misses 5                       delete未命中次数

STAT delete_hits 1                         delete命中次数

STAT incr_misses 0                         incr未命中次数

STAT incr_hits 0                           incr命中次数

STAT decr_misses 0                         decr未命中次数

STAT decr_hits 0                           decr命中次数

STAT cas_misses 0    cas未命中次数

STAT cas_hits 0                            cas命中次数

STAT cas_badval 0                          使用擦拭次数

STAT auth_cmds 0

STAT auth_errors 0

STAT bytes_read 15785                      读取字节总数

STAT bytes_written 15222                   写入字节总数

STAT limit_maxbytes 1048576                分配的内存数（字节）

STAT accepting_conns 1                     目前接受的链接数

STAT listen_disabled_num 0                

STAT threads 4                             线程数

STAT conn_yields 0

STAT bytes 0                               存储item字节数

STAT curr_items 0                          item个数

STAT total_items 34                        item总数

STAT evictions 0                           为获取空间删除item的总数

ps -ef | grep memcache

/usr/bin/memcached -d -l 127.0.0.1 -m 2048 -p 11212

这里需要说明一下memcached服务的启动参数：

-p 监听的端口
-l 连接的IP地址, 默认是本机
-d start 启动memcached服务
-d restart 重起memcached服务
-d stop|shutdown 关闭正在运行的memcached服务
-d install 安装memcached服务
-d uninstall 卸载memcached服务
-u 以的身份运行 (仅在以root运行的时候有效)
-m 最大内存使用，单位MB。默认64MB
-M 内存耗尽时返回错误，而不是删除项
-c 最大同时连接数，默认是1024
-f 块大小增长因子，默认是1.25-n 最小分配空间，key+value+flags默认是48
-h 显示帮助