如何配置 Azure Redis 缓存

本文介绍可用于 Azure Cache for Redis 实例的配置。 本文还将介绍适用于 Azure Cache for Redis 实例的默认 Redis 服务器配置。

配置 Azure Redis 缓存设置

1. 若要创建缓存，请登录到 Azure 门户并选择“创建资源” 。

   

2. 在“入门”页上的搜索框中键入“Azure Cache for Redis”。 然后选择创建。

   

3. 在“新建 Redis 缓存”页上配置缓存的设置。

   设置	选择值	说明
   订阅	单击下拉箭头并选择你的订阅。	要在其下创建此新的 Azure Cache for Redis 实例的订阅。
   资源组	单击下拉箭头并选择一个资源组，或者选择新建并输入新的资源组名称。	要在其中创建缓存和其他资源的资源组的名称。 将所有应用资源放入一个资源组可以轻松地统一管理或删除这些资源。
   DNS 名称	输入唯一名称。	缓存名称必须是包含 1 到 63 个字符的字符串，只能包含数字、字母或连字符。 该名称必须以数字或字母开头和结尾，且不能包含连续的连字符。 缓存实例的主机名是 <DNS name>.redis.cache.chinacloudapi.cn。
   位置	单击下拉箭头并选择一个位置。	选择使用缓存的其他服务附近的区域。
   缓存 SKU	打开下拉列表并选择一个 SKU。	此 SKU 决定可用于缓存的大小、性能和功能参数。 有关详细信息，请参阅用于 Redis 的 Azure 缓存概述。
   缓存大小	打开下拉列表并选择缓存的大小	有关详细信息，请参阅用于 Redis 的 Azure 缓存概述。

4. 选择网络选项卡，或选择网络按钮（位于页面底部） 。

5. 在网络选项卡中，选择你的连接方法。

6. 选择“下一步: 高级”选项卡，或选择页面底部的“下一步: 高级”按钮，以查看“高级”选项卡。

   

   • 对于“基本”或“标准”缓存，请切换非 TLS 端口的选项。 还可以选择是否要启用“Microsoft Entra 身份验证”。
   • 对于“高级”缓存，请配置非 TLS 端口、群集、托管标识和数据持久性的设置。 还可以选择是否要启用“Microsoft Entra 身份验证”。

7. 选择下一步: 标记选项卡，或选择页面底部的下一步: 标记按钮 。

8. 或者，在标记选项卡中，如果希望对资源分类，请输入名称或值。

9. 选择查看 + 创建。 随后你会转到“查看 + 创建”选项卡，Azure 将在此处验证配置。

10. 显示绿色的“已通过验证”消息后，选择创建。

创建缓存需要一段时间。 可以在 Azure Cache for Redis 的概述页上监视进度。 如果“状态”显示为“正在运行”，则表示该缓存可供使用。

可使用“资源菜单” 查看和配置以下设置。 你看到的设置取决于缓存的层。

• 概述
• 活动日志
• 访问控制 (IAM)
• 标记
• 诊断和解决问题
• 事件
• 设置
  • 身份验证
  • 高级设置
  • 缩放
  • 群集大小
  • 数据持久性
  • 标识
  • 计划更新
  • 异地复制
  • 虚拟网络
  • 专用终结点
  • 防火墙
  • 属性
  • 锁定
• 管理
  • 导入数据
  • 导出数据
  • 重新启动
• 监视
• 自动化
  • 任务（预览版）
  • 导出模板
• 支持和故障排除设置
  • 资源运行状况
  • 新建支持请求

概述

“概述”部分提供有关缓存的基本信息，如名称、端口、定价层，以及所选的缓存指标。

活动日志

选择“活动日志”查看对缓存执行的操作。 也可以使用筛选来展开此视图，以包含其他资源。 有关如何使用审核日志的详细信息，请参阅使用资源管理器审核操作。 有关监视活动日志的详细信息，请参阅 Azure日志。

访问控制 (IAM)

“访问控制 (IAM)”部分在 Azure 门户中为 Azure 基于角色的访问控制 (Azure RBAC) 提供支持。 此配置有助于组织轻松准确地满足其访问管理要求。 有关详细信息，请参阅 Azure 门户中 Azure 基于角色的访问控制。

标记

“标记” 部分可帮助用户整理资源。 有关详细信息，请参阅使用标记来组织 Azure 资源。

诊断并解决问题

选择“诊断并解决问题”可显示常见问题和用于解决这些问题的策略。

事件

选择“事件”以将事件订阅添加到缓存。 通过 Azure 中内置的完全托管的事件路由服务，使用事件构建事件驱动的反应式应用。

事件网格可帮助你在云基础结构中构建自动化、创建无服务器应用以及跨服务和云集成。 有关详细信息，请参阅什么是 Azure 事件网格？。

Redis 控制台

可以使用“Redis 控制台”向 Azure Cache for Redis 实例安全地发出命令，此操作在 Azure 门户中适用于基本、标准和高级缓存层。

若要访问 Redis 控制台，请在“资源”菜单的工作窗格中选择“控制台”选项卡。

若要针对缓存实例发出命令，请在控制台中键入所需的命令。

配合使用 Redis 控制台和高级群集缓存

配合使用 Redis 控制台和高级群集缓存时，可向缓存的单个分片发出命令。 若要向特定的分片发出命令，请先在分片选取器中选择所需的分片，以连接到该分片。

如果尝试访问存储在不同分片（而非已连接的分片）中的密钥，将收到类似于以下消息的错误消息：

shard1>get myKey
(error) MOVED 866 13.90.202.154:13000 (shard 0)
shard1>get myKey
(error) MOVED 866 13.90.202.154:13000 (shard 0)

在之前的示例中，分片 1 为所选分片，但如错误消息的 (shard 0) 部分所述，myKey 位于分片 0 中。 在此示例中，若要访问 myKey，请使用分片选取器选择分片 0，然后发出所需命令。

将缓存移动到新的订阅

可以选择“移动”，将缓存移到新的订阅。

有关在资源组之间以及订阅之间移动资源的信息，请参阅将资源移到新的资源组或订阅。

设置

“设置” 部分用于访问和配置缓存的下列设置。

• 身份验证
• 高级设置
• 缩放
• 群集大小
• 数据持久性
• 计划更新
• 异地复制
• 专用终结点
• 虚拟网络
• 防火墙
• 属性
• 锁定

身份验证

有两个选项用于身份验证：访问密钥和 Microsoft Entra 身份验证。

高级设置

以下设置是在左侧的“高级设置”上配置的。

• 访问端口
• 内存策略
• 密钥空间通知（高级设置）

访问端口

默认情况下，将为新缓存禁用非 TLS/SSL 访问。 若要启用非 TLS 端口，请对左侧“高级设置”上的“仅允许通过 SSL 访问”选择“否”，然后选择“保存” 。

内存策略

使用左侧“资源”菜单中“高级设置”上的“Maxmemory policy”、“maxmemory-reserved”和“maxfragmentationmemory-reserved”设置，为缓存配置内存策略。 创建缓存时，值 maxmemory-reserved 和 maxfragmentationmemory-reserved 默认为 maxmemory（即缓存大小）的 10%。

“Maxmemory policy” 用于为缓存配置逐出策略，并允许你从以下逐出策略中进行选择：

• volatile-lru：默认逐出策略。 它删除含过期设置的所有密钥中最近很少使用的密钥。
• allkeys-lru：删除最近很少使用的密钥。
• volatile-random：删除含过期设置的随机密钥。
• allkeys-random：删除一个随机密钥。
• volatile-ttl：删除基于其过期设置将最快过期的密钥。
• noeviction：无逐出策略。 如果尝试插入数据，则返回一条错误消息。
• volatile-lfu：从设置了过期字段的所有密钥中删除最不常用的密钥。
• allkeys-lfu：从所有密钥中删除最不常用的密钥。

有关 maxmemory 策略的详细信息，请参阅 Eviction policies（逐出策略）。

“maxmemory-reserved”设置用于配置群集中保留给非缓存操作（例如故障转移期间的复制）的每个实例的内存量（以 MB 为单位）。 设置此值能够在负载变化时具有更一致的 Redis 服务器体验。 对于写入大量数据的工作负载，应将此值设置得较大。 为此类操作保留内存后，无法存储缓存数据。 滑块上的最小值和最大值分别为 10% 和 60%，以 MB 为单位显示。 设置的值必须在此范围内。

“maxfragmentationmemory-reserve”设置用于配置群集中保留以容纳内存碎片的每个实例的内存量（以 MB 为单位）。 设置此值后，当缓存已满或接近满的状态并且碎片比率很高时，Redis 服务器体验更加稳定。 为此类操作保留内存后，无法存储缓存数据。 滑块上的最小值和最大值分别为 10% 和 60%，以 MB 为单位显示。 设置的值必须在此范围内。

在选择新的内存预留值（maxmemory-reserved 或 maxfragmentationmemory-reserved）时，请注意此更改可能会如何影响已在运行的包含大量数据的缓存。 例如，如果你的 53 GB 缓存中已有 49 GB 数据，那么，将预留值更改为 8 GB 后，此更改会将系统的最大可用内存降至 45 GB。 如果你的当前 used_memory 或 used_memory_rss 值高于 45 GB 的新限制，则系统必须逐出数据，直到 used_memory 和 used_memory_rss 均低于 45 GB。 逐出可能会增加服务器负载和内存碎片。 有关缓存指标（例如，used_memory 和 used_memory_rss）的更多信息，请参阅创建自己的指标。

密钥空间通知（高级设置）

Redis 密钥空间通知是左侧的“高级设置”中配置的。 密钥空间通知让客户端能够在发生特定事件时接收通知。

）

有关详细信息，请参阅 Redis Keyspace Notifications（Redis 密钥空间通知）。 有关示例代码，请参阅 Hello world 示例中的 KeySpaceNotifications.cs 文件。

缩放

选择“缩放”可查看或更改缓存的定价层。 有关缩放的详细信息，请参阅如何缩放 Azure Redis 缓存。

群集大小

选择“群集大小”可更改正在运行且已启用群集的高级缓存的群集大小。

若要更改群集大小，请使用滑块，或在“分片计数”文本框中键入 1 到 10 之间的数字。 然后选择“确定”以保存。

数据持久性

选择“数据持久性”可启用、禁用或配置高级缓存的数据持久性。 Azure Redis 缓存通过 RDB 持久性或 AOF 持久性提供 Redis 持久性。

有关详细信息，请参阅如何为高级 Azure Redis 缓存配置持久性。

标识

使用“标识”配置托管标识。 托管标识是 Azure 中的一种常用工具，可帮助开发人员最大程度地减轻管理机密和登录信息的负担。

目前，只能将托管标识用于存储。 有关详细信息，请参阅用于存储的托管标识。

计划更新

可通过“计划更新”部分选择一个维护时段，以便针对缓存进行 Redis 服务器更新。

若要指定维护时段，请选中所需的天数。 然后指定每天的维护时段开始时间并选择“确定”。 维护时段使用 UTC 时间。

有关详细信息和说明，请参阅更新通道和计划更新。

异地复制

“资源”菜单上的“异地复制”提供了一种用于链接两个高级层 Azure Cache for Redis 实例的机制。 一个缓存名为主链接缓存，另一个缓存名为辅助链接缓存。 辅助链接缓存将变为只读，写入主缓存的数据将复制到辅助链接缓存。 此功能可用于跨 Azure 区域复制缓存。

虚拟网络

“虚拟网络” 部分用于配置缓存的虚拟网络设置。 虚拟网络仅限于高级缓存。 有关利用 VNET 支持创建高级缓存并更新其设置的信息，请参阅如何配置高级 Azure Redis 缓存的虚拟网络支持。

专用终结点

使用“专用终结点”部分，可以为缓存配置专用终结点设置。 所有缓存层（基本、标准和高级）均支持专用终结点。 建议使用专用终结点而不是 VNet。 专用终结点易于设置或删除，在所有层上都受支持，并且可以一次将缓存连接到多个不同的 VNet。

有关详细信息，请参阅使用 Azure 专用链接的 Azure Cache for Redis。

防火墙

• 防火墙规则配置适用于所有层：基本、标准和高级。

选择“防火墙”可查看和配置缓存的防火墙规则。

可以指定具有开始和结束 IP 地址范围的防火墙规则。 配置防火墙规则时，仅指定 IP 地址范围内的客户端连接可以连接到缓存。 保存防火墙规则后，规则生效前会出现短暂的延迟。 延迟通常不超过 1 分钟。

属性

选择“属性”可查看有关缓存的信息，包括缓存终结点和端口。

锁定

“锁定” 部分可用来锁定订阅、资源组或资源，以防止组织中的其他用户意外删除或修改关键资源。 更多信息请参阅 使用 Azure Resource Manager 锁定资源。

管理设置

可以通过“管理” 部分的设置针对缓存执行以下管理任务。

• 导入数据
• 导出数据
• 重新启动

导入/导出

导入/导出是一项 Azure Cache for Redis 数据管理操作，可用于在缓存中导入和导出数据。 可以将 Azure Cache for Redis 数据库 (RDB) 快照从高级缓存导入和导出到 Azure 存储帐户的页 blob 中。 使用导入/导出可在不同的 Azure Redis 缓存实例之间进行迁移，或者在使用之前使用数据填充缓存。

可以将导入用于在任何云或环境中运行的任何 Redis 服务器中与 Redis 兼容的 RDB 文件：

• 包括 Linux 上运行的 Redis
• Windows
• 任何云提供商，如 Amazon Web Services 等

导入数据是使用预先填充的数据创建缓存的一种简单方式。 在导入过程中，Azure Redis 缓存从 Azure 存储将 RDB 文件加载到内存中，再将密钥插入到缓存中。

可以使用导出将 Azure Redis 缓存中存储的数据导出到与 Redis 兼容的 RDB 文件。 可以使用此功能将一个 Azure Redis 缓存实例中的数据移到另一个 Azure Redis 缓存实例或另一个 Redis 服务器。 在导出过程中，会在托管 Azure Cache for Redis 服务器实例的 VM 上创建临时文件。 临时文件将上传到指定的存储帐户。 导出操作完成后，无论状态为成功还是失败，都会删除临时文件。

重新启动

可通过“重新启动”项来重新启动缓存的节点。 如果有缓存节点发生故障，此重新启动功能可用于测试应用程序的复原能力。

如果高级缓存启用了群集功能，则可选择要重新启动的缓存分片。

若要重新启动缓存的一个或多个节点，请选择所需节点，然后选择“重新启动”。 如果高级缓存启用了群集功能，请选择要重新启动的分片，然后选择“重新启动”。 几分钟后，所选节点将重新启动，再过几分钟后，又会回到联机状态。

监视

“监视”部分用于配置 Azure Cache for Redis 实例的诊断和监视。

• 有关 Azure Cache for Redis 监视和诊断的详细信息，请参阅监视 Azure Cache for Redis。
• 要了解如何设置和使用 Azure Cache for Redis 监视和诊断，请参阅监视 Azure Cache for Redis。

Insights

使用“见解”查看预定义磁贴和图表组，以用作缓存指标的起点。 有关详细信息，请参阅 Insights。

指标

选择“指标”以创建你自己的自定义图表，用于跟踪要查看的缓存指标。 有关详细信息，请参阅创建自己的指标。

警报

选择“警报”可基于 Azure Cache for Redis 指标配置警报。 有关详细信息，请参阅创建警报。

诊断设置

默认情况下，Azure Monitor 中的缓存指标将存储 30 天，然后被删除。 若要将缓存指标保存 30 天以上，请选择“诊断设置”以配置存储帐户（用于存储缓存诊断数据）。

顾问建议

“顾问建议”显示适用于缓存的建议。 在正常操作期间，不会显示任何建议。

如果在缓存操作期间发生任何状况，例如即将发生的更改、高内存使用率、网络带宽或服务器负载，则“资源”菜单的“概述”中会显示警报。

可在 Azure 门户工作窗格中的“建议”上找到更多信息。

可以在“资源”菜单的监视部分监视这些指标。

Azure Redis 缓存指标	详细信息
网络带宽使用率	缓存性能 - 可用带宽
连接的客户端数	默认 Redis 服务器配置 - 最大客户端数
服务器负载	Redis 服务器负载
内存使用率	缓存性能 - 大小

若要升级缓存，请选择“立即升级”以更改定价层并缩放缓存。 有关选择定价层的详细信息，请参阅选择适当的层。

工作簿

将指标分为多个组，以便一致且有效地显示指标信息。

自动化

Azure 自动化提供基于云的自动化、操作系统更新和配置服务，用于支持 Azure 环境和非 Azure 环境之间的一致管理。

任务

选择“任务”可帮助你更轻松地管理 Azure Cache for Redis 资源。 这些任务的数量和可用性因资源类型而异。 目前，在预览版中，只能使用“发送资源的每月费用”模板创建任务。

导出模板

选择“导出模板”可生成并导出已部署资源的模板供将来部署。 有关使用模板的详细信息，请参阅使用 Azure Resource Manager 模板部署资源。

支持和故障排除设置

“支持 + 疑难解答” 部分中的设置提供了用于解决缓存问题的选项。

• 资源运行状况
• 新建支持请求

资源运行状况

“资源运行状况” 会监视资源，并告知资源是否按预期运行。 有关 Azure 资源运行状况服务的详细信息，请参阅 Azure 资源运行状况概述。

新建支持请求

选择“新建支持请求”可建立缓存的支持请求。

默认 Redis 服务器配置

新的 Azure Redis 缓存实例均已配置以下默认 Redis 配置值：

设置	默认值	说明
databases	16	默认的数据库数为 16，但可以根据定价层配置不同数目。1 默认数据库是 DB 0，可以基于每个连接使用 connection.GetDatabase(dbid)（其中 dbid 是介于 0 和 databases - 1 之间的数字）选择其他数据库。
maxclients	取决于定价层2	该值是同一时间内允许的最大已连接客户端数。 一旦达到该限制，Redis 会在关闭所有新连接的同时返回“达到客户端最大数量”的错误。
maxmemory-reserved	maxmemory 的 10%	maxmemory-reserved 的允许范围是 maxmemory 的 10% - 60%。 如果尝试将这些值设置为低于 10% 或高于 60%，则系统会重新评估这些值，并将其设置为最小值 10% 和最大值 60%。 这些值以兆字节为单位呈现。
maxfragmentationmemory-reserved	maxmemory 的 10%	maxfragmentationmemory-reserved 的允许范围是 maxmemory 的 10% - 60%。 如果尝试将这些值设置为低于 10% 或高于 60%，则系统会重新评估这些值，并将其设置为最小值 10% 和最大值 60%。 这些值以兆字节为单位呈现。
maxmemory-policy	volatile-lru	Maxmemory 策略是 Redis 服务器使用的一种设置，用来选择在达到 maxmemory（创建缓存时选择的缓存大小）时要删除的内容。 使用 Azure Cache for Redis 时，默认设置为 volatile-lru。 此设置使用 LRU 算法删除设置了过期时间的密钥。 可以在 Azure 门户中配置此设置。 有关详细信息，请参阅内存策略。
maxmemory-samples	3	LRU 算法和最小 TTL 算法都是近似算法而不是精确算法，这是为了节省内存。 默认情况下，Redis 会检查三个密钥并选取最近使用较少的一个。
lua-time-limit	5,000	Lua 脚本的最大执行时间（以毫秒为单位）。 如果达到最大执行时间，Redis 将记录脚本在达到最大允许时间后仍在执行，并开始以错误响应查询。
lua-event-limit	500	脚本事件队列的最大大小。
client-output-buffer-limit normal / client-output-buffer-limit pubsub	0 0 0 / 32mb 8mb 60	客户端输出缓冲区限制可用于强制断开与某些客户端的连接，这些客户端由于某种原因而无法以足够快的速度从服务器读取数据。 常见的原因是发布/订阅客户端使用消息的速度不如发布者生成消息的速度快。 有关详细信息，请参阅 https://redis.io/topics/clients。

数据库

¹每个 Azure Redis 缓存定价层的 databases 限制是不同的，可以在创建缓存时进行设置。 如果在创建缓存期间未指定 databases 设置，则默认值为 16。

• 基本缓存和标准缓存
  • C0 (250 MB) 缓存 - 最多支持 16 个数据库
  • C1 (1 GB) 缓存 - 最多支持 16 个数据库
  • C2 (2.5 GB) 缓存 - 最多支持 16 个数据库
  • C3 (6 GB) 缓存 - 最多支持 16 个数据库
  • C4 (13 GB) 缓存 - 最多支持 32 个数据库
  • C5 (26 GB) 缓存 - 最多支持 48 个数据库
  • C6 (53 GB) 缓存 - 最多支持 64 个数据库
• 高级缓存
  • P1 (6 GB - 60 GB) - 最多支持 16 个数据库
  • P2 (13 GB - 130 GB) - 最多支持 32 个数据库
  • P3 (26 GB - 260 GB) - 最多支持 48 个数据库
  • P4 (53 GB - 530 GB) - 最多支持 64 个数据库
  • P5 (120 GB - 1200 GB) - 最多支持 64 个数据库
  • 所有启用了 Redis 群集的高级缓存 - Redis 群集仅支持使用数据库 0，因此任何启用了 Redis 群集的高级缓存的 databases 限制实际上是 1，并且不允许使用 Select 命令。

有关数据库的详细信息，请参阅什么是 Redis 数据库？

Maxclients

²maxclients 属性对于每个 Azure Cache for Redis 定价层都是不同的。

• 基本缓存和标准缓存
  • C0 (250 MB) 缓存 - 最多支持 256 个连接
  • C1 (1 GB) 缓存 - 最多支持 1,000 个连接
  • C2 (2.5 GB) 缓存 - 最多支持 2,000 个连接
  • C3 (6 GB) 缓存 - 最多支持 5,000 个连接
  • C4 (13 GB) 缓存 - 最多支持 10,000 个连接
  • C5 (26 GB) 缓存 - 最多支持 15,000 个连接
  • C6 (53 GB) 缓存 - 最多支持 20,000 个连接
• 高级缓存
  • P1 (6 GB - 60 GB) - 最多支持 7,500 个连接
  • P2 (13 GB - 130 GB) - 最多支持 15,000 个连接
  • P3 (26 GB - 260 GB) - 最多支持 30,000 个连接
  • P4 (53 GB - 530 GB) - 最多支持 40,000 个连接
  • P5 (120 GB - 1200 GB) - 最多支持 40,000 个连接

Azure Redis 缓存中不支持 Redis 命令

Azure Cache for Redis 实例的配置和管理由 Microsoft 负责，这会禁用以下命令。 如果尝试调用它们，将收到一条类似于 "(error) ERR unknown command" 的错误消息。

• ACL
• BGREWRITEAOF
• BGSAVE
• CLUSTER - 群集写入命令已禁用，但允许使用只读群集命令。
• CONFIG
• DEBUG
• MIGRATE
• PSYNC
• REPLICAOF
• REPLCONF - Azure Redis 缓存实例不允许客户添加外部副本。 此命令通常仅由服务器发送。
• SAVE
• SHUTDOWN
• SLAVEOF
• 同步

对于使用活动异地复制的缓存实例，还会阻止以下命令，以防止意外丢失数据：

• FLUSHALL
• FLUSHDB

有关 Redis 命令的详细信息，请参阅 https://redis.io/commands。

相关内容

• 如何运行 Redis 命令？
• 监视用于 Redis 的 Azure 缓存