Memcached常用命令及使用说明

淡淡的烟草味﹌ 2022-08-06 12:12 156阅读 0赞

http://www.cnblogs.com/jeffwongishandsome/archive/2011/11/06/2238265.html

## 一、存储命令 ##

存储命令的格式：

<table style="border:1px solid silver; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.1em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px!important; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:1101px; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; border-collapse:collapse; word-break:break-word; background:none!important"> 
 <tbody style="border:0px!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.1em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px!important; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; background:none!important"> 
  <tr style="border:0px!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.1em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px!important; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; background:none!important"> 
   <td style="font-size:12px!important; color:rgb(175,175,175)!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; border:1px solid silver; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.1em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:3px; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:35px!important; font-weight:normal!important; font-style:normal!important; min-height:inherit!important; border-collapse:collapse; background:none!important"> 
    <div style="border-width:0px 2px 0px 0px!important; border-right-style:solid!important; border-right-color:rgb(108,226,108)!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.8em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px 0.5em!important; position:static!important; right:auto!important; text-align:right!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; white-space:normal!important; background:none rgb(244,244,244)!important">
      1 
    </div> 
    <div style="border-width:0px 2px 0px 0px!important; border-right-style:solid!important; border-right-color:rgb(108,226,108)!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.8em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px 0.5em!important; position:static!important; right:auto!important; text-align:right!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; white-space:normal!important; background:none rgb(255,255,255)!important">
      2 
    </div> </td> 
   <td style="font-size:12px!important; color:rgb(69,69,69); font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; border:1px solid silver; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.1em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:3px; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-weight:normal!important; font-style:normal!important; min-height:inherit!important; border-collapse:collapse; background:none!important"> 
    <div style="border:0px!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.1em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px!important; position:relative!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; background:none!important"> 
     <div style="border:0px!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.8em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px 1em!important; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; white-space:normal!important; background:none rgb(244,244,244)!important"> 
      <code style="border:0px!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.8em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px!important; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; white-space:pre-wrap; color:rgb(0,0,0)!important; background:none!important">&lt;command name&gt; &lt;key&gt; &lt;flags&gt; &lt;exptime&gt; &lt;bytes&gt;</code> 
     </div> 
     <div style="border:0px!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.8em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px 1em!important; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; white-space:normal!important; background:none rgb(255,255,255)!important"> 
      <code style="border:0px!important; bottom:auto!important; float:none!important; height:auto!important; left:auto!important; line-height:1.8em!important; margin:0px!important; outline:0px!important; overflow:visible!important; padding:0px!important; position:static!important; right:auto!important; text-align:left!important; top:auto!important; vertical-align:baseline!important; width:auto!important; font-family:Consolas,'Bitstream Vera Sans Mono','Courier New',Courier,monospace!important; font-weight:normal!important; font-style:normal!important; font-size:12px!important; min-height:inherit!important; white-space:pre-wrap; color:rgb(0,0,0)!important; background:none!important">&lt;data block&gt;</code> 
     </div> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

参数说明如下：

<table style="border:1px solid silver; border-collapse:collapse; word-break:break-word; width:550px"> 
 <tbody> 
  <tr> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> &lt;command name&gt;</td> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> set/add/replace</td> 
  </tr> 
  <tr> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> &lt;key&gt;</td> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> <span style="color:#00ff; line-height:1.5">查找关键字</span></td> 
  </tr> 
  <tr> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> &lt;flags&gt;</td> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> 客户机使用它存储关于键值对的额外信息</td> 
  </tr> 
  <tr> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> &lt;exptime&gt;</td> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> 该数据的存活时间，0表示永远</td> 
  </tr> 
  <tr> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> &lt;bytes&gt;</td> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> 存储字节数</td> 
  </tr> 
  <tr> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> &lt;data block&gt;</td> 
   <td style="font-size:12px; color:rgb(69,69,69); font-family:Verdana,Geneva,Arial,Helvetica,sans-serif; border:1px solid silver; border-collapse:collapse; padding:3px"> 存储的数据块（可直接理解为key-value结构中的value）</td> 
  </tr> 
 </tbody> 
</table>

### 1、添加 ###

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

[![set][]][set 1]

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

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

[![set\_get][set_get]][set_get_set_get]

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

[![delete][]][delete 1]

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

[![add][]][add 1]

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

[![replace][]][replace 1]

## ##

### 2、删除 ###

[![delete][delete 2]][delete_delete 2]

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

## 二、读取命令 ##

### 1、get ###

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

[![get][]][get 1]

### 2、gets ###

[![gets][]][gets 1]

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

### 3、cas ###

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

[![cas][]][cas 1]

## 三、状态命令 ##

### 1、stats ###

[![stats][]][stats 1]

### 2、stats items ###

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

### 3、stats cachedump slab\_id limit\_num ###

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

[![statscachedump][]][statscachedump 1]

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

[![statscachedump1][]][statscachedump1 1]  
通过stats items、stats cachedump slab\_id limit\_num配合get命令可以遍历memcached的记录。

### 4、其他stats命令 ###

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

[![statsother][]][statsother 1]

## 四、其他常见命令 ##

### 1、append ###

[![append][]][append 1]

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

### 2、prepend ###

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

[![prepend][]][prepend 1]

### 3、flush\_all ###

[![flush\_all][flush_all]][flush_all_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的[这篇][Link 1]博客才恍然发现，想不到使用它还真是大有讲究，我以前怎么就没有发现这个问题呢？看来发现问题和解决问题的能力同样重要，有时候前者甚至更重要啊。

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][]，并且提供了基于文件和目录的缓存依赖策略。关于缓存过期策略也比较有探讨的必要，不过个人开发中比较偏重于数据缓存和替换，目前还没有接触和使用过比较完美的过期策略解决方案。

参考：

[http://code.google.com/p/memcached/wiki/NewCommands][http_code.google.com_p_memcached_wiki_NewCommands]

[http://msdn.microsoft.com/zh-cn/library/system.runtime.caching.memorycache.aspx][http_msdn.microsoft.com_zh-cn_library_system.runtime.caching.memorycache.aspx]

[http://www.cnblogs.com/dudu/archive/2011/11/03/outputcache\_Bug\_vary.html][Link 1]

[http://msdn.microsoft.com/zh-cn/library/system.web.caching.cache(v=VS.100).aspx][http_msdn.microsoft.com_zh-cn_library_system.web.caching.cache_v_VS.100_.aspx]

[set]: /images/20220806/5d6d5688dc5140aabf38f48af94a8f62.png
[set 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815074223.jpg
[set_get]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815075236.jpg
[set_get_set_get]: /images/20220806/0f7d233b7ff544dea6a65190033566f3.png
[delete]: /images/20220806/aafd02c3fbf540a79f4a0f705292f294.png
[delete 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/20111106181507535.jpg
[add]: /images/20220806/21a05991f138477582ae0680d4782b29.png
[add 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815087122.jpg
[replace]: /images/20220806/1dc9998b410e468da3addb125238a109.png
[replace 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815085976.jpg
[delete 2]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815098942.jpg
[delete_delete 2]: /images/20220806/a0fbf9b066aa4749a21c37f857c137a7.png
[get]: /images/20220806/b07f7a6c9edd4a9e9ee9d909e3cbe5f5.png
[get 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815098909.jpg
[gets]: /images/20220806/eeb21edafb5545c7a94f0eaf65596fb3.png
[gets 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815103303.jpg
[cas]: /images/20220806/2db48344cf0140adab5e8abcf5f806ae.png
[cas 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815113793.jpg
[stats]: /images/20220806/f91c3bfac3f14f20b7fbdc78a770c5ca.png
[stats 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815118187.jpg
[statsitems]: /images/20220806/24580c0577cb49febd6d98d6312c9dfe.png
[statsitems 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815124774.jpg
[statscachedump]: /images/20220806/1e150d9fca204ba187a306acf4afbd80.png
[statscachedump 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815126136.jpg
[statscachedump1]: /images/20220806/26ce6d0d96904a3b971ada67a59dbdd1.png
[statscachedump1 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815138579.jpg
[statsother]: /images/20220806/17890dbde21c40d1ad8b4ef779899268.png
[statsother 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815132973.jpg
[append]: /images/20220806/c69c8f8668444301ba70c51d1e2c5ca8.png
[append 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815149875.jpg
[prepend]: /images/20220806/9f781d060e314693be103fe219a3f70e.png
[prepend 1]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061815141445.jpg
[flush_all]: http://images.cnblogs.com/cnblogs_com/jeffwongishandsome/201111/201111061809104896.jpg
[flush_all_flush_all]: /images/20220806/1f8f3ba9164c4ef19cbfc81deff83156.png
[Link 1]: http://www.cnblogs.com/dudu/archive/2011/11/03/outputcache_Bug_vary.html
[MSDN]: http://msdn.microsoft.com/zh-cn/library/dd941872.aspx
[ChangeMonitor]: http://msdn.microsoft.com/zh-cn/library/system.runtime.caching.changemonitor.aspx
[http_code.google.com_p_memcached_wiki_NewCommands]: http://code.google.com/p/memcached/wiki/NewCommands
[http_msdn.microsoft.com_zh-cn_library_system.runtime.caching.memorycache.aspx]: http://msdn.microsoft.com/zh-cn/library/system.runtime.caching.memorycache.aspx
[http_msdn.microsoft.com_zh-cn_library_system.web.caching.cache_v_VS.100_.aspx]: http://msdn.microsoft.com/zh-cn/library/system.web.caching.cache%28v=VS.100%29.aspx