# 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 的应用程序中的错误而导致的连接泄漏的好方法。

# 返回

简单字符串回复:OK如果连接名称设置成功。

# 反馈

如果您在此页面上发现问题,或有改进建议,请提交请求以合并或打开存储库中的问题。

Last Updated: 4/18/2023, 8:45:33 AM