Redis 命令行界面

redis-cli概述，Redis命令行界面

在交互模式下，redis-cli 具有基本的行编辑功能，以提供熟悉的打字体验。

要以特殊模式启动程序，您可以使用几个选项，包括：

模拟一个副本并打印它从主节点接收到的复制流。
检查Redis服务器的延迟并显示统计信息。
请求延迟样本和频率的ASCII艺术频谱图。

本主题涵盖了redis-cli的不同方面，从最简单的开始，到更高级的功能结束。

命令行用法

要在终端运行Redis命令并返回标准输出，请将要执行的命令作为redis-cli的单独参数包含：

$ redis-cli INCR mycounter
(integer) 7

命令的回复是“7”。由于Redis的回复是有类型的（字符串、数组、整数、空值、错误等），你可以在括号中看到回复的类型。当redis-cli的输出必须用作另一个命令的输入或重定向到文件时，这些额外的信息可能并不理想。

redis-cli 仅在检测到标准输出是终端时，才会显示额外的信息以提高人类可读性。对于所有其他输出，它将自动启用原始输出模式，如下例所示：

$ redis-cli INCR mycounter > /tmp/output.txt
$ cat /tmp/output.txt
8

请注意，(integer) 从输出中省略了，因为 redis-cli 检测到输出不再写入终端。你可以使用 --raw 选项强制在终端上显示原始输出：

$ redis-cli --raw INCR mycounter
9

你可以通过在写入文件或通过管道传输到其他命令时使用--no-raw来强制输出人类可读的格式。

字符串引用和转义

当redis-cli解析命令时，空白字符会自动分隔参数。在交互模式下，换行符会发送命令进行解析和执行。要输入包含空白字符或不可打印字符的字符串值，可以使用引号和转义字符串。

引用的字符串值用双引号（"）或单引号（'）括起来。转义序列用于在字符和字符串字面量中插入不可打印的字符。

转义序列包含一个反斜杠（\）符号，后跟一个转义序列字符。

双引号字符串支持以下转义序列：

\" - 双引号
\n - 换行
\r - 回车
\t - 水平制表符
\b - 退格键
\a - 警报
\\ - 反斜杠
\xhh - 由十六进制数（hh）表示的任何ASCII字符

单引号假定字符串是字面量，并且只允许以下转义序列：

\' - 单引号
\\ - 反斜杠

例如，要在两行上返回 Hello World：

127.0.0.1:6379> SET mykey "Hello\nWorld"
OK
127.0.0.1:6379> GET mykey
Hello
World

当你输入的字符串包含单引号或双引号时，例如在密码中，需要对字符串进行转义，如下所示：

127.0.0.1:6379> AUTH some_admin_user ">^8T>6Na{u|jp>+v\"55\@_;OU(OR]7mbAYGqsfyu48(j'%hQH7;v*f1H${*gD(Se'"

主机、端口、密码和数据库

默认情况下，redis-cli 连接到地址为 127.0.0.1 的服务器，端口为 6379。您可以使用多个命令行选项来更改端口。要指定不同的主机名或IP地址，请使用 -h 选项。为了设置不同的端口，请使用 -p。

$ redis-cli -h redis15.localnet.org -p 6390 PING
PONG

如果您的实例受密码保护，-a 选项将执行身份验证，从而无需显式使用 AUTH 命令：

$ redis-cli -a myUnguessablePazzzzzword123 PING
PONG

注意：出于安全原因，请通过REDISCLI_AUTH环境变量自动向redis-cli提供密码。

最后，可以通过使用-n 选项发送一个命令来操作默认编号为零以外的数据库编号：

$ redis-cli FLUSHALL
OK
$ redis-cli -n 1 INCR a
(integer) 1
$ redis-cli -n 1 INCR a
(integer) 2
$ redis-cli -n 2 INCR a
(integer) 1

部分或全部信息也可以通过使用-u 选项和URI模式redis://user:password@host:port/dbnum来提供：

$ redis-cli -u redis://LJenkins:p%40ssw0rd@redis-16379.hosted.com:16379/0 PING
PONG

注意： 用户、密码和dbnum是可选的。对于没有用户名的认证，使用用户名default。对于TLS，使用方案rediss。

你可以使用-4或-6参数来分别设置DNS查询时优先使用IPv4或IPv6。

SSL/TLS

默认情况下，redis-cli 使用普通的 TCP 连接来连接到 Redis。你可以使用 --tls 选项启用 SSL/TLS，同时使用 --cacert 或 --cacertdir 来配置受信任的根证书包或目录。

如果目标服务器需要使用客户端证书进行身份验证，您可以使用--cert和--key指定证书和相应的私钥。

从其他程序获取输入

有两种方式可以使用redis-cli来接收来自其他命令的输入通过标准输入。一种是将目标负载作为stdin的最后一个参数。例如，为了将Redis键net_services设置为本地文件系统中/etc/services文件的内容，使用-x选项：

$ redis-cli -x SET net_services < /etc/services
OK
$ redis-cli GETRANGE net_services 0 50
"#\n# Network services, Internet style\n#\n# Note that "

在上述会话的第一行中，redis-cli 使用了 -x 选项执行，并将一个文件重定向到 CLI 的标准输入，作为满足 SET net_services 命令短语的值。这对于脚本编写非常有用。

另一种方法是将写在文本文件中的一系列命令输入到redis-cli中：

$ cat /tmp/commands.txt
SET item:3374 100
INCR item:3374
APPEND item:3374 xxx
GET item:3374
$ cat /tmp/commands.txt | redis-cli
OK
(integer) 101
(integer) 6
"101xxx"

commands.txt 中的所有命令都会由 redis-cli 连续执行，就像用户在交互模式下输入的一样。如果需要，可以在文件中引用字符串，以便能够包含带有空格、换行符或其他特殊字符的单个参数：

$ cat /tmp/commands.txt
SET arg_example "This is a single argument"
STRLEN arg_example
$ cat /tmp/commands.txt | redis-cli
OK
(integer) 25

持续运行相同的命令

可以执行一个指定次数的单一命令，并在每次执行之间由用户选择暂停时间。这在不同的上下文中非常有用——例如，当我们想要持续监控某些关键内容或INFO字段输出时，或者当我们想要模拟一些重复的写入事件时，比如每5秒向列表中添加一个新项目。

此功能由两个选项控制：-r 和 -i 。 -r 选项表示运行命令的次数，而 -i 设置不同命令调用之间的延迟（以秒为单位，可以指定如 0.1 表示 100 毫秒的值）。

默认情况下，间隔（或延迟）设置为0，因此命令会尽快执行：

$ redis-cli -r 5 INCR counter_value
(integer) 1
(integer) 2
(integer) 3
(integer) 4
(integer) 5

要无限期地运行相同的命令，请使用-1作为计数值。要随时间监控RSS内存大小，可以使用以下命令：

$ redis-cli -r -1 -i 1 INFO | grep rss_human
used_memory_rss_human:2.71M
used_memory_rss_human:2.73M
used_memory_rss_human:2.73M
used_memory_rss_human:2.73M
... a new line will be printed each second ...

使用`redis-cli`进行数据的大规模插入

使用redis-cli进行批量插入的内容在单独的页面中介绍，因为它本身就是一个值得讨论的话题。请参考我们的批量插入指南。

CSV 输出

在redis-cli中存在一个CSV（逗号分隔值）输出功能，用于将数据从Redis导出到外部程序。

$ redis-cli LPUSH mylist a b c d
(integer) 4
$ redis-cli --csv LRANGE mylist 0 -1
"d","c","b","a"

请注意，--csv 标志仅适用于单个命令，而不是整个数据库的导出。

运行Lua脚本

redis-cli 对使用 Lua 脚本的调试功能有广泛的支持，该功能自 Redis 3.2 起可用。有关此功能的详细信息，请参阅 Redis Lua 调试器文档。

即使不使用调试器，redis-cli 也可以用来从文件中运行脚本作为参数：

$ cat /tmp/script.lua
return redis.call('SET',KEYS[1],ARGV[1])
$ redis-cli --eval /tmp/script.lua location:hastings:temp , 23
OK

Redis 的 EVAL 命令将脚本使用的键列表和其他非键参数作为不同的数组。在调用 EVAL 时，您需要提供键的数量作为一个数字。

当使用上述的--eval选项调用redis-cli时，不需要显式指定键的数量。相反，它使用逗号分隔键和参数的约定。这就是为什么在上面的调用中，你会看到location:hastings:temp , 23作为参数。

因此，location:hastings:temp 将填充 KEYS 数组，而 23 将填充 ARGV 数组。

在编写简单脚本时，--eval 选项非常有用。对于更复杂的工作，推荐使用 Lua 调试器。可以混合使用这两种方法，因为调试器也可以执行外部文件中的脚本。

交互模式

我们已经探讨了如何将Redis CLI用作命令行程序。这对于脚本和某些类型的测试非常有用，然而大多数人会在redis-cli的交互模式下花费大部分时间。

在交互模式下，用户在提示符处输入Redis命令。该命令被发送到服务器，经过处理，然后将回复解析并以更简单的形式呈现以便阅读。

在交互模式下运行redis-cli不需要任何特殊操作 - 只需在没有参数的情况下执行它即可

$ redis-cli
127.0.0.1:6379> PING
PONG

字符串 127.0.0.1:6379> 是提示符。它显示连接的 Redis 服务器实例的主机名和端口。

当连接的服务器发生变化或操作不同于数据库编号为零的数据库时，提示会更新：

127.0.0.1:6379> SELECT 2
OK
127.0.0.1:6379[2]> DBSIZE
(integer) 1
127.0.0.1:6379[2]> SELECT 0
OK
127.0.0.1:6379> DBSIZE
(integer) 503

处理连接和重新连接

在交互模式下使用CONNECT命令可以通过指定我们想要连接的主机名和端口来连接到不同的实例：

127.0.0.1:6379> CONNECT metal 6379
metal:6379> PING
PONG

如你所见，当连接到不同的服务器实例时，提示符会相应地改变。如果尝试连接到一个无法访问的实例，redis-cli 将进入断开连接模式，并在每次新命令时尝试重新连接：

127.0.0.1:6379> CONNECT 127.0.0.1 9999
Could not connect to Redis at 127.0.0.1:9999: Connection refused
not connected> PING
Could not connect to Redis at 127.0.0.1:9999: Connection refused
not connected> PING
Could not connect to Redis at 127.0.0.1:9999: Connection refused

通常在检测到断开连接后，redis-cli 总是尝试透明地重新连接；如果尝试失败，它会显示错误并进入断开连接状态。以下是断开连接和重新连接的示例：

127.0.0.1:6379> INFO SERVER
Could not connect to Redis at 127.0.0.1:6379: Connection refused
not connected> PING
PONG
127.0.0.1:6379> 
(now we are connected again)

当执行重新连接时，redis-cli 会自动重新选择上次选择的数据库编号。然而，连接的所有其他状态都会丢失，例如在 MULTI/EXEC 事务中：

$ redis-cli
127.0.0.1:6379> MULTI
OK
127.0.0.1:6379> PING
QUEUED

( here the server is manually restarted )

127.0.0.1:6379> EXEC
(error) ERR EXEC without MULTI

在使用redis-cli进行交互模式测试时，这通常不是问题，但应该了解这一限制。

使用-t 选项以秒为单位指定服务器超时。

编辑、历史、补全和提示

因为 redis-cli 使用了 linenoise 行编辑库，它始终具备行编辑功能，而不依赖于 libreadline 或其他可选库。

为了避免重新输入命令，可以通过按箭头键（上键和下键）来访问命令执行历史。历史记录在CLI重启之间会被保留，保存在用户主目录下的一个名为.rediscli_history的文件中，该目录由HOME环境变量指定。可以通过设置REDISCLI_HISTFILE环境变量来使用不同的历史文件名，并通过将其设置为/dev/null来禁用历史记录。

redis-cli 客户端也能够通过按下 TAB 键来执行命令名称的自动补全，如下例所示：

127.0.0.1:6379> Z<TAB>
127.0.0.1:6379> ZADD<TAB>
127.0.0.1:6379> ZCARD<TAB>

一旦在提示符下输入了Redis命令名称，redis-cli将显示语法提示。与命令历史记录一样，可以通过redis-cli的首选项来开启或关闭此行为。

支持反向历史搜索，例如终端中的CTRL-R。

偏好设置

有两种方法可以自定义redis-cli的行为。主目录中的.redisclirc文件在CLI启动时会被加载。你可以通过设置REDISCLI_RCFILE环境变量为替代路径来覆盖文件的默认位置。也可以在CLI会话期间设置首选项，在这种情况下，它们只会持续到会话结束。

要设置偏好，请使用特殊的:set命令。可以通过在CLI中输入命令或将其添加到.redisclirc文件来设置以下偏好：

:set hints - 启用语法提示
:set nohints - 禁用语法提示

运行相同的命令N次

可以通过在命令名称前加上数字来在交互模式下多次运行相同的命令：

127.0.0.1:6379> 5 INCR mycounter
(integer) 1
(integer) 2
(integer) 3
(integer) 4
(integer) 5

显示Redis命令的在线帮助

redis-cli 为大多数 Redis 命令提供在线帮助，使用 HELP 命令。该命令可以以两种形式使用：

HELP @ 显示关于给定类别的所有命令。类别包括：
- @generic
- @string
- @list
- @set
- @sorted_set
- @hash
- @pubsub
- @transactions
- @connection
- @server
- @scripting
- @hyperloglog
- @cluster
- @geo
- @stream
HELP 显示给定命令的具体帮助信息。

例如，为了显示PFADD命令的帮助，请使用：

127.0.0.1:6379> HELP PFADD

PFADD key element [element ...]
summary: Adds the specified elements to the specified HyperLogLog.
since: 2.8.9

请注意，HELP 也支持 TAB 补全。

清除终端屏幕

在交互模式下使用CLEAR命令可以清除终端的屏幕。

特殊操作模式

到目前为止，我们已经看到了redis-cli的两种主要模式。

Redis命令的命令行执行。
交互式 "REPL" 使用。

CLI 执行与 Redis 相关的其他辅助任务，这些任务将在接下来的章节中解释：

监控工具，用于显示关于Redis服务器的连续统计信息。
扫描Redis数据库以查找非常大的键。
带有模式匹配的键空间扫描器。
作为Pub/Sub客户端订阅频道。
监控在Redis实例中执行的命令。
以不同方式检查Redis服务器的延迟。
检查本地计算机的调度程序延迟。
将RDB备份从远程Redis服务器传输到本地。
作为Redis副本，用于显示副本接收到的内容。
模拟LRU工作负载以显示关于键命中的统计信息。
Lua调试器的客户端。

连续统计模式

连续统计模式可能是redis-cli中一个较少为人所知但非常有用的功能，用于实时监控Redis实例。要启用此模式，需使用--stat选项。输出非常清晰地展示了CLI在此模式下的行为：

$ redis-cli --stat
------- data ------ --------------------- load -------------------- - child -
keys       mem      clients blocked requests            connections
506        1015.00K 1       0       24 (+0)             7
506        1015.00K 1       0       25 (+1)             7
506        3.40M    51      0       60461 (+60436)      57
506        3.40M    51      0       146425 (+85964)     107
507        3.40M    51      0       233844 (+87419)     157
507        3.40M    51      0       321715 (+87871)     207
508        3.40M    51      0       408642 (+86927)     257
508        3.40M    51      0       497038 (+88396)     257

在此模式下，每秒都会打印一行包含有用信息和旧数据点之间请求值差异的新行。通过这个辅助的redis-cli工具，可以轻松理解内存使用情况、客户端连接计数以及关于连接的Redis数据库的各种其他统计信息。

在这种情况下，-i 选项作为修饰符，用于改变新行发出的频率。默认值为一秒。

扫描大键和内存使用情况

大键

在这种特殊模式下，redis-cli 作为一个键空间分析器工作。它扫描数据集以查找大键，同时也提供关于数据集组成的数据类型的信息。此模式通过 --bigkeys 选项启用，并产生详细的输出：

$ redis-cli --bigkeys

# Scanning the entire keyspace to find biggest keys as well as
# average sizes per key type.  You can use -i 0.01 to sleep 0.01 sec
# per SCAN command (not usually needed).

[00.00%] Biggest string found so far 'key-419' with 3 bytes
[05.14%] Biggest list   found so far 'mylist' with 100004 items
[35.77%] Biggest string found so far 'counter:__rand_int__' with 6 bytes
[73.91%] Biggest hash   found so far 'myobject' with 3 fields

-------- summary -------

Sampled 506 keys in the keyspace!
Total key length in bytes is 3452 (avg len 6.82)

Biggest string found 'counter:__rand_int__' has 6 bytes
Biggest   list found 'mylist' has 100004 items
Biggest   hash found 'myobject' has 3 fields

504 strings with 1403 bytes (99.60% of keys, avg size 2.78)
1 lists with 100004 items (00.20% of keys, avg size 100004.00)
0 sets with 0 members (00.00% of keys, avg size 0.00)
1 hashs with 3 fields (00.20% of keys, avg size 3.00)
0 zsets with 0 members (00.00% of keys, avg size 0.00)

在输出的第一部分，每个遇到的新键（比之前遇到的同类型键更大）都会被报告。摘要部分提供了关于Redis实例内部数据的一般统计信息。

该程序使用SCAN命令，因此可以在不影响操作的情况下在繁忙的服务器上执行，但是可以使用-i选项来限制每次SCAN命令的扫描过程，以指定的秒数进行节流。

例如，-i 0.01 会显著减慢程序的执行速度，但也会将服务器的负载减少到可以忽略不计的程度。

请注意，摘要还以更清晰的形式报告了每次找到的最大键。初始输出只是为了在针对非常大的数据集运行时尽快提供一些有趣的信息。

--bigkeys 选项现在可以在集群副本上使用。

内存使用情况

类似于--bigkeys选项，--memkeys允许您扫描整个键空间以找到最大的键以及每种键类型的平均大小。

--memkeys 选项现在可以在集群副本上使用。

结合 `--bigkeys` 和 `--memkeys`

你可以使用--keystats和--keystats-samples选项将--memkeys和--bigkeys与额外的分布数据结合起来。

获取键列表

也可以扫描键空间，再次以一种不阻塞Redis服务器的方式（当你使用像KEYS *这样的命令时会发生阻塞），并打印所有键名，或根据特定模式过滤它们。这种模式，像--bigkeys选项一样，使用SCAN命令，因此如果数据集正在变化，键可能会被多次报告，但如果键从迭代开始时就存在，则不会遗漏任何键。由于它使用的命令，这个选项被称为--scan。

$ redis-cli --scan | head -10
key-419
key-71
key-236
key-50
key-38
key-458
key-453
key-499
key-446
key-371

请注意，head -10 用于仅打印输出的前十行。

扫描能够利用SCAN命令的基础模式匹配能力，通过--pattern选项实现。

$ redis-cli --scan --pattern '*-11*'
key-114
key-117
key-118
key-113
key-115
key-112
key-119
key-11
key-111
key-110
key-116

通过wc命令传递输出可以用来按键名计数特定类型的对象：

$ redis-cli --scan --pattern 'user:*' | wc -l
3829433

你可以使用-i 0.01在调用SCAN命令之间添加延迟。这将使命令变慢，但会显著减少服务器的负载。

发布/订阅模式

CLI 能够使用 PUBLISH 命令在 Redis Pub/Sub 频道中发布消息。订阅频道以接收消息则不同 - 终端会被阻塞并等待消息，因此这是在 redis-cli 中实现的一种特殊模式。与其他特殊模式不同，此模式不是通过使用特殊选项启用的，而是简单地通过使用 SUBSCRIBE 或 PSUBSCRIBE 命令启用的，这些命令在交互模式或命令模式下可用：

$ redis-cli PSUBSCRIBE '*'
Reading messages... (press Ctrl-C to quit)
1) "PSUBSCRIBE"
2) "*"
3) (integer) 1

读取消息 消息显示我们进入了发布/订阅模式。当另一个客户端在某个频道发布一些消息时，例如使用命令 redis-cli PUBLISH mychannel mymessage，处于发布/订阅模式的CLI将显示如下内容：

1) "pmessage"
2) "*"
3) "mychannel"
4) "mymessage"

这对于调试发布/订阅问题非常有用。要退出发布/订阅模式，只需处理 CTRL-C。

监控在Redis中执行的命令

与发布/订阅模式类似，一旦使用MONITOR命令，监控模式将自动进入。活动Redis实例接收到的所有命令将打印到标准输出：

$ redis-cli MONITOR
OK
1460100081.165665 [0 127.0.0.1:51706] "set" "shipment:8000736522714:status" "sorting"
1460100083.053365 [0 127.0.0.1:51707] "get" "shipment:8000736522714:status"

请注意，可以管道输出，因此您可以使用诸如grep之类的工具来监控特定模式。

监控Redis实例的延迟

Redis 通常用于延迟非常关键的场景。延迟涉及应用程序中的多个移动部分，从客户端库到网络堆栈，再到 Redis 实例本身。

redis-cli 提供了多种工具来研究 Redis 实例的延迟，并了解延迟的最大值、平均值和分布情况。

基本的延迟检查工具是--latency选项。使用此选项，CLI会运行一个循环，其中PING命令被发送到Redis实例，并测量接收回复的时间。这每秒发生100次，并且统计数据在控制台中实时更新：

$ redis-cli --latency
min: 0, max: 1, avg: 0.19 (427 samples)

统计数据以毫秒为单位提供。通常，由于运行redis-cli本身的系统内核调度器的延迟，非常快的实例的平均延迟往往会稍微被高估，因此上述0.19的平均延迟可能很容易是0.01或更少。然而，这通常不是一个大问题，因为大多数开发者对几毫秒或更长时间的事件感兴趣。

有时研究最大和平均延迟随时间的变化是很有用的。--latency-history 选项用于此目的：它的工作方式与 --latency 完全相同，但每15秒（默认情况下）会从头开始一个新的采样会话：

$ redis-cli --latency-history
min: 0, max: 1, avg: 0.14 (1314 samples) -- 15.01 seconds range
min: 0, max: 1, avg: 0.18 (1299 samples) -- 15.00 seconds range
min: 0, max: 1, avg: 0.20 (113 samples)^C

采样会话的长度可以通过-i 选项进行更改。

最先进的延迟研究工具，但对于没有经验的用户来说也是最难解释的，是能够使用彩色终端来显示延迟的频谱。你会看到一个彩色的输出，表示样本的不同百分比，以及不同的ASCII字符，表示不同的延迟数值。此模式通过使用--latency-dist选项启用：

$ redis-cli --latency-dist
(output not displayed, requires a color terminal, try it!)

在redis-cli中实现了另一个非常不寻常的延迟工具。它不检查Redis实例的延迟，而是检查运行redis-cli的计算机的延迟。这种延迟是内核调度程序固有的，在虚拟化实例的情况下是虚拟机管理程序固有的，等等。

Redis 将其称为 固有延迟，因为它对程序员来说大多是不透明的。如果 Redis 实例的延迟很高，而所有明显的可能原因都已排除，那么值得检查一下你的系统在运行 Redis 服务器的系统上直接以这种特殊模式运行 redis-cli 时能达到的最佳性能。

通过测量固有延迟，您知道这是基线，Redis 无法超越您的系统。为了在这种模式下运行 CLI，请使用 --intrinsic-latency 。请注意，测试时间以秒为单位，决定了测试应运行多长时间。

$ ./redis-cli --intrinsic-latency 5
Max latency so far: 1 microseconds.
Max latency so far: 7 microseconds.
Max latency so far: 9 microseconds.
Max latency so far: 11 microseconds.
Max latency so far: 13 microseconds.
Max latency so far: 15 microseconds.
Max latency so far: 34 microseconds.
Max latency so far: 82 microseconds.
Max latency so far: 586 microseconds.
Max latency so far: 739 microseconds.

65433042 total runs (avg latency: 0.0764 microseconds / 764.14 nanoseconds per run).
Worst run took 9671x longer than the average latency.

重要提示：此命令必须在运行Redis服务器实例的计算机上执行，而不是在其他主机上。它不会连接到Redis实例，而是在本地执行测试。

在上述情况下，系统的最坏情况延迟不能优于739微秒，因此可以预期某些查询偶尔会运行不到1毫秒。

RDB文件的远程备份

在Redis复制的第一次同步期间，主节点和副本节点以RDB文件的形式交换整个数据集。这一特性被redis-cli利用，以提供远程备份功能，允许将RDB文件从任何Redis实例传输到运行redis-cli的本地计算机。要使用此模式，请使用--rdb <目标文件名>选项调用CLI：

$ redis-cli --rdb /tmp/dump.rdb
SYNC sent to master, writing 13256 bytes to '/tmp/dump.rdb'
Transfer finished with success.

这是一种简单但有效的方法，可以确保您的Redis实例存在RDB备份。在脚本或cron作业中使用此选项时，请确保检查命令的返回值。如果返回值非零，则表示发生了错误，如下例所示：

$ redis-cli --rdb /tmp/dump.rdb
SYNC with master failed: -ERR Can't SYNC while not connected with my master
$ echo $?
1

副本模式

CLI的副本模式是一个高级功能，对于Redis开发者和调试操作非常有用。它允许检查主节点在复制流中发送给其副本的内容，以便将写操作传播到其副本。该选项名称是--replica。以下是一个工作示例：

$ redis-cli --replica
SYNC with master, discarding 13256 bytes of bulk transfer...
SYNC done. Logging commands from master.
"PING"
"SELECT","0"
"SET","last_name","Enigk"
"PING"
"INCR","mycounter"

该命令首先丢弃第一次同步的RDB文件，然后以CSV格式记录接收到的每个命令。

如果您认为某些命令在您的副本中没有正确复制，这是一个检查发生了什么的好方法，也是改进错误报告的有用信息。

执行LRU模拟

Redis 通常用作带有 LRU 淘汰的缓存。根据键的数量和分配给缓存的内存量（通过 maxmemory 指令指定），缓存命中和未命中的数量会发生变化。有时，模拟命中率对于正确配置缓存非常有用。

redis-cli 有一个特殊模式，在该模式下，它使用80-20%的幂律分布在请求模式中模拟GET和SET操作。这意味着20%的键将被请求80%的次数，这是在缓存场景中常见的分布。

理论上，给定请求的分布和Redis内存开销，应该可以通过数学公式分析计算命中率。然而，Redis可以配置不同的LRU设置（样本数量）和LRU的实现，这在Redis中是近似的，不同版本之间变化很大。同样，每个键的内存量在不同版本之间也可能发生变化。这就是为什么构建了这个工具：其主要动机是测试Redis的LRU实现的质量，但现在也用于测试给定版本在最初部署时的设置下的行为。

要使用此模式，请指定测试中的键数量，并配置一个合理的maxmemory设置作为首次尝试。

重要提示：在Redis配置中设置maxmemory参数至关重要：如果没有设置最大内存使用上限，命中率最终将达到100%，因为所有键都可以存储在内存中。如果设置了过多的键与最大内存，最终将耗尽计算机的所有RAM。还需要配置适当的maxmemory policy；大多数情况下会选择allkeys-lru。

在以下示例中，配置了100MB的内存限制，并使用1000万个键进行LRU模拟。

警告：测试使用了管道技术，会对服务器造成压力，请不要在生产实例中使用。

$ ./redis-cli --lru-test 10000000
156000 Gets/sec | Hits: 4552 (2.92%) | Misses: 151448 (97.08%)
153750 Gets/sec | Hits: 12906 (8.39%) | Misses: 140844 (91.61%)
159250 Gets/sec | Hits: 21811 (13.70%) | Misses: 137439 (86.30%)
151000 Gets/sec | Hits: 27615 (18.29%) | Misses: 123385 (81.71%)
145000 Gets/sec | Hits: 32791 (22.61%) | Misses: 112209 (77.39%)
157750 Gets/sec | Hits: 42178 (26.74%) | Misses: 115572 (73.26%)
154500 Gets/sec | Hits: 47418 (30.69%) | Misses: 107082 (69.31%)
151250 Gets/sec | Hits: 51636 (34.14%) | Misses: 99614 (65.86%)

程序每秒显示统计信息。在最初的几秒钟内，缓存开始被填充。随后，未命中率稳定到可以预期的实际数值：

120750 Gets/sec | Hits: 48774 (40.39%) | Misses: 71976 (59.61%)
122500 Gets/sec | Hits: 49052 (40.04%) | Misses: 73448 (59.96%)
127000 Gets/sec | Hits: 50870 (40.06%) | Misses: 76130 (59.94%)
124250 Gets/sec | Hits: 50147 (40.36%) | Misses: 74103 (59.64%)

对于某些使用场景，59%的未命中率可能是不可接受的，因此100MB的内存是不够的。观察一个使用半GB内存的示例。几分钟后，输出稳定为以下数字：

140000 Gets/sec | Hits: 135376 (96.70%) | Misses: 4624 (3.30%)
141250 Gets/sec | Hits: 136523 (96.65%) | Misses: 4727 (3.35%)
140250 Gets/sec | Hits: 135457 (96.58%) | Misses: 4793 (3.42%)
140500 Gets/sec | Hits: 135947 (96.76%) | Misses: 4553 (3.24%)

500MB的空间足以满足关键数量（1000万）和分布（80-20风格）的需求。