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