Memcached常用指令

港控/mmm° 2023-05-29 09:15 20阅读 0赞

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

> 主要的三个存储数据的指令分别是：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指令使用示例 ####

[root@memcache1 ~]# 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

--------------------

> 实例如下：  
> • 首先我们在 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

实例如下：  
• 首先我们在 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 <− 缺少 token
>     cas tp 0 900 9 2
>     memcached
>     NOT_FOUND <− 键 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

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\]  
**实例**  
**清理缓存:**