CLIENT SETNAME · W3School Redis 教程 & 命令參考

# CLIENT SETNAME **CLIENT SETNAME connection-name** 為當前連接分配一個名字。這個名字會顯示在 [_CLIENT LIST_](client_list.html#client-list) 命令的結果中，用于識別當前正在與服務器進行連接的客戶端。舉個例子，在使用 Redis 構建隊列（queue）時，可以根據連接負責的任務（role），為信息生產者（producer）和信息消費者（consumer）分別設置不同的名字。名字使用 Redis 的字符串類型來保存，最大可以占用 512 MB 。另外，為了避免和 [_CLIENT LIST_](client_list.html#client-list) 命令的輸出格式發生沖突，名字里不允許使用空格。要移除一個連接的名字，可以將連接的名字設為空字符串 `""` 。使用 [_CLIENT GETNAME_](client_getname.html#client-getname) 命令可以取出連接的名字。新創建的連接默認是沒有名字的。 Tip 在 Redis 應用程序發生連接泄漏時，為連接設置名字是一種很好的 debug 手段。 **可用版本** >= 2.6.9 **時間復雜度** O(1) **返回值** 設置成功時返回 `OK` 。 ``` # 新連接默認沒有名字 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) ```