RENAMENX key newkey

Redis Renamenx 命令用于在新的 key 不存在时修改 key 的名称 。若 key 不存在返回错误。

在集群模式下，key 和newkey 需要在同一个 hash slot。key 和newkey有相同的 hash tag 才能重命名。

*语法

redis Renamenx 命令基本语法如下：

redis 127.0.0.1:6379> RENAMENX OLD_KEY_NAME NEW_KEY_NAME

*历史

  • <= 3.2.0: 源 key 和目的 key 相同返回错误。

*返回值

整数, :

  • 1 rename 成功。
  • 0 newkey 已经存在。

*例子

# newkey 不存在，改名成功 redis>  SET mykey "Hello" 
"OK"
redis>  RENAMENX mykey myotherkey 
(integer) 1
redis>  GET myotherkey 
"Hello"
# newkey存在时，失败 redis>  SET animal "bear" 
"OK"
redis>  SET favorite_animal "butterfly" 
"OK"
redis>  RENAMENX animal favorite_animal 
(integer) 0
redis>  get animal 
"bear"
redis>  get favorite_animal 
"butterfly"
redis> 

可用版本>= 1.0.0.

时间复杂度: O(1)