Memcached 内存缓存命令行参数说明

Question

Memcached 是一个高性能的分布式内存对象缓存系统，用于动态Web应用以减轻数据库负载。它通过在内存中缓存数据和对象来减少读取数据库的次数，从而提高动态、数据库驱动网站的速度。

启动 Memcache 常用参数

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

不同平台有不同的使用方法

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

连接 Memcache

连接 Memcached 不需要任何的用户名和密码，所有我们在安装的时候就需要设置只允许本地应用访问，不允许外网访问，可以通过安全策略或者安全软件设置。

telnet 127.0.0.1 11211

使用基本命令

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

• set
• add
• replace
• get
• delete

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

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

下表中定义了 Memcached 修改命令的参数和用法。

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

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

set

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

注意以下交互，它使用了 set 命令：

set userId 0 0 5
12345
STORED

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

add

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

下面是使用 add 命令的标准交互：

set userId 0 0 5
12345
STORED

add userId 0 0 5
55555
NOT_STORED

add companyId 0 0 3
564
STORED

replace

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

下面是使用 replace 命令的标准交互：

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>

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

get

get 命令用于检索与之前添加的键值对相关的值。您将使用 get 执行大多数检索操作。

下面是使用 get 命令的典型交互：

set userId 0 0 5
12345
STORED

get userId
VALUE userId 0 5
12345
END

get bob
END

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

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 命令需要结合使用。您将使用这两个命令来确保不会将现有的名称/值对设置为新值（如果该值已经更新过）。我们来分别看看这些命令。

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 返回的额外值将会发生更改，以表明名称/值对已经被更新。清单 6 显示了一个例子：

set 更新版本指示符

set userId 0 0 5
33333
STORED

gets userId
VALUE userId 0 5 5
33333
END

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

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 命令，并且操作运行非常顺序。现在，我们来看看清单 7 中的一系列命令：

使用旧版本指示符的 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 命令。

stats

stats 命令的功能正如其名：转储所连接的 memcached 实例的当前统计数据。在下例中，执行 stats 命令显示了关于当前 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的总数

此处的大多数输出都非常容易理解。稍后在讨论缓存性能时，我还将详细解释这些值的含义。至于目前，我们先来看看输出，然后再使用新的键来运行一些 set 命令，并再次运行stats 命令，注意发生了哪些变化。

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