CLIENT SETNAME connection-name
起始版本:2.6.9
時(shí)間復(fù)雜度:O(1)
命令CLIENT SETNAME 為當(dāng)前連接分配一個(gè)名字。
這個(gè)名字會顯示在CLIENT LIST命令的結(jié)果中, 用于識別當(dāng)前正在與服務(wù)器進(jìn)行連接的客戶端倍试。
舉個(gè)例子, 在使用 Redis 構(gòu)建隊(duì)列(queue)時(shí)菠剩, 可以根據(jù)連接負(fù)責(zé)的任務(wù)(role)易猫, 為信息生產(chǎn)者(producer)和信息消費(fèi)者(consumer)分別設(shè)置不同的名字耻煤。
名字使用 Redis 的字符串類型來保存具壮, 最大可以占用 512 MB 准颓。 另外, 為了避免和CLIENT LIST 命令的輸出格式發(fā)生沖突棺妓, 名字里不允許使用空格攘已。
要移除一個(gè)連接的名字怜跑, 可以將連接的名字設(shè)為空字符串 “” 。
使用 CLIENT GETNAME 命令可以取出連接的名字峡眶。
新創(chuàng)建的連接默認(rèn)是沒有名字的植锉。
提示:在 Redis 應(yīng)用程序發(fā)生連接泄漏時(shí),為連接設(shè)置名字是一種很好的 debug 手段狮暑。
返回值
simple-string-reply: 連接名稱設(shè)置成功返回OK.