Redis 命令行

Redis 命令行界面 redis-cli 概述

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

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

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

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

命令行使用

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

$ redis-cli INCR mycounter
(integer) 7

该命令的回复是“7”。由于 Redis 回复是类型化的（字符串、数组、整数、nil、错误等），因此您会在括号中看到回复的类型。当redis-cli必须将的输出用作另一个命令的输入或重定向到文件时，此附加信息可能并不理想。

redis-cli仅当检测到标准输出是 tty 或终端时，才会显示其他信息以方便阅读。对于所有其他输出，它将自动启用原始输出模式，如下例所示：

$ 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- 任何用十六进制数表示的 ASCII 字符 ( hh )

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

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

例如，返回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 <password>选项将执行身份验证，无需明确使用以下AUTH命令：

$ redis-cli -a myUnguessablePazzzzzword123 PING
PONG

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

最后，可以使用以下选项发送对默认数字零以外的数据库编号进行操作的命令-n <dbnum>：

$ 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> 还可以通过使用选项和 URI 模式来提供部分或全部信息redis://user:password@host:port/dbnum：

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

注意： 用户、密码和数据库号是可选的。对于没有用户名的身份验证，请使用用户名default。对于 TLS，请使用方案rediss。

您可以使用-4或-6参数分别设置 DNS 查找的 IPv4 或 IPv6 首选项。

SSL/TLS

默认情况下，redis-cli使用普通 TCP 连接来连接到 Redis。您可以使用选项启用 SSL/TLS --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 <count>和-i <delay>。-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 输出

存在 CSV（逗号分隔值）输出功能，redis-cli可以将数据从 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 3.2 及以上版本广泛支持redis-cli使用 Lua 脚本调试功能。有关此功能，请参阅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

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

redis-cli使用上述选项调用时--eval，无需明确指定键的数量。相反，它使用用逗号分隔键和参数的惯例。这就是为什么在上面的调用中你会看到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 <timeout>选项以秒为单位指定服务器超时。

编辑、历史、完成和提示

因为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 @<category>显示有关给定类别的所有命令。类别包括：
- @generic
- @string
- @list
- @set
- @sorted_set
- @hash
- @pubsub
- @transactions
- @connection
- @server
- @scripting
- @hyperloglog
- @cluster
- @geo
- @stream
HELP <commandname>显示作为参数给出的命令的具体帮助。

例如，为了显示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 服务器的延迟。
检查本地计算机的调度程序延迟。
从远程 Redis 服务器传输 RDB 备份到本地。
充当 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 <interval>选项充当修饰符，用于更改发出新行的频率。默认值为一秒。

扫描大键和内存使用情况

大钥匙

在此特殊模式下，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 可以使用命令在 Redis Pub/Sub 频道中发布消息PUBLISH。订阅频道以接收消息有所不同 - 终端被阻止并等待消息，因此这在中作为特殊模式实现redis-cli。与其他特殊模式不同，此模式不是通过使用特殊选项启用的，而只是通过使用SUBSCRIBE或PSUBSCRIBE命令启用的，它们在交互或命令模式下可用：

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

正在读取消息消息表明我们已进入 Pub/Sub 模式。当另一个客户端在某个频道发布某条消息时（例如使用命令）redis-cli PUBLISH mychannel mymessage，Pub/Sub 模式下的 CLI 将显示如下内容：

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

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

监控Redis中执行的命令

与 Pub/Sub 模式类似，使用该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 <interval>。

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

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

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

Redis 将其称为内在延迟，因为它对程序员来说几乎是不透明的。如果 Redis 实例的延迟很高，而不管所有显而易见的因素可能是根本原因，那么值得在运行redis-cliRedis 服务器的系统中直接以这种特殊模式运行，以检查系统可以达到的最佳效果。

通过测量固有延迟，您可以知道这是基准，并且 Redis 无法超越您的系统。要在此模式下运行 CLI，请使用--intrinsic-latency <test-time>。请注意，测试时间以秒为单位，并指示测试应运行多长时间。

$ ./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。要使用此模式，请使用以下选项调用 CLI --rdb <dest-filename> ：

$ 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有一种特殊模式，可以模拟 GET 和 SET 操作，在请求模式中使用 80-20% 的幂律分布。这意味着 20% 的键将被请求 80% 的时间，这是缓存场景中的常见分布。

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

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

重要提示：maxmemory在 Redis 配置中配置设置至关重要：如果最大内存使用量没有上限，命中率最终将达到 100%，因为所有键都可以存储在内存中。如果使用最大内存指定了太多键，最终将使用所有计算机 RAM。还需要配置适当的 最大内存策略；大多数情况下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 样式）。