Memcached常用指令

86251043 2019-10-31

一、常用的存储数据的三个指令

主要的三个存储数据的指令分别是:set、add、replace。

  • set指令:是直接保存到一个叫做key的数据到服务器上(不管这个数据是否存在);
  • add指令:是添加一个数据到memcached,如果这个key已存在,则不进行添加,若不存在,则执行添加;
  • replace指令:也是添加一个数据到memcached,但其与add指令相反,如果这个key存在,那么就修改其key值,如果不存在,则返回错误,不进行任何操作。

上述三个指令的语法格式都是一样的,只是指令不一样而已,其指令的语法格式如下:

<命令> <键> <标记> <有效期> <数据长度>

在上述的语法格式中,解释如下:

  • <命令>:就是add、set、replace等指令;
  • <键> - key:就是保存在服务器上唯一的一个标识符,不可以与其他的key冲突,否则会覆盖掉原来的数据(使用set命令的话),这个key是为了能够准确的存取一个数据项目;
  • <标记> - flag:标记的是一个16位的无符号整型数据,用来设置服务器跟客户端一些交互的操作;
  • <有效期> -expiration time:是数据在服务器上的有效期限,如果是0,则数据永远有效,单位是秒,Memcached服务端会把一个数据的有效期设置为当前Unix时间+设置的有效时间;
  • <数据长度> - bytes:数据的长度,block data数据块的长度,一般这这个长度结束后下一行跟着block data数据内容,发送完数据以后,客户端一般等待服务器端的返回;

1、set指令使用示例

[ ~]# telnet 192.168.20.4 11211   #连接到memcached数据库
set lv 0 0  3    3       #插入一个数据
aaa              #插入的数据为aaa
STORED             #返回“STORED”则表示插入成功
get lv                  #查询插入的数据
VALUE lv 0 3          
aaa
END
set lv 0 0 4          #修改“lv”这个key的值为bbbb
bbbb
STORED
get lv          #再次查看,确定更改成功
VALUE lv 0 4
bbbb

2、add指令使用示例

以下实例中我们设置:
? key → new_key
? flag → 0
? exptime → 900 (以秒为单位)
? bytes → 10 (数据存储的字节数)
? value → data_value

add new_key 0 900 10
data_value
STORED
get new_key
VALUE new_key 0 10
data_value
END

输出
如果数据添加成功,则输出:
STORED

输出信息说明:
? STORED:保存成功后输出。
? NOT_STORED :在保持失败后输出。

3、replace 命令

Memcached replace 命令用于替换已存在的 key( 键) ) 的 value( 数据值) )。
如果 key 不存在,则替换失败,并且将获得响应 NOT_STORED。

replace 命令的基本语法格式如下:
replace key flags exptime bytes [noreply] value

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
? flags:可以包括键值对的整型参数,客户机使用它存储关于键值对的额外信息 。
? exptime:在缓存中保存键值对的时间长度(以秒为单位,0 表示永远)
? bytes:在缓存中存储的字节数
? noreply(可选): 该参数告知服务器不需要返回数据
? value:存储的值(始终位于第二行)(可直接理解为 key-value 结构中的 value)

使用实例

以下实例中将设置:
? key → mykey
? flag → 0
? exptime → 900 (以秒为单位)
? bytes → 10 (数据存储的字节数)
? value → data_value

以下实例中我们使用的键位 ‘mykey‘ 并存储对应的值 data_value。执行后我们替换相同的 key 的值为‘some_other_value‘。

add mykey 0 900 10
data_value
STORED
get mykey
VALUE mykey 0 10
data_value
END
replace mykey 0 900 16
some_other_value
get mykey
VALUE mykey 0 16
some_other_value
END

如果数据添加成功,则输出:
STORED
输出信息说明:
? STORED:保存成功后输出。
? NOT_STORED:执行替换失败后输出。

4、append 命令

append 命令用于向已存在 key( 键) ) 的 value( 数据值) ) 后面追加数据 。

语法:

append 命令的基本语法格式如下:
append key flags exptime bytes [noreply] value

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
? flags:可以包括键值对的整型参数,客户机使用它存储关于键值对的额外信息 。
? exptime:在缓存中保存键值对的时间长度(以秒为单位,0 表示永远)
? bytes:在缓存中存储的字节数
? noreply(可选): 该参数告知服务器不需要返回数据
? value:存储的值(始终位于第二行)(可直接理解为 key-value 结构中的 value)


实例如下:
? 首先我们在 Memcached 中存储一个键 runoob,其值为 memcached。
? 然后,我们使用 get 命令检索该值。
? 然后,我们使用 append 命令在键为 runoob 的值后面追加 "redis"。
? 最后,我们再使用 get 命令检索该值。

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END
append runoob 0 900 5
redis
STORED
get runoob
VALUE runoob 0 14
memcachedredis
END

输出
如果数据添加成功,则输出:
STORED

输出信息说明:
? STORED:保存成功后输出。
? NOT_STORED:该键在 Memcached 上不存在。
? CLIENT_ERROR:执行错误。

5、prepend 命令

prepend 命令用于向已存在 key( 键) ) 的 value( 数据值) ) 前面追加数据 ,与append正好相反。

语法:

prepend 命令的基本语法格式如下:
prepend key flags exptime bytes [noreply] value

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
? flags:可以包括键值对的整型参数,客户机使用它存储关于键值对的额外信息 。
? exptime:在缓存中保存键值对的时间长度(以秒为单位,0 表示永远)
? bytes:在缓存中存储的字节数
? noreply(可选): 该参数告知服务器不需要返回数据
? value:存储的值(始终位于第二行)(可直接理解为 key-value 结构中的 value)

实例如下:
? 首先我们在 Memcached 中存储一个键 runoob,其值为 memcached。
? 然后,我们使用 get 命令检索该值。
? 然后,我们使用 prepend 命令在键为 runoob 的值后面追加 "redis"。
? 最后,我们再使用 get 命令检索该值。

set runoob 0 900 9

> memcached
> STORED
> get runoob
> VALUE runoob 0 14
> memcached
> END
> prepend runoob 0 900 5
> redis
> STORED
> get runoob
> VALUE runoob 0 14
> redismemcached
END

如果数据添加成功,则输出:
STORED
输出信息说明:
? STORED:保存成功后输出。
? NOT_STORED:该键在 Memcached 上不存在。
? CLIENT_ERROR:执行错误。

6、cas命令

CAS(Check-And-Set 或 Compare-And-Swap) 命令用于执行一个"检查并设置"的操作它仅在当前客户端最后一次取值后,该 key 对应的值没有被其他客户端修改的情况下, 才能够将值写入。检查是通过 cas_token 参数进行的, 这个参数是 Memcach 指定给已经存在的元素的一个唯一的 64 位值。

CAS 命令的基本语法格式如下:
cas key flags exptime bytes unique_cas_token [noreply] value

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
? flags:可以包括键值对的整型参数,客户机使用它存储关于键值对的额外信息 。
? exptime:在缓存中保存键值对的时间长度(以秒为单位,0 表示永远)
? bytes:在缓存中存储的字节数
? unique_cas_token 通过 gets 命令获取的一个唯一的 64 位值。
? noreply(可选): 该参数告知服务器不需要返回数据
? value:存储的值(始终位于第二行)(可直接理解为 key-value 结构中的 value)

要在 Memcached 上使用 CAS 命令,需要从 Memcached 服务商通过 gets 命令获取令牌(token)。
gets 命令的功能类似于基本的 get 命令。两个命令之间的差异在于,gets 返回的信息稍微多一些:64 位的整型值非常像名称/值对的 "版本" 标识符。

实例步骤如下:
? 如果没有设置唯一令牌,则 CAS 命令执行错误。
? 如果键 key 不存在,执行失败。
? 添加键值对。
? 通过 gets 命令获取唯一令牌。
? 使用 cas 命令更新数据
? 使用 get 命令查看数据是否更新

cas tp 0 900 9
ERROR &lt;? 缺少 token
cas tp 0 900 9 2
memcached
NOT_FOUND &lt;? 键 tp 不存在
set tp 0 900 9
memcached
STORED
gets tp
VALUE tp 0 9 1
memcached
END
cas tp 0 900 5 1
redis
STORED
get tp
VALUE tp 0 5
redis
END

输出
如果数据添加成功,则输出:
STORED
输出信息说明:
? STORED:保存成功后输出。
? ERROR:保存出错或语法错误。
? EXISTS:在最后一次取值后另外一个用户也在更新该数据。
? NOT_FOUND:Memcached 服务上不存在该键值。

二、常用的查找命令

1、 get命令

get 命令获取存储在 key( 键) ) 中的 value( 数据值) ) ,如果 key 不存在,则返回空。

get 命令的基本语法格式如下:
get key

多个 key 使用空格隔开,如下:
get key1 key2 key3

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
实例
在以下实例中,我们使用 runoob 作为 key,过期时间设置为 900 秒。

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END

2、 gets 命令

gets 命令获取带有 CAS 令牌存 的 value( 数据值) ) ,如果 key 不存在,则返回空。

gets 命令的基本语法格式如下:
gets key
多个 key 使用空格隔开,如下:
gets key1 key2 key3

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
实例
在以下实例中,我们使用 runoob 作为 key,过期时间设置为 900 秒。

set runoob 0 900 9
memcached
STORED
gets runoob
VALUE runoob 0 9 1
memcached
END

在 使用 gets 命令的输出结果中,在最后一列的数字 1 代表了 key 为 runoob 的 CAS 令牌。

3、delete 命令

delete 命令用于删除已存在的 key(键)。

delete 命令的基本语法格式如下:
delete key [noreply]

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
? noreply(可选): 该参数告知服务器不需要返回数据

实例
在以下实例中,我们使用 runoob 作为 key,过期时间设置为 900 秒。之后我们使用 delete 命令删除该 key。

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END
delete runoob
DELETED
get runoob
END
delete runoob
NOT_FOUND

输出信息说明:
? DELETED:删除成功。
? ERROR:语法错误或删除失败。
? NOT_FOUND:key 不存在。

4、 incr 与 decr 命令

incr 与 decr 命令用于对已存在的 key(键) 的数字值进行自增或自减操作。
incr 与 decr 命令操作的数据必须是十进制的 32 位无符号整数。
如果 key 不存在返回 NOT_FOUND,如果键的值不为数字,则返回 CLIENT_ERROR,其他错误返回 ERROR。
incr 命令

incr 命令的基本语法格式如下:
incr key increment_value

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
? increment_value: 增加的数值。
实例
在以下实例中,我们使用 visitors 作为 key,初始值为 10,之后进行加 5 操作。

set visitors 0 900 2
10
STORED
get visitors
VALUE visitors 0 2
10
END
incr visitors 5
15
get visitors
VALUE visitors 0 2
15
END

输出信息说明:
? NOT_FOUND:key 不存在。
? CLIENT_ERROR:自增值不是对象。
? ERROR 其他错误,如语法错误等。

decr 命令的基本语法格式如下:
decr key decrement_value

参数说明如下:
? key:键值 key-value 结构中的 key,用于查找缓存值。
? decrement_value: 减少的数值。
实例

set visitors 0 900 2
10
STORED
get visitors
VALUE visitors 0 2
10
END
decr visitors 5
5
get visitors
VALUE
visitors 0 1
5
END

输出信息说明:
? NOT_FOUND:key 不存在。
? CLIENT_ERROR:自增值不是对象。
? ERROR 其他错误,如语法错误等。

5、 stats 命令

stats 命令用于返回统计信息例如 PID(进程号)、版本号、连接数等。

stats 命令的基本语法格式如下:
stats
实例
在以下实例中,我们使用了 stats 命令来输出 Memcached 服务信息。
stats

这里显示了很多状态信息,下边详细解释每个状态项:
? pid: memcache 服务器进程 ID
? uptime:服务器已运行秒数
? time:服务器当前 Unix 时间戳
? version:memcache 版本
? pointer_size:操作系统指针大小
? rusage_user:进程累计用户时间
? rusage_system:进程累计系统时间
? curr_connections:当前连接数量
? total_connections:Memcached 运行以来连接总数
? connection_structures:Memcached 分配的连接结构数量
? cmd_get:get 命令请求次数
? cmd_set:set 命令请求次数
? cmd_flush:flush 命令请求次数
? get_hits:get 命令命中次数
? get_misses:get 命令未命中次数
? delete_misses:delete 命令未命中次数
? delete_hits:delete 命令命中次数
? incr_misses:incr 命令未命中次数
? incr_hits:incr 命令命中次数
? decr_misses:decr 命令未命中次数
? decr_hits:decr 命令命中次数
? cas_misses:cas 命令未命中次数
? cas_hits:cas 命令命中次数
? cas_badval:使用擦拭次数
? auth_cmds:认证命令处理的次数
? auth_errors:认证失败数目
? bytes_read:读取总字节数
? bytes_written:发送总字节数
? limit_maxbytes:分配的内存总大小(字节)
? accepting_conns:服务器是否达到过最大连接(0/1)
? listen_disabled_num:失效的监听数
? threads:当前线程数
? conn_yields:连接操作主动放弃数目
? bytes:当前存储占用的字节数
? curr_items:当前存储的数据总数
? total_items:启动以来存储的数据总数
? evictions:LRU 释放的对象数目
? reclaimed:已过期的数据条目来存储新数据的数目

6、stats items 命令

stats items 命令用于显示各个 slab 中 item 的数目和存储时长(最后一次访问距离现在的秒数)。

stats items 命令的基本语法格式如下:
stats items

7、stats slabs 命令

stats slabs 命令用于显示各个 slab 的信息,包括 chunk 的大小、数目、使用情况等。

stats slabs 命令的基本语法格式如下:
stats slabs

8、 stats sizes 命令

Memcached stats sizes 命令用于显示所有 item 的大小和个数。
该信息返回两列,第一列是 item 的大小,第二列是 item 的个数。

stats sizes 命令的基本语法格式如下:
stats sizes
实例
stats sizes STAT 96 1 END

9、 flush_all 命令

flush_all 命令用于用于清理缓存中的所有 key=>value( 键 => 值) ) 对。
该命令提供了一个可选参数 time,用于在指定的时间后执行清理缓存操作。

flush_all 命令的基本语法格式如下:
flush_all [time] [noreply]
实例
清理缓存:

set runoob 0 900 9
memcached
STORED
get runoob
VALUE runoob 0 9
memcached
END
flush_all
OK
get runoob
END

———————— 本文至此结束,感谢阅读 ————————

相关推荐