CLIENT SETNAME

用法
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