Redis CLIENT SETNAME命令

Redis CLIENT SETNAME命令教程

Redis 的 CLIENT SETNAME 命令用于为当前连接分配一个名字。这个名字会显示在 CLIENT LIST 命令的结果中，用于识别当前正在与服务器进行连接的客户端。

Redis 的 CLIENT SETNAME 的名字使用 Redis 的字符串类型来保存，最大可以占用 512 MB。另外，为了避免和 CLIENT LIST 命令的输出格式发生冲突，名字里不允许使用空格。

要移除一个连接的名字，可以将连接的名字设为空字符串 “” 。同时，使用 CLIENT GETNAME 命令可以取出连接的名字。

Redis CLIENT SETNAME命令详解

语法

192.168.98.70:6379> CLIENT SETNAME connection-name

参数

参数	描述
connection-name	要设置的连接的名字。

返回值

设置成功时返回 OK 。

时间复杂度

O(1)

可用版本

>=  2.6.9

案例

CLIENT SETNAME设置客户端连接名

使用 CLIENT SETNAME 命令设置客户端连接名

127.0.0.1:6379> CLIENT GETNAME
(nil)
127.0.0.1:6379> CLIENT SETNAME hello-haicoder
OK
127.0.0.1:6379> CLIENT GETNAME
"hello-haicoder"
127.0.0.1:6379>

我们首先使用 CLIENT GETNAME 获取当前客户端连接的名字，此时返回了默认值 nil，接着，我们使用了 CLIENT SETNAME 命令设置了当前连接的名字，并再次使用 CLIENT GETNAME 获取当前连接的名字，返回了我们设置的名字。

CLIENT SETNAME清空客户端连接名

使用 CLIENT SETNAME 命令清空客户端连接名

127.0.0.1:6379> CLIENT GETNAME
(nil)
127.0.0.1:6379> CLIENT SETNAME hello-haicoder
OK
127.0.0.1:6379> CLIENT GETNAME
"hello-haicoder"
127.0.0.1:6379> CLIENT SETNAME 
(error) ERR Unknown subcommand or wrong number of arguments for 'SETNAME'. Try CLIENT HELP
127.0.0.1:6379> CLIENT SETNAME ""
OK
127.0.0.1:6379> CLIENT GETNAME
(nil)

接着，我们再次使用 CLIENT SETNAME 后面不接任何参数，此时报错，因为我们使用 CLIENT SETNAME 命令清空客户端连接名，需要使用空字符串，所以接着，我们使用空字符串清空了连接名，并再次获取，此时返回了 nil，即我们清空了连接名。

Redis CLIENT SETNAME命令总结

Redis 的 CLIENT SETNAME 命令用于为当前连接分配一个名字。这个名字会显示在 CLIENT LIST 命令的结果中，用于识别当前正在与服务器进行连接的客户端。

要移除一个连接的名字，可以将连接的名字设为空字符串 “” 。同时，使用 CLIENT GETNAME 命令可以取出连接的名字。