redis CLIENT SETNAME命令

client

英 [ˈklaɪənt]   美 [ˈklaɪənt]  

n.顾客;当事人;诉讼委托人;[计算机]客户端

复数： clients

set

英 [set]   美 [sɛt]  

vt.设置;放置，安置;使处于某种状况;摆放餐具

vi.落山;出发;凝结

n.集合;一套，一副;布景;电视机

adj.固定的;位于…的;顽固的;安排好的

第三人称单数： sets 复数： sets 现在分词： setting 过去式： set 过去分词： set

name

英 [neɪm]   美 [nem]  

n.名字;名声;有…名称的;著名的人物

vt.确定;决定;给…取名;说出…的名字

adj.著名的;据以取名

第三人称单数： names 复数： names 现在分词： naming 过去式： named 过去分词： named

redis CLIENT SETNAME命令 语法

作用：为当前连接分配一个名字。

语法：CLIENT SETNAME connection-name

说明：这个名字会显示在 CLIENT LIST 命令的结果中， 用于识别当前正在与服务器进行连接的客户端。在 Redis 应用程序发生连接泄漏时，为连接设置名字是一种很好的 debug 手段。

可用版本：>= 2.6.9

时间复杂度：O(1)

返回：设置成功时返回 OK 。

redis CLIENT SETNAME命令 示例

# 新连接默认没有名字
redis 127.0.0.1:6379> CLIENT GETNAME
(nil)
# 设置名字
redis 127.0.0.1:6379> CLIENT SETNAME hello-world-connection
OK
# 返回名字
redis 127.0.0.1:6379> CLIENT GETNAME
"hello-world-connection"
# 在客户端列表中查看
redis 127.0.0.1:6379> CLIENT LIST
addr=127.0.0.1:36851
fd=5
name=hello-world-connection     # <- 名字
age=51
...
# 清除名字
redis 127.0.0.1:6379> CLIENT SETNAME        # 只用空格是不行的！
(error) ERR Syntax error, try CLIENT (LIST | KILL ip:port)
redis 127.0.0.1:6379> CLIENT SETNAME ""     # 必须双引号显示包围
OK
redis 127.0.0.1:6379> CLIENT GETNAME        # 清除完毕
(nil)