支持的 Redis 配置

本页面介绍 Memorystore for Redis 可用的最大内存政策和其他 Redis 配置。如果调整了配置，不需要重启 Redis 实例。

如需了解如何修改下面列出的配置，请参阅配置 Redis 实例。

最大内存政策

当 Redis 实例内存已满且有新的写入时，Redis 会根据实例的最大内存政策逐出键，为写入腾出空间。Memorystore for Redis 的默认最大内存政策为 volatile-lru。您还可以使用以下最大内存政策之一：

  • noeviction：在 Redis 实例达到最大内存时返回错误。不会覆盖或逐出任何数据。
  • allkeys-lfu：适用于 Redis 4.0 或更高版本。从整个键集中逐出最不常用的 (LFU) 键。
  • allkeys-lru：从整个密钥集中逐出最近最少使用的 (LRU) 键。
  • volatile-lfu：适用于 Redis 4.0 或更高版本。逐出通过 TTL（存留时间）到期设置的最不常用的键。
  • volatile-lru：逐出通过 TTL 到期时间设置的最近最少使用的 (LRU) 键。
  • allkeys-random：逐出整个键空间中的随机键。
  • volatile-random：从通过 TTL 到期设置的那些键中逐出随机键。
  • volatile-ttl：从通过 TTL 到期设置的那些键中逐出 TTL 最短的键。

可修改的配置参数

您可以在创建或更新 Memorystore for Redis 实例时修改以下参数。


参数 说明 可接受的值
activedefrag Redis 4.0 或更高版本。用于释放通过标准 OSS Redis 内存碎片行为绑定的实例内存。 no（默认）
yes
无延迟-延迟驱逐 Redis 7.0 或更高版本。启用/停用延迟释放以便逐出。no 会停用此配置。如需了解详情，请参阅 REDIS.CONF no（默认）
yes
lazyfree-lazy-expire Redis 7.0 或更高版本。为过期启用/停用延迟释放。no 会停用此配置。如需了解详情，请参阅 REDIS.CONF no（默认）
yes
lazyfree-lazy-user-del Redis 7.0 或更高版本。为用户 DEL 启用/停用“懒人释放”功能。no 可停用此配置。如需了解详情，请参阅 REDIS.CONF no（默认）
yes
lazyfree-lazy-user-flush Redis 7.0 或更高版本。启用/停用用户刷新的延迟释放。no 会停用此配置。如需了解详情，请参阅 REDIS.CONF no（默认）
yes
lfu-decay-time Redis 4.0 或更高版本。给定键的 LFU 频率计数器将除以 2（或者，如果计数器小于 10，则递减 1）之前的时间，以分钟为单位。如需了解详情，请参阅 REDIS.CONF 文件。 “长”数据类型的正整数
（默认值 = 1）
lfu-log-factor Redis 4.0 或更高版本。确定频率计数器如何表示键命中数。在修改默认配置之前，请先了解 lfu-log-factor 配置如何在 REDIS.CONF 文件中工作。 “长”数据类型的正整数
（默认值 = 10）
maxmemory-clients Redis 7.0 或更高版本。此配置允许用户控制客户端的最大内存用量。

普通/pubsub 客户端的总内存用量。如果达到限制，则内存用量最大的客户端将被逐出		 默认值为 0%（无限制）。可接受的值为 0% 到 100% 之间的整数百分比值。表示客户端存储空间受限的实例最大内存百分比。
maxmemory-gb 指定您的逐出政策生效的可调整限制。例如，如果有一个 10 GB 实例并将 maxmemory-gb 设置为 8，则当数据占用 8 GB 实例内存时，逐出政策会生效。这样会余下 2 GB 的内存作为开销。默认情况下，maxmemory-gb 设置为您的实例容量。如需详细了解如何充分利用 maxmemory-gb 配置，请参阅 Memorystore 内存管理最佳实践。

此配置在 Google Cloud 控制台中显示为 maxmemory-percent。使用控制台时，您可以将 maxmemory-percent 设置为实例容量的百分比，而不是特定的 GB 数。		 以整数或小数表示的 GB 数。
示例：
10 指定 10 GB 的 maxmemory-gb。
1.5 指定 1.5 GB 的 maxmemory-gb。
maxmemory-gb 可以减少到实例容量的 20%。
maxmemory-policy 指定当实例数据达到 maxmemory-gb 限制时 Redis 遵循的行为。如需了解每个政策的行为，请参阅最大内存政策。

如需详细了解开源 Redis 最大内存政策，请参阅开源 Redis LRU 缓存页面		 noeviction
allkeys-lru
volatile-lru（默认）
allkeys-random
volatile-random
volatile-ttl
volatile-lfu（Redis 4.0 和更高版本）
allkeys-lfu（Redis 4.0 和更高版本）
notify-keyspace-events 允许客户端订阅某些键空间事件的通知。如需了解详情，请参阅 Redis 网站上的 Redis 键空间通知页面。 ""（默认）
K
键空间事件，使用 __keyspace@__ 前缀发布。
E
键空间事件，使用 __keyspace@__ 前缀发布。
g
一般命令（非特定于类型），例如 DEL、EXPIY 或 RENAME
$
String 命令
l
List 命令
s
Set 命令
h
Hash 命令
z
Sorted set 命令
x
过期事件（每次有键过期时生成的事件）
e
逐出事件（当为最大内存逐出键时，生成的事件）
A
g$lshzxe 的别名，因此“AKE”字符串表示所有事件。
stream-node-max-bytes Redis 5.0 或更高版本。 Redis 流式数据结构使用 Radix 树来存储内容。stream-node-max-bytes 参数指定可用于在单个树节点中存储内容的最大字节数。达到此限制后，新内容将存储在新的树节点中。 整数 0 及以上。
（默认值 = 4096）
0 指定无限大小的树节点。
stream-node-max-entries Redis 5.0 或更高版本。Redis 流式数据结构使用 Radix 树来存储内容。stream-node-max-entries 参数指定可以存储在单个节点中的内容数。当达到此限制时，新内容将存储在新的树节点中。 整数 0 及以上。
（默认值 = 100）
0 指定内容数不受限制的树节点。
timeout 空闲客户端连接终止前的秒数。不过，如果 timeout 设为 0，空闲客户端不会超时并会保持连接状态，直到客户端发出终止命令。 0（默认值）
整数 >= 120
单位 = 秒

不可修改的配置参数

下表列出了无法在 Memorystore for Redis 中修改的 Redis 配置参数及其默认值。如需详细了解这些配置参数，请参阅 Redis 配置文档。

参数 默认值
lua-time-limit 5000
hash-max-ziplist-entries 2048
hash-max-ziplist-value 1024
list-max-ziplist-size -2
list-compress-depth . 0
set-max-intset-entries 512
zset-max-ziplist-entries 1024
zset-max-ziplist-value 1024
hll-sparse-max-byte 3000
activerehashing 是
hz 10
databases 16
maxclients 65000
slowlog-log-slower-than 10000
slowlog-max-len 128
repl-diskless-load swapdb
io-threads-do-reads 是

后续步骤

  • 如要详细了解 Redis 配置，请参阅开源 Redis 配置页面