memcached 常用命令及使用说明

1、启动Memcache 常用参数

-p <num>      设置TCP端口号(默认设置为: )
-U <num>      UDP监听端口(默认: ,  时关闭)
-l <ip_addr>  绑定地址(默认:所有都允许,无论内外网或者本机更换IP，有安全隐患，若设置为127.0.0.1就只能本机访问)
-c <num>      max simultaneous connections (default: 1024)
-d            以daemon方式运行
-u <username> 绑定使用指定用于运行进程<username>
-m <num>      允许最大内存用量，单位M (默认:  MB)
-P <file>     将PID写入文件<file>，这样可以使得后边进行快速进程终止, 需要与-d 一起使用

更多可以使用者 memcached -h
在linux下：./usr/local/bin/memcached -d -u root  -l 192.168.1.197 -m  -p
在window下：d:\App_Serv\memcached\memcached.exe -d RunService -l 127.0.0.1 -p  -m
在windows下注册为服务后运行：
sc.exe create Memcached_srv binpath= “d:\App_Serv\memcached\memcached.exe -d RunService -p  -m ″start= auto
net start Memcached

2、连接和退出

telnet 127.0.0.1
quit

3、基本命令

五种基本 memcached 命令执行最简单的操作。这些命令和操作包括：

set
add
replace
get
delete

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

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

参数说明如下：
command set/add/replace
key     key 用于查找缓存值
flags     可以包括键值对的整型参数，客户机使用它存储关于键值对的额外信息
expiration time     在缓存中保存键值对的时间长度（以秒为单位， 表示永远）
bytes     在缓存中存储的字节点
value     存储的值（始终位于第二行）

现在，我们来看看这些命令的实际使用。

3.1 set
set 命令用于向缓存添加新的键值对。如果键已经存在，则之前的值将被替换。
注意以下交互，它使用了 set 命令：

set userId   

STORED

如果使用 set 命令正确设定了键值对，服务器将使用单词 STORED 进行响应。本示例向缓存中添加了一个键值对，其键为userId，其值为12345。并将过期时间设置为 0，这将向 memcached 通知您希望将此值存储在缓存中直到删除它为止。

3.2 add
仅当缓存中不存在键时，add 命令才会向缓存中添加一个键值对。如果缓存中已经存在键，则之前的值将仍然保持相同，并且您将获得响应 NOT_STORED。
下面是使用 add 命令的标准交互：

set userId   

STORED
add userId   

NOT_STORED
add companyId   

STORED

3.3 replace
仅当键已经存在时，replace 命令才会替换缓存中的键。如果缓存中不存在键，那么您将从 memcached 服务器接受到一条 NOT_STORED 响应。
下面是使用 replace 命令的标准交互：

replace accountId   

NOT_STORED
set accountId   

STORED
replace accountId   

STORED

最后两个基本命令是 get 和 delete。这些命令相当容易理解，并且使用了类似的语法，如下所示：

command <key>

接下来看这些命令的应用。

3.4 get
get 命令用于检索与之前添加的键值对相关的值。您将使用 get 执行大多数检索操作。
下面是使用 get 命令的典型交互：

set userId   

STORED
get userId
VALUE userId  

END
get bob
END

如您所见，get 命令相当简单。您使用一个键来调用 get，如果这个键存在于缓存中，则返回相应的值。如果不存在，则不返回任何内容。

3.5 delete
最后一个基本命令是 delete。delete 命令用于删除 memcached 中的任何现有值。您将使用一个键调用delete，如果该键存在于缓存中，则删除该值。如果不存在，则返回一条NOT_FOUND 消息。
下面是使用 delete 命令的客户机服务器交互：

set userId   

STORED
delete bob
NOT_FOUND
delete userId
DELETED
get userId
END

可以在 memcached 中使用的两个高级命令是 gets 和 cas。gets 和cas 命令需要结合使用。您将使用这两个命令来确保不会将现有的名称/值对设置为新值（如果该值已经更新过）。我们来分别看看这些命令。

3.6 gets
gets 命令的功能类似于基本的 get 命令。两个命令之间的差异在于，gets 返回的信息稍微多一些：64 位的整型值非常像名称/值对的 “版本” 标识符。
下面是使用 gets 命令的客户机服务器交互：

set userId   

STORED
get userId
VALUE userId  

END
gets userId
VALUE userId   

END

考虑 get 和 gets 命令之间的差异。gets 命令将返回一个额外的值 — 在本例中是整型值 4，用于标识名称/值对。如果对此名称/值对执行另一个set 命令，则gets 返回的额外值将会发生更改，以表明名称/值对已经被更新。显示了一个例子：

set userId   

STORED
gets userId
VALUE userId   

END

您看到 gets 返回的值了吗？它已经更新为 5。您每次修改名称/值对时，该值都会发生更改。

3.7 cas
cas（check 和 set）是一个非常便捷的 memcached 命令，用于设置名称/值对的值（如果该名称/值对在您上次执行 gets 后没有更新过）。它使用与 set 命令相类似的语法，但包括一个额外的值：gets 返回的额外值。
注意以下使用 cas 命令的交互：

set userId   

STORED
gets userId
VALUE userId   

END
cas userId    

STORED

如您所见，我使用额外的整型值 6 来调用 gets 命令，并且操作运行非常顺序。现在，我们来看看中的一系列命令：
使用旧版本指示符的 cas 命令

set userId   

STORED
gets userId
VALUE userId   

END
cas userId    

EXISTS

注意，我并未使用 gets 最近返回的整型值，并且 cas 命令返回 EXISTS 值以示失败。从本质上说，同时使用gets 和cas 命令可以防止您使用自上次读取后经过更新的名称/值对。

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

3.8 stats
stats 命令的功能正如其名：转储所连接的 memcached 实例的当前统计数据。在下例中，执行 stats 命令显示了关于当前 memcached 实例的信息：

STAT pid                              进程ID
STAT uptime                         服务器运行秒数
STAT time                        服务器当前unix时间戳
STAT version 1.4.                         服务器版本
STAT libevent 2.0.-stable
STAT pointer_size                        操作系统字大小(这台服务器是64位的)
STAT rusage_user 0.040000                  进程累计用户时间
STAT rusage_system 0.260000                进程累计系统时间
STAT curr_connections                    当前打开连接数
STAT total_connections                   曾打开的连接总数
STAT connection_structures               服务器分配的连接结构数
STAT reserved_fds
STAT cmd_get                             执行get命令总数
STAT cmd_set                             执行set命令总数
STAT cmd_flush                            指向flush_all命令总数
STAT get_hits                             get命中次数
STAT get_misses                          get未命中次数
STAT delete_misses                        delete未命中次数
STAT delete_hits                          delete命中次数
STAT incr_misses                          incr未命中次数
STAT incr_hits                            incr命中次数
STAT decr_misses                          decr未命中次数
STAT decr_hits                            decr命中次数
STAT cas_misses                           cas未命中次数
STAT cas_hits                             cas命中次数
STAT cas_badval                           使用擦拭次数
STAT touch_hits
STAT touch_misses
STAT auth_cmds
STAT auth_errors
STAT bytes_read                       读取字节总数
STAT bytes_written                    写入字节总数
STAT limit_maxbytes                分配的内存数（字节）
STAT accepting_conns                      目前接受的链接数
STAT listen_disabled_num
STAT time_in_listen_disabled_us
STAT threads                              线程数
STAT conn_yields
STAT hash_power_level
STAT hash_bytes
STAT hash_is_expanding
STAT malloc_fails
STAT conn_yields
STAT bytes                                存储item字节数
STAT curr_items                           item个数
STAT total_items                         item总数
STAT expired_unfetched
STAT evicted_unfetched
STAT evictions                            为获取空间删除item的总数
STAT reclaimed
STAT crawler_reclaimed
STAT crawler_items_checked
STAT lrutail_reflocked 

此处的大多数输出都非常容易理解。我们先来看看输出，然后再使用新的键来运行一些 set 命令，并再次运行stats 命令，注意发生了哪些变化。

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

STAT items::number
STAT items::age
STAT items::evicted
STAT items::evicted_nonzero
STAT items::evicted_time
STAT items::outofmemory
STAT items::tailrepairs
STAT items::reclaimed
STAT items::expired_unfetched
STAT items::evicted_unfetched
STAT items::crawler_reclaimed
STAT items::crawler_items_checked
STAT items::lrutail_reflocked
END

stats cachedump slabs_id limit_num
slabs_id:由stats items返回的结果（STAT items后面的数字）决定的
limit_num:返回的记录数，0表示返回所有记录
通过stats items、stats cachedump slab_id limit_num配合get命令可以遍历memcached的记录。

stats cachedump
ITEM userId [ b;  s]
ITEM accountId [ b;  s]
ITEM companyId [ b;  s]
END
stats cachedump
ITEM userId [ b;  s]
ITEM accountId [ b;  s]
END

stats slabs 显示各个slab的信息，包括chunk的大小、数目、使用情况等

STAT :chunk_size
STAT :chunks_per_page
STAT :total_pages
STAT :total_chunks
STAT :used_chunks
STAT :free_chunks
STAT :free_chunks_end
STAT :mem_requested
STAT :get_hits
STAT :cmd_set
STAT :delete_hits
STAT :incr_hits
STAT :decr_hits
STAT :cas_hits
STAT :cas_badval
STAT :touch_hits
STAT active_slabs
STAT total_malloced 

stats sizes 输出所有item的大小和个数

STAT  

stats reset 清空统计数据

stats reset
RESET

3.9 flush_all
flush_all 是最后一个要介绍的命令。这个最简单的命令仅用于清理缓存中的所有名称/值对。如果您需要将缓存重置到干净的状态，则 flush_all 能提供很大的用处。下面是一个使用 flush_all 的例子：

set userId   

STORED
get userId
VALUE userId  

END
flush_all
OK
get userId
END

追加与清除命令

3.10 append
append 将数据追加到当前缓存数据的之后，当缓存数据存在时才存储。

set username
wayne173
STORED
get username
VALUE username
wayne173
END
append username
_ages
STORED
get username
VALUE username
wayne173_ages
END

3.11 prepend
prepend 将数据追加到当前缓存数据的之前，当缓存数据存在时才存储。

set username
wayne173
STORED
get username
VALUE username
wayne173
END
prepend username
name_
STORED
get username
VALUE username
name_wayne173
END

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