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