- 用法
-
CLIENT SETNAME 连接名
- 复杂度
- O(1)
- 起始版本
- 2.6.9
- ACL 类别
- @connection, @slow
CLIENT SETNAME
命令为当前连接分配一个名称。
分配的名称会显示在 CLIENT LIST
的输出中,以便能够识别执行给定连接的客户端。
例如,当 Valkey 用于实现队列时,消息的生产者和消费者可以根据其角色设置连接的名称。
除非受限于 String 类型(512 MB)的常见限制,否则可分配的名称长度没有限制。但是,连接名称中不能使用空格,因为这会违反 CLIENT LIST
回复的格式。
可以通过将其设置为空字符串来完全删除连接名称,空字符串本身不是有效的连接名称,因为它专门用于此目的。
可以使用 CLIENT GETNAME
检查连接名称。
每个新连接启动时都没有分配名称。
提示:为连接设置名称是调试使用 Valkey 的应用程序中由于错误导致的连接泄漏的好方法。
RESP2/RESP3 回复
简单字符串回复:如果连接名称设置成功,则为 OK
。