文档中心

缓存数据库 Redis 版

过期 key 管理

立即清除过期 key

缓存数据库 Redis 版提供了过期 key 管理功能，支持一键扫描（SCAN）所有 key 并立即删除其中已过期的 key，来释放内存占用。本文介绍如何在控制台上立即清除过期 key。

前提条件

实例状态需为运行中。关于实例状态的更多详情，请参见实例状态。

注意事项

发起过期 key 清除任务后，系统会自动执行一次 SCAN 命令来扫描所有数据，此时实例的 CPU 负载会上升，可能会对实例性能产生影响，建议您在业务低峰期执行该任务。

操作步骤

参数	说明
每秒扫描过期 key 数量	设置每秒扫描过期 key 的数量，取值范围：2000~100000 内的整数。注意该参数值越大，扫描速度越快，但实例 CPU 负载也会越高。请根据业务可接受的性能影响程度合理设置。
扫描超时时间	设置扫描超时时间。取值范围：30-1440 内的整数，单位：分钟。

后续操作

过期 key 清除任务执行完毕后，您可以在过期 key 管理页签下的任务列表中查看本次清除任务详情，包括任务 ID、状态、分析的总分片数、已结束的分片数、任务创建时间、任务开始时间和任务结束时间等信息。

过期 key 清除任务执行完毕后，过期 key 将被删除，相应内存空间也会被释放。您可以前往实例监控告警页的聚合数据节点或数据节点页签查看内存使用率指标，与清除任务完成前相比，该监控指标数据会有所降低。查看监控数据的具体方法，请参见查看监控数据。

您可以在过期 key 清除任务执行过程中，随时手动取消清除任务，避免在业务高峰或资源紧张时期对 Redis 服务性能与稳定性的影响。具体操作步骤，请参见取消过期 key 清除任务。

API	说明
CreateKeyScanJob	调用 CreateKeyScanJob 接口为目标 Redis 实例创建过期 key 扫描任务。
DescribeKeyScanJobs	调用 DescribeKeyScanJobs 接口查询目标 Redis 实例在指定时间段内的扫描 key 任务列表。