ACL LOAD

从配置的 ACL 文件重新加载规则。

语法

ACL LOAD

引入版本:6.0.0

复杂度摘要:O(N)

当 Redis 配置为使用 ACL 文件(使用 aclfile 配置选项)时,此命令将从文件中重新加载 ACL,将所有当前 ACL 规则替换为文件中定义的规则。该命令确保具有 全有或全无 行为,即:

  • 如果文件中的每一行都有效,则加载所有 ACL。
  • 如果文件中的一行或多行无效,则不会加载任何内容,并继续使用服务器内存中定义的旧 ACL 规则。

从Redis 8.8开始,你的ACL文件允许有注释行;以 # 字符开头的行。加载 ACL 文件时,任何此类注释行都会被删除,并且它们不会在 ACL LOAD/ACL SAVE 命令中保留。确保保存 ACL 文件的备份。这是保留评论的唯一方法。

示例

> ACL LOAD
+OK

> ACL LOAD
-ERR /tmp/foo:1: Unknown command or category name in ACL...

Redis Software 与 Redis Cloud 兼容性

Redis
软件
Redis
Cloud
说明
❌ 标准
❌主动-主动
❌ 标准
❌主动-主动

返回值

RESP2

简单字符串回复:成功时OK。该命令可能会因多种原因而失败并出现错误:如果文件不可读,如果文件内部存在错误,在这种情况下,错误将在错误中报告给用户。最后,如果服务器未配置为使用外部 ACL 文件,该命令将失败。

RESP3

简单字符串回复:成功时OK。该命令可能会因多种原因而失败并出现错误:如果文件不可读,如果文件内部存在错误,在这种情况下,错误将在错误中报告给用户。最后,如果服务器未配置为使用外部 ACL 文件,该命令将失败。

资料来源:Redis 官方 ACL LOAD 文档;中文内容参考 Redis 文档许可。