动态与公告

产品动态

公告

新手指引

产品简介

产品概述

产品优势

应用场景

存储引擎

产品系列

产品版本

规格与性能

读写分离

多可用区部署

地域和可用区

名词解释

购买指南

计费概述

定价中心

购买实例

续费说明（包年包月）

退费说明（包年包月）

欠费说明

按量转包年包月

快速入门

快速创建实例

连接 Redis 实例

操作指南

操作总览

连接数据库实例

管理实例

升级实例

管理节点（Redis/ValKey 版）

管理多可用区

备份与恢复

账号管理

参数配置

慢查询

访问管理

网络与安全

监控与告警

事件管理（Redis/ValKey 版）

数据迁移

Redis 版全球复制

数据库审计

诊断优化

Sentinel 模式

开发准则

命名规则

基本使用准则

Key 与 Value 设计原则

命令使用准则

客户端程序设计准则

连接池配置

命令参考

命令参考概览

Redis 版与 Valkey 版命令兼容性

大版本命令使用差异

Proxy 架构与直连模式的使用差异

命令更多操作（Redis/Valkey 版）

Memcached 版命令兼容性

实践教程

基于 Spring Boot 搭建 Redis 客户端监控

Redis 客户端连接配置策略与实践

集群架构全局 SCAN 使用指南

实例安全下线

热 Key 与大 key

可用区迁移方案

故障处理

连接异常

Redisson 客户端超时重连异常分析及解决方案

性能排查与调优

API 文档

History

Introduction

API Category

Making API Requests

Instance APIs

Parameter Management APIs

Other APIs

Backup and Restoration APIs

Region APIs

Monitoring and Management APIs

Log APIs

Data Types

Error Codes

常见问题

使用常见问题

连接登录问题

购买相关问题

可配置的参数列表

PDF

聚焦模式

字号

最后更新时间： 2026-03-17 17:45:58

参数
说明
支持版本
active-expire-effort
调整主动清除过期键时 CPU 占用的上限。
取值：1～10，默认为1。
CPU 占用上限 = 25% + (n-1) × 2%。
默认值1对应 CPU 占用上限为25%。
最大值10对应 CPU 占用上限为43%。
Redis 6.2及以上
ValKey 8.0
auto-failback
多可用区部署实例时，该参数指定在故障恢复后，主节点是否会自动切换回主节点组（Cluster）。
Redis 4.0及以上
ValKey 8.0
disable-command-list
设置禁用命令，用户可根据实际业务需要关闭某些时间复杂度高或危险程度高的命令，被设置禁用的命令将不允许在此实例中运行，可以配置多个命令，例如“flushdb,keys”。
Redis 2.8及以上
ValKey 8.0

hz

设置执行频率。
Redis 2.8及以上
ValKey 8.0
maxmemory-policy
设置内存缓存满后，数据的淘汰策略，可在如下策略中进行选择：
volatile-lru：对设置 TTL 过期时间的 key，使用 LRU 算法淘汰并删除，即优先淘汰设置了过期时间（TTL）的键中最近最少使用的键。
allkeys-lru：对所有的 key，使用 LRU 算法淘汰删除，即不管数据是否设置超时属性，优先淘汰最近最少使用的键，直到腾出足够空间为止。
volatile-random：对设置 TTL 过期时间的键，随机地淘汰删除。
allkeys-random：对所有的 key，随机地淘汰删除。
volatile-ttl：对设置 TTL 过期时间的 key，优先淘汰设置了过期时间的键中 TTL 值较小的键。
noeviction：不淘汰删除任何 key，拒绝所有写入操作，在写操作时返回错误信息。
volatile-lfu：优先淘汰设置了过期时间（TTL）的键中最不经常使用（LFU）的键。
allkeys-lfu：优先淘汰最不经常使用（LFU）的键，与 volatile-lfu 不同，allkeys-lfu 策略会淘汰所有键，而不仅是设置了过期时间（TTL）的键。
其中，LRU（Least Recently Used）表示最近最少使用；TTL（Time To Live）表示设置过期时间。LFU（ Least Frequently Used）表示最不经常使用。具体信息，请参见 基本使用准则。
Redis 2.8及以上
ValKey 8.0
Memcached 1.6
﻿
UserPasswordSeparate
指定自定义账户的密码连接符号。
说明：
若当前运行参数值提示当前代理版本不支持修改 UserPasswordSeparate 参数，请根据界面提示升级代理版本。
Redis 4.0及以上
ValKey 8.0
cluster-node-timeout
设置集群节点超时时间，即集群中一个节点不可达的时间（毫秒），才能将该节点视为处于故障状态。
Redis 4.0及以上
ValKey 8.0
rehash-maintenance-time
设置是否允许在维护时间窗内进行 rehash 操作。
说明：
若界面提示分布式缓存数据库小版本不支持修改 rehash-maintenance-time 参数，请 升级小版本。
no：参数默认为 no，表示不启用该特性，沿用原生 Redis rehash 方案，当负载因子达到预设阈值时触发 rehash。
yes：启用腾讯自研的 rehash 增强特性，尽可能减少或降低分布式缓存数据库运行过程中的性能波动。
当 hash 表的负载因子小于1.618时，在维护时间窗口内进行渐进式 rehash，以避免对性能产生一定影响。
当 hash 表的负载因子大于1.618时，系统将自动触发全量 rehash，以确保数据结构的效率和稳定性。
Redis 4.0及以上
ValKey 8.0
hash-max-ziplist-entries
当哈希对象可以同时满足以下两个条件时，哈希对象使用 ziplist 编码：
哈希对象保存的所有键值对的键和值的字符串长度字节数，都小于 hash-max-ziplist-value 的值。
哈希对象保存的键值对数量，小于 hash-max-ziplist-entries 的值。
Redis 2.8及以上
ValKey 8.0
hash-max-ziplist-value
当哈希对象可以同时满足以下两个条件时，哈希对象使用 ziplist 编码：
哈希对象保存的所有键值对的键和值的字符串长度字节数，都小于 hash-max-ziplist-value 的值。
哈希对象保存的键值对数量，小于 hash-max-ziplist-entries 的值。
Redis 2.8及以上
ValKey 8.0

lazyfree-lazy-eviction

该参数用于控制 分布式缓存数据库在执行内存回收时是否执行惰性删除（Lazy Free）和惰性驱逐（Lazy Eviction）。
惰性删除：当分布式缓存数据库需要删除某个键值对时，它并不会立即将该键值对从内存中删除，而是将该键值对标记为“待删除”，并等待下一次访问该键值对时再将其删除。存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。
惰性驱逐：当分布式缓存数据库需要释放一部分内存空间时，它并不会立即释放内存，而是将一些键值对标记为“待释放”存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。这种方式可以减少内存回收的开销，但会导致内存占用率较高。
该参数的取值如下所示。
no: 表示不使用惰性删除和惰性驱逐，分布式缓存数据库在执行内存回收时会立即删除键值对或释放内存空间。
yes: 表示使用惰性删除和惰性驱逐。
Redis 2.8及以上
ValKey 8.0

lazyfree-lazy-expire
该参数用于控制分布式缓存数据库在执行过期键删除时是否执行惰性删除（Lazy Free）。
no: 表示不使用惰性删除，分布式缓存数据库在执行过期键删除时会立即删除键值对。
yes: 表示使用惰性删除，分布式缓存数据库在执行过期键删除时会将一些键值对标记为“待删除”，存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。
Redis 4.0及以上
ValKey 8.0

lazyfree-lazy-server-del
该参数控制分布式缓存数据库在执行 DEL 命令删除键值对时的惰性删除行为。
no: 表示不使用惰性删除，分布式缓存数据库在执行 DEL 命令删除键值对时会立即删除键值对。
yes: 表示使用惰性删除，分布式缓存数据库在执行 DEL 命令删除键值对时会将一些键值对标记为“待删除”，存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。
Redis 4.0及以上
ValKey 8.0

lazyfree-lazy-user-del
当用户或应用程序执行 DEL 命令用于删除分布式缓存数据库中的一个或多个键值对，可开启或关闭惰性删除（Lazy Free）。
no：DEL 命令将直接将键值对从内存中删除，而不执行惰性删除。
yes：执行 DEL 命令时会先执行惰性删除，分布式缓存数据库会立即返回 OK，将删除工作交给后台线程异步处理。
Redis 4.0及以上
ValKey 8.0
lazyfree-lazy-user-flush
当用户或应用程序执行 FLUSHDB（清空当前数据库）或 FLUSHALL（清空所有数据库）时，可开启或关闭惰性删除（Lazy Free）。
默认值 no：关闭惰性删除（Lazy Free），执行清空命令会同步阻塞地删除所有键。
yes：执行 FLUSHDB 或 FLUSHALL 时，分布式缓存数据库会立即返回 OK，将删除工作交给后台线程异步处理。
Redis 4.0及以上
ValKey 8.0
proxy-slowlog-log-slower-than
设置 Proxy 慢日志的记录阈值，即在 Proxy 设置对执行时间大于多少毫秒的操作进行记录。
Redis 2.8及以上
ValKey 8.0
Memcached 1.6
replica-lazy-flush
在完全重新同步数据时，控制是否延迟释放不再需要的资源。
﻿
Redis 5.0及以上
ValKey 8.0
ScanSlaveNode
启用该参数后，扫描类命令（如 SCAN、KEYS、HSCAN、SSCAN、ZSCAN）将被路由到从节点执行，避免大量遍历操作阻塞主节点，提升集群整体性能。
yes：开启。
no：不开启。默认值为 no。
﻿
Redis 4.0及以上
ValKey 8.0
ClusterNodeAdaptive
启用该参数后，CLUSTER NODES 命令将返回各节点的槽位分配信息，便于客户端感知集群拓扑结构。
yes：返回结果包含 slot 信息。
no：返回结果不含 slot 信息。默认值为 no。
Redis 4.0及以上
ValKey 8.0

read-local-node-only
当实例为多可用区部署时，该参数指定是否开启或关闭就近访问功能。
Redis 4.0及以上
ValKey 8.0
sentineauth
该参数控制当使用 sentinel 命令与 Redis Sentinel 进行交互时，是否省略分布式缓存数据库的密码，而自动使用在 Sentinel 配置文件中指定的 sentinelauth 参数所对应的密码。
Redis 6.2及以上
ValKey 8.0
set-max-intset-entries
当 set 集合对象同时符合以下2个条件时，会使用 intset 编码：
集合对象所有数据都是字符串。
恰好均是基数为10的整数，范围为64位有符号整数。
Redis 2.8及以上
ValKey 8.0
slowlog-log-slower-than
设置慢日志的记录阈值，即设置对执行时间大于多少毫秒的操作进行记录。
﻿
timeout
当客户端连接闲置时间达到该指定值时，将关闭连接，单位为秒（s）。
﻿
zset-max-ziplist-entries
当排序集合对象同时满足以下两个条件时，排序集合对象将使用 ziplist 编码：
排序集合对象的每个元素的字符串长度的字节数，均小于 zset-max-ziplist-value 指定值。
排序集合对象的元素数量，均小于 zset-max-ziplist-entries 指定值。
﻿
zset-max-ziplist-value
当排序集合对象同时满足以下两个条件时，排序集合对象将使用 ziplist 编码：
排序集合对象的每个元素的字符串长度的字节数，均小于 zset-max-ziplist-value 指定值。
排序集合对象的元素数量，均小于 zset-max-ziplist-entries 指定值。
﻿
notify-keyspace-events
notify-keyspace-events 的参数是下列字符的任意组合，定义了服务器将发送哪些类型的通知。
字符：发送的通知。
K：键空间通知，所有通知以__keyspace@<db>__为前缀。
E：键事件通知，所有通知以__keyevent@<db>__为前缀。
g：DEL、EXPIRE、RENAME 等类型无关的通用命令的通知。
$：字符串命令的通知。
l：列表命令的通知。
s：集合命令的通知。
h：哈希命令的通知。
z：有序集合命令的通知。
x：过期事件，每当有过期键被删除时发送。
e：驱逐（evict）事件，每当有键因为 maxmemory 策略而被删除时发送。
A：参数 g$lshzxe 的别名。开启键空间通知将消耗 CPU 计算资源，故该通知默认关闭。如果定义服务器发送某些通知，输入参数需必选 K 或 E；如订阅键事件中驱逐事件相关的通知，参数填写为“Ee”；如订阅发送所有类型的通知，参数填写为“AKE”。
﻿
list-max-ziplist-entries
当链表对象同时满足以下两个条件时，链表对象将使用 ziplist 编码：
链表对象保存的每个元素的字符串长度的字节数，均小于 list-max-ziplist-value 指定值。
链表集合对象保存的元素数量，均小于 list-max-ziplist-entries 指定值。
Redis 2.8
list-max-ziplist-value
当链表对象同时满足以下两个条件时，链表对象将使用 ziplist 编码：
链表对象保存的每个元素的字符串长度的字节数，均小于 list-max-ziplist-value 指定值。
链表集合对象保存的元素数量，均小于 list-max-ziplist-entries 指定值。
Redis 2.8
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

腾讯云分布式缓存数据库（兼容 Redis）

可配置的参数列表

帮助和支持

参数	说明	支持版本
active-expire-effort	调整主动清除过期键时 CPU 占用的上限。取值：1～10，默认为1。 CPU 占用上限 = 25% + (n-1) × 2%。默认值1对应 CPU 占用上限为25%。最大值10对应 CPU 占用上限为43%。	Redis 6.2及以上 ValKey 8.0
auto-failback	多可用区部署实例时，该参数指定在故障恢复后，主节点是否会自动切换回主节点组（Cluster）。	Redis 4.0及以上 ValKey 8.0
disable-command-list	设置禁用命令，用户可根据实际业务需要关闭某些时间复杂度高或危险程度高的命令，被设置禁用的命令将不允许在此实例中运行，可以配置多个命令，例如“flushdb,keys”。	Redis 2.8及以上 ValKey 8.0
hz	设置执行频率。	Redis 2.8及以上 ValKey 8.0
maxmemory-policy	设置内存缓存满后，数据的淘汰策略，可在如下策略中进行选择： volatile-lru：对设置 TTL 过期时间的 key，使用 LRU 算法淘汰并删除，即优先淘汰设置了过期时间（TTL）的键中最近最少使用的键。 allkeys-lru：对所有的 key，使用 LRU 算法淘汰删除，即不管数据是否设置超时属性，优先淘汰最近最少使用的键，直到腾出足够空间为止。 volatile-random：对设置 TTL 过期时间的键，随机地淘汰删除。 allkeys-random：对所有的 key，随机地淘汰删除。 volatile-ttl：对设置 TTL 过期时间的 key，优先淘汰设置了过期时间的键中 TTL 值较小的键。 noeviction：不淘汰删除任何 key，拒绝所有写入操作，在写操作时返回错误信息。 volatile-lfu：优先淘汰设置了过期时间（TTL）的键中最不经常使用（LFU）的键。 allkeys-lfu：优先淘汰最不经常使用（LFU）的键，与 volatile-lfu 不同，allkeys-lfu 策略会淘汰所有键，而不仅是设置了过期时间（TTL）的键。其中，LRU（Least Recently Used）表示最近最少使用；TTL（Time To Live）表示设置过期时间。LFU（ Least Frequently Used）表示最不经常使用。具体信息，请参见基本使用准则。	Redis 2.8及以上 ValKey 8.0 Memcached 1.6
UserPasswordSeparate	指定自定义账户的密码连接符号。说明：若当前运行参数值提示当前代理版本不支持修改 UserPasswordSeparate 参数，请根据界面提示升级代理版本。	Redis 4.0及以上 ValKey 8.0
cluster-node-timeout	设置集群节点超时时间，即集群中一个节点不可达的时间（毫秒），才能将该节点视为处于故障状态。	Redis 4.0及以上 ValKey 8.0
rehash-maintenance-time	设置是否允许在维护时间窗内进行 rehash 操作。说明：若界面提示分布式缓存数据库小版本不支持修改 rehash-maintenance-time 参数，请升级小版本。 no：参数默认为 no，表示不启用该特性，沿用原生 Redis rehash 方案，当负载因子达到预设阈值时触发 rehash。 yes：启用腾讯自研的 rehash 增强特性，尽可能减少或降低分布式缓存数据库运行过程中的性能波动。当 hash 表的负载因子小于1.618时，在维护时间窗口内进行渐进式 rehash，以避免对性能产生一定影响。当 hash 表的负载因子大于1.618时，系统将自动触发全量 rehash，以确保数据结构的效率和稳定性。	Redis 4.0及以上 ValKey 8.0
hash-max-ziplist-entries	当哈希对象可以同时满足以下两个条件时，哈希对象使用 ziplist 编码：哈希对象保存的所有键值对的键和值的字符串长度字节数，都小于 hash-max-ziplist-value 的值。哈希对象保存的键值对数量，小于 hash-max-ziplist-entries 的值。	Redis 2.8及以上 ValKey 8.0
hash-max-ziplist-value	当哈希对象可以同时满足以下两个条件时，哈希对象使用 ziplist 编码：哈希对象保存的所有键值对的键和值的字符串长度字节数，都小于 hash-max-ziplist-value 的值。哈希对象保存的键值对数量，小于 hash-max-ziplist-entries 的值。	Redis 2.8及以上 ValKey 8.0
lazyfree-lazy-eviction	该参数用于控制分布式缓存数据库在执行内存回收时是否执行惰性删除（Lazy Free）和惰性驱逐（Lazy Eviction）。惰性删除：当分布式缓存数据库需要删除某个键值对时，它并不会立即将该键值对从内存中删除，而是将该键值对标记为“待删除”，并等待下一次访问该键值对时再将其删除。存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。惰性驱逐：当分布式缓存数据库需要释放一部分内存空间时，它并不会立即释放内存，而是将一些键值对标记为“待释放”存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。这种方式可以减少内存回收的开销，但会导致内存占用率较高。该参数的取值如下所示。 no: 表示不使用惰性删除和惰性驱逐，分布式缓存数据库在执行内存回收时会立即删除键值对或释放内存空间。 yes: 表示使用惰性删除和惰性驱逐。	Redis 2.8及以上 ValKey 8.0
lazyfree-lazy-expire	该参数用于控制分布式缓存数据库在执行过期键删除时是否执行惰性删除（Lazy Free）。 no: 表示不使用惰性删除，分布式缓存数据库在执行过期键删除时会立即删除键值对。 yes: 表示使用惰性删除，分布式缓存数据库在执行过期键删除时会将一些键值对标记为“待删除”，存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。	Redis 4.0及以上 ValKey 8.0
lazyfree-lazy-server-del	该参数控制分布式缓存数据库在执行 DEL 命令删除键值对时的惰性删除行为。 no: 表示不使用惰性删除，分布式缓存数据库在执行 DEL 命令删除键值对时会立即删除键值对。 yes: 表示使用惰性删除，分布式缓存数据库在执行 DEL 命令删除键值对时会将一些键值对标记为“待删除”，存入过期队列，按照 HZ 设置的频次去执行过期 Key 的清理。	Redis 4.0及以上 ValKey 8.0
lazyfree-lazy-user-del	当用户或应用程序执行 DEL 命令用于删除分布式缓存数据库中的一个或多个键值对，可开启或关闭惰性删除（Lazy Free）。 no：DEL 命令将直接将键值对从内存中删除，而不执行惰性删除。 yes：执行 DEL 命令时会先执行惰性删除，分布式缓存数据库会立即返回 OK，将删除工作交给后台线程异步处理。	Redis 4.0及以上 ValKey 8.0
lazyfree-lazy-user-flush	当用户或应用程序执行 FLUSHDB（清空当前数据库）或 FLUSHALL（清空所有数据库）时，可开启或关闭惰性删除（Lazy Free）。默认值 no：关闭惰性删除（Lazy Free），执行清空命令会同步阻塞地删除所有键。 yes：执行 FLUSHDB 或 FLUSHALL 时，分布式缓存数据库会立即返回 OK，将删除工作交给后台线程异步处理。	Redis 4.0及以上 ValKey 8.0
proxy-slowlog-log-slower-than	设置 Proxy 慢日志的记录阈值，即在 Proxy 设置对执行时间大于多少毫秒的操作进行记录。	Redis 2.8及以上 ValKey 8.0 Memcached 1.6
replica-lazy-flush	在完全重新同步数据时，控制是否延迟释放不再需要的资源。	Redis 5.0及以上 ValKey 8.0
ScanSlaveNode	启用该参数后，扫描类命令（如 SCAN、KEYS、HSCAN、SSCAN、ZSCAN）将被路由到从节点执行，避免大量遍历操作阻塞主节点，提升集群整体性能。 yes：开启。 no：不开启。默认值为 no。	Redis 4.0及以上 ValKey 8.0
ClusterNodeAdaptive	启用该参数后，CLUSTER NODES 命令将返回各节点的槽位分配信息，便于客户端感知集群拓扑结构。 yes：返回结果包含 slot 信息。 no：返回结果不含 slot 信息。默认值为 no。	Redis 4.0及以上 ValKey 8.0
read-local-node-only	当实例为多可用区部署时，该参数指定是否开启或关闭就近访问功能。	Redis 4.0及以上 ValKey 8.0
sentineauth	该参数控制当使用 sentinel 命令与 Redis Sentinel 进行交互时，是否省略分布式缓存数据库的密码，而自动使用在 Sentinel 配置文件中指定的 sentinelauth 参数所对应的密码。	Redis 6.2及以上 ValKey 8.0
set-max-intset-entries	当 set 集合对象同时符合以下2个条件时，会使用 intset 编码：集合对象所有数据都是字符串。恰好均是基数为10的整数，范围为64位有符号整数。	Redis 2.8及以上 ValKey 8.0
slowlog-log-slower-than	设置慢日志的记录阈值，即设置对执行时间大于多少毫秒的操作进行记录。
timeout	当客户端连接闲置时间达到该指定值时，将关闭连接，单位为秒（s）。
zset-max-ziplist-entries	当排序集合对象同时满足以下两个条件时，排序集合对象将使用 ziplist 编码：排序集合对象的每个元素的字符串长度的字节数，均小于 zset-max-ziplist-value 指定值。排序集合对象的元素数量，均小于 zset-max-ziplist-entries 指定值。
zset-max-ziplist-value	当排序集合对象同时满足以下两个条件时，排序集合对象将使用 ziplist 编码：排序集合对象的每个元素的字符串长度的字节数，均小于 zset-max-ziplist-value 指定值。排序集合对象的元素数量，均小于 zset-max-ziplist-entries 指定值。
notify-keyspace-events	notify-keyspace-events 的参数是下列字符的任意组合，定义了服务器将发送哪些类型的通知。字符：发送的通知。 K：键空间通知，所有通知以__keyspace@<db>__为前缀。 E：键事件通知，所有通知以__keyevent@<db>__为前缀。 g：DEL、EXPIRE、RENAME 等类型无关的通用命令的通知。 $：字符串命令的通知。 l：列表命令的通知。 s：集合命令的通知。 h：哈希命令的通知。 z：有序集合命令的通知。 x：过期事件，每当有过期键被删除时发送。 e：驱逐（evict）事件，每当有键因为 maxmemory 策略而被删除时发送。 A：参数 g$lshzxe 的别名。开启键空间通知将消耗 CPU 计算资源，故该通知默认关闭。如果定义服务器发送某些通知，输入参数需必选 K 或 E；如订阅键事件中驱逐事件相关的通知，参数填写为“Ee”；如订阅发送所有类型的通知，参数填写为“AKE”。
list-max-ziplist-entries	当链表对象同时满足以下两个条件时，链表对象将使用 ziplist 编码：链表对象保存的每个元素的字符串长度的字节数，均小于 list-max-ziplist-value 指定值。链表集合对象保存的元素数量，均小于 list-max-ziplist-entries 指定值。	Redis 2.8
list-max-ziplist-value	当链表对象同时满足以下两个条件时，链表对象将使用 ziplist 编码：链表对象保存的每个元素的字符串长度的字节数，均小于 list-max-ziplist-value 指定值。链表集合对象保存的元素数量，均小于 list-max-ziplist-entries 指定值。	Redis 2.8

tencent cloud

腾讯云分布式缓存数据库（兼容 Redis）

可配置的参数列表

﻿

帮助和支持