memcached 经常使用命令及使用说明

时间 2019-11-08

原文原文链接

一、启动Memcache 经常使用参数linux

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

更多可使用者 memcached -h
在linux下：./usr/local/bin/memcached -d -u root  -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 Memcached_srv binpath= “d:\App_Serv\memcached\memcached.exe -d RunService -p 11211 -m 500″start= auto
net start Memcached

二、链接和退出windows

telnet 127.0.0.1 11211
quit

三、基本命令缓存

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

set
add
replace
get
delete

前三个命令是用于操做存储在 memcached 中的键值对的标准修改命令。它们都很是简单易用，且都使用以下所示的语法：服务器

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

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

如今，咱们来看看这些命令的实际使用。app

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

set userId 0 0 5
12345
STORED

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

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

set userId 0 0 5
12345
STORED
add userId 0 0 5
55555
NOT_STORED
add companyId 0 0 3
564
STORED

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

replace accountId 0 0 5
67890
NOT_STORED
set accountId 0 0 5
67890
STORED
replace accountId 0 0 5
55555
STORED

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

command <key>

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

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

set userId 0 0 5
12345
STORED
get userId
VALUE userId 0 5
12345
END
get bob
END

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

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

set userId 0 0 5
98765
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 0 0 5
12345
STORED
get userId
VALUE userId 0 5
12345
END
gets userId
VALUE userId 0 5 4
12345
END

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

set userId 0 0 5
33333
STORED
gets userId
VALUE userId 0 5 5
33333
END

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

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

set userId 0 0 5
55555
STORED
gets userId
VALUE userId 0 5 6
55555
END
cas userId 0 0 5 6
33333
STORED

如您所见，我使用额外的整型值 6 来调用 gets 命令，而且操做运行很是顺序。如今，咱们来看看中的一系列命令：
使用旧版本指示符的 cas 命令

set userId 0 0 5
55555
STORED
gets userId
VALUE userId 0 5 8
55555
END
cas userId 0 0 5 6
33333
EXISTS

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

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

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

STAT pid 22459                             进程ID
STAT uptime 1027046                        服务器运行秒数
STAT time 1273043062                       服务器当前unix时间戳
STAT version 1.4.4                         服务器版本
STAT libevent 2.0.21-stable
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 reserved_fds 20
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 touch_hits 0
STAT touch_misses 0
STAT auth_cmds 0
STAT auth_errors 0
STAT bytes_read 15785                      读取字节总数
STAT bytes_written 15222                   写入字节总数
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 malloc_fails 0
STAT conn_yields 0
STAT bytes 0                               存储item字节数
STAT curr_items 0                          item个数
STAT total_items 34                        item总数
STAT expired_unfetched 0
STAT evicted_unfetched 0
STAT evictions 0                           为获取空间删除item的总数
STAT reclaimed 0
STAT crawler_reclaimed 0
STAT crawler_items_checked 0
STAT lrutail_reflocked 0

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

stats items
执行stats items，能够看到STAT items行，若是memcached存储内容不少，那么这里也会列出不少的STAT items行。

STAT items:1:number 3
STAT items:1:age 1698
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
STAT items:1:crawler_reclaimed 0
STAT items:1:crawler_items_checked 0
STAT items:1:lrutail_reflocked 0
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 1 0
ITEM userId [5 b; 1467903379 s]
ITEM accountId [5 b; 1467903379 s]
ITEM companyId [3 b; 1467903379 s]
END
stats cachedump 1 2
ITEM userId [5 b; 1467903379 s]
ITEM accountId [5 b; 1467903379 s]
END

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

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 3
STAT 1:free_chunks 10919
STAT 1:free_chunks_end 0
STAT 1:mem_requested 232
STAT 1:get_hits 9
STAT 1:cmd_set 14
STAT 1:delete_hits 1
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

stats sizes 输出全部item的大小和个数

STAT 96 3

stats reset 清空统计数据

stats reset
RESET

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

set userId 0 0 5
55555
STORED
get userId
VALUE userId 0 5
55555
END
flush_all
OK
get userId
END

追加与清除命令

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

set username 0 0 8
wayne173
STORED
get username
VALUE username 0 8
wayne173
END
append username 0 0 5
_ages
STORED
get username
VALUE username 0 13
wayne173_ages
END

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

set username 0 0 8
wayne173
STORED
get username
VALUE username 0 8
wayne173
END
prepend username 0 0 5
name_
STORED
get username
VALUE username 0 13
name_wayne173
END

memcached还有不少命令，好比对于存储为数字型的能够经过incr/decr命令进行增减操做等等，这里只列出开发和运维中常用的命令，其余的再也不一一举例说明。