CLIENT SETINFO
语法
CLIENT SETINFO <LIB-NAME libname | LIB-VER libver>
- 可用版本
- Redis 开源版 7.2.0
- 时间复杂度
- O(1)
- ACL 类别
-
@slow
,@connection
,
CLIENT SETINFO
命令为当前连接分配各种信息属性,这些属性将显示在 CLIENT LIST
和 CLIENT INFO
命令的输出中。
客户端库应在所有连接通过身份验证后流水线执行此命令,并忽略可能的失败,因为它们可能连接到不支持此命令的旧版本。
当前支持的属性有
lib-name
- 用于保存正在使用的客户端库的名称。lib-ver
- 用于保存客户端库的版本。
这些属性的长度没有限制。但是,不能使用空格、换行符或其他不可打印字符,以免违反 CLIENT LIST
回复的格式。
官方客户端库允许使用自定义后缀扩展 lib-name
,以暴露有关客户端的更多信息。例如,像 redis-om-spring 这样的高级库可以报告其版本。最终的 lib-name
将是 jedis(redis-om-spring_v1.0.0)
。花括号用于分隔自定义后缀,应避免在后缀本身中使用花括号。我们建议第三方库的自定义后缀使用以下格式 (?<custom-name>[ -~]+)[ -~]v(?<custom-version>[\d\.]+)
,并使用 ;
来分隔多个后缀。
请注意,这些属性不会被 RESET 命令清除。
RESP2/RESP3 回复
简单字符串回复: 如果属性名称成功设置,则返回OK
。