参数支持--缓存数据库 Redis 企业版-火山引擎

文档中心

立即注册

导航

参数支持

最近更新时间：2024.12.04 10:53:41首次发布时间：2024.10.24 21:43:27

缓存数据库 Redis 企业版支持自定义部分参数值，本文介绍 Redis 企业版实例支持的自定义参数的相关信息。

说明

为最大程度地保障实例的稳定运行，目前缓存数据库 Redis 企业版仅开放了部分参数，本文仅列出了支持自定义的参数，暂不支持自定义未出现在本文中的参数。参数设置方法，请参见设置实例参数。

支持通过控制台自定义的参数

参数说明

参数	说明
disabled-commands	设置实例的禁用命令。默认禁用了 `flushall`、`flushdb` 和 `keys` 命令。您也可根据业务需求禁用某些执行时长较长、复杂度较高或对业务风险较大的命令。Redis 企业版支持的命令详情，请参见命令支持。说明您可以在 `disabled-commands` 参数值中输入任意命令，但需注意如下几点：单个实例最多支持禁用 16 个命令，多个命令间用英文逗号（,）分隔。不支持禁用 `AUTH` 命令。输入的命令不区分大小写。支持单独禁用子命令。同一子命令里的不同单词间需用空格（space）或竖线（例如，将任意大小写形式的 `OBJECT ENCODING` 或 `OBJECT\|ENCODING` 输入到 `disabled-commands` 参数值中，即可禁用 `OBJECT ENCODING` 这一子命令。将 Redis 企业版支持的命令加入了禁用命令 `disabled-commands` 参数值中后，在您执行该命令时，会出现 `ERR command 'xxxx' is not allowed` 的报错。
eviction_policy	设置缓存满后 Redis 删除内容的策略，取值范围如下： `volatile-lru`（默认值）：只从设置失效（expire set）的键中选择最近最少使用的键进行删除。 `allkeys-lru` ：优先删除掉最近最少使用的键。 `volatile-lfu`：只从设置失效（expire set）的键中选择最不常用的键进行删除。 `allkeys-lfu`：优先删除掉最不常用的键。 `volatile-random`：只从设置失效（expire set）的键中，随机选择一些键进行删除。 `allkeys-random`：随机选择一些键进行删除。 `volatile-ttl`：只从设置失效（expire set）的键中，选出存活时间 TTL（Time To Live）最短的键进行删除。 `noeviction`：不删除任何键，只是在写操作时返回错误。说明该参数仅对内存型实例生效，混存型实例不会展示该参数。

disabled-commands

设置实例的禁用命令。默认禁用了 flushall、flushdb 和 keys 命令。
您也可根据业务需求禁用某些执行时长较长、复杂度较高或对业务风险较大的命令。Redis 企业版支持的命令详情，请参见命令支持。

说明

您可以在 disabled-commands 参数值中输入任意命令，但需注意如下几点：

单个实例最多支持禁用 16 个命令，多个命令间用英文逗号（,）分隔。
不支持禁用 AUTH 命令。
输入的命令不区分大小写。
支持单独禁用子命令。同一子命令里的不同单词间需用空格（space）或竖线（
例如，将任意大小写形式的 OBJECT ENCODING 或 OBJECT|ENCODING 输入到 disabled-commands 参数值中，即可禁用 OBJECT ENCODING 这一子命令。
将 Redis 企业版支持的命令加入了禁用命令 disabled-commands 参数值中后，在您执行该命令时，会出现 ERR command 'xxxx' is not allowed 的报错。

eviction_policy

设置缓存满后 Redis 删除内容的策略，取值范围如下：

volatile-lru（默认值）：只从设置失效（expire set）的键中选择最近最少使用的键进行删除。
allkeys-lru ：优先删除掉最近最少使用的键。
volatile-lfu：只从设置失效（expire set）的键中选择最不常用的键进行删除。
allkeys-lfu：优先删除掉最不常用的键。
volatile-random：只从设置失效（expire set）的键中，随机选择一些键进行删除。
allkeys-random：随机选择一些键进行删除。
volatile-ttl：只从设置失效（expire set）的键中，选出存活时间 TTL（Time To Live）最短的键进行删除。
noeviction：不删除任何键，只是在写操作时返回错误。

说明

该参数仅对内存型实例生效，混存型实例不会展示该参数。

支持通过 Config 命令自定义的参数

参数说明

参数	说明
lua-time-limit	一个 Lua 脚本阻塞执行的最长时间。当 Lua 运行超过该参数限制后，Redis 将开始接受其他命令但不会执行，而是返回 Busy 报错。单位：毫秒（ms），取值范围：[0,6000]（0 表示无限执行时间），默认值：5000。
notify-keyspace-events	设置键空间或键事件通知。参数值可以是如下字符的任意组合： `K`：键空间，以 `__keyspace@<db>__` 为前缀发布事件。 `E`：键事件，以 `__keyevent@<db>__` 为前缀发布事件。 `g`：DEL、EXPIRE、RENAME 等类型无关的通用命令。 `$`：字符串命令。 `l`：列表命令。 `s`：集合命令。 `h`：哈希命令。 `z`：有序集合命令。 `x`：过期事件，当过期键被删除时，会发送事件。 `e`：驱逐事件，当键因为符合 `maxmemory` 策略而被驱逐时，会发送事件。 `A`：参数组合 `g$lshzxe` 别名。例如需要订阅过期事件的通知，您可以先在参数设置中将 `notify-keyspace-events` 参数值设置为 `Ex`。配置参数后，在客户端执行 `PSUBSCRIBE __keyevent@0__*` 命令，表示订阅 DB0 的键事件通知。说明空字符串表示关闭事件通知，默认值是空字符串。开启事件通知后，会占用一定的 CPU。更多信息，请参见 Redis keyspace notifications。自定义配置参数值时，参数值中需要同时满足如下规范，否则不会产生事件：至少需要指定 `K` 或 `E` 中的一个。至少需要指定 `A`、`g`、`$`、`l`、`s`、`h`、`z`、`x` 或 `e` 中的一个。
slowlog-log-slower-than	Server 节点上请求被记录为慢日志的执行时间阈值，执行时间高于该阈值的请求会被记录到 Server 节点的慢日志中。单位：微秒（us）。默认值： 10000。取值范围如下：负整数：表示禁用慢日志，即无论请求执行了多长时间，该请求都不会被记录为到慢日志中。 `0`：表示所有请求都会被记录到慢日志中。正整数：表示执行时间高于该阈值的请求会被记录到 Server 节点的慢日志中。取值为不超过 Integer 数据类型的最大值。

lua-time-limit

一个 Lua 脚本阻塞执行的最长时间。当 Lua 运行超过该参数限制后，Redis 将开始接受其他命令但不会执行，而是返回 Busy 报错。
单位：毫秒（ms），取值范围：[0,6000]（0 表示无限执行时间），默认值：5000。

notify-keyspace-events

设置键空间或键事件通知。参数值可以是如下字符的任意组合：

K：键空间，以 __keyspace@<db>__ 为前缀发布事件。
E：键事件，以 __keyevent@<db>__ 为前缀发布事件。
g：DEL、EXPIRE、RENAME 等类型无关的通用命令。
$：字符串命令。
l：列表命令。
s：集合命令。
h：哈希命令。
z：有序集合命令。
x：过期事件，当过期键被删除时，会发送事件。
e：驱逐事件，当键因为符合 maxmemory 策略而被驱逐时，会发送事件。
A：参数组合 g$lshzxe 别名。

例如需要订阅过期事件的通知，您可以先在参数设置中将 notify-keyspace-events 参数值设置为 Ex。配置参数后，在客户端执行 PSUBSCRIBE __keyevent@0__* 命令，表示订阅 DB0 的键事件通知。

说明

空字符串表示关闭事件通知，默认值是空字符串。开启事件通知后，会占用一定的 CPU。更多信息，请参见 Redis keyspace notifications。
自定义配置参数值时，参数值中需要同时满足如下规范，否则不会产生事件：
- 至少需要指定 K 或 E 中的一个。
- 至少需要指定 A、g、$、l、s、h、z、x 或 e 中的一个。

slowlog-log-slower-than

Server 节点上请求被记录为慢日志的执行时间阈值，执行时间高于该阈值的请求会被记录到 Server 节点的慢日志中。
单位：微秒（us）。默认值： 10000。取值范围如下：

负整数：表示禁用慢日志，即无论请求执行了多长时间，该请求都不会被记录为到慢日志中。
0：表示所有请求都会被记录到慢日志中。
正整数：表示执行时间高于该阈值的请求会被记录到 Server 节点的慢日志中。取值为不超过 Integer 数据类型的最大值。