本文内容为 http://redis.io/commands/config-get 的翻译、注解、例子扩充及其它修改。感谢 Redis 作者 Antirez 为开源社区作出的贡献,本文保证最新、最准、最全以表示对其的敬意。欢迎留言纠错、提示更新或支持。
CONFIG GET parameter

当前命令用于获取一个正在运行的 Redis 服务端(Server)的配置参数。

The CONFIG GET command is used to read the configuration parameters of a running Redis server. 

Redis2.4 版本中,并不是所有的配置参数都支持获取,而从 2.6 版本开始,可以使用当前命令获取某个服务端的所有配置。

Not all the configuration parameters are supported in Redis 2.4, while Redis 2.6 can read the whole configuration of a server using this command.

相对地,可以使用命令 CONFIG SET 来修改一个正在运行的服务端的配置信息。

The symmetric command used to alter the configuration at run time is CONFIG SET.

命令 CONFIG GET 使用一个参数,该参数为一个通配模式(Glob-style pattern)。所有匹配该通配模式的配置参数将被以键-值对列表的形式返回。如:

redis> config get *max-*-entries*
1) "hash-max-zipmap-entries"
2) "512"
3) "list-max-ziplist-entries"
4) "512"
5) "set-max-intset-entries"
6) "512"

你可以在打开的 redis-cli 提示框中输入 CONFIG GET * 便能获得所有已支持的配置参数。

You can obtain a list of all the supported configuration parameters by typing CONFIG GET * in an open redis-cli prompt.

所有已支持的参数与配置文件 redis.conf 中的对应配置参数有相同的含义,除了以下几处重要的不同:

  • 对于配置指令中的基本单位,比如描述字节(Bytes)或其它数量(Quantity)时,不能够像 redis.conf 中那样使用缩写格式(10k20gb),需全部使用格式良好(Well-formed)64 位整数。
  • 指令 save 的参数为由空格所分隔的整数所组成的字符串。每对整数代表一个秒数/修改(Seconds/Modifications)阀值(Threshold)
All the supported parameters have the same meaning of the equivalent configuration parameter used in the redis.conf file, with the following important differences:
  • Where bytes or other quantities are specified, it is not possible to use the redis.conf abbreviated form (10k 2gb ... and so forth), everything should be specified as a well-formed 64-bit integer, in the base unit of the configuration directive.
  • The save parameter is a single string of space-separated integers. Every pair of integers represent a seconds/modifications threshold.

比如在 redis.conf 文件中存在如下配置:

save 900 1
save 300 10

CONFIG GET 将返回 “900 1 300 10”。

For instance what in redis.conf looks like:
save 900 1
save 300 10
that means, save after 900 seconds if there is at least 1 change to the dataset, and after 300 seconds if there are at least 10 changes to the datasets, will be reported by CONFIG GET as "900 1 300 10".
  • 返回数组响应(Array reply)

    The return type of the command is a Array reply.
  • 版本支持

    2.0.0+

    在 Redis2.4 版本中,并不是所有的配置参数都支持获取,而从 2.6 版本开始,可以使用当前命令获取某个服务端的所有配置。