客户端设置名称
Syntax
CLIENT SETNAME connection-name
- Available since:
- 2.6.9
- Time complexity:
- O(1)
- ACL categories:
-
@slow
,@connection
,
CLIENT SETNAME
命令为当前连接分配一个名称。
分配的名称显示在CLIENT LIST
的输出中,以便可以识别执行给定连接的客户端。
例如,当Redis用于实现队列时,消息的生产者和消费者可能希望根据他们的角色设置连接的名称。
如果没有Redis字符串类型的通常限制(512 MB),可以分配的名称长度没有限制。然而,不能在连接名称中使用空格,因为这会违反CLIENT LIST
回复的格式。
可以完全移除连接名称设置,将其设置为空字符串,这不是一个有效的连接名称,因为它用于此特定目的。
可以使用CLIENT GETNAME
来检查连接名称。
每个新连接开始时都没有分配名称。
提示:为连接设置名称是调试由于使用Redis的应用程序中的错误导致的连接泄漏的好方法。
RESP2/RESP3 回复
Simple string reply:OK
if the connection name was successfully set.