RENAME key newkey

可用版本： >= 1.0.0
时间复杂度： O(1)

将 key 改名为 newkey 。

当 key 和 newkey 相同，或者 key 不存在时，返回一个错误。

当 newkey 已经存在时， RENAME 命令将覆盖旧值。

返回值

改名成功时提示 OK ，失败时候返回一个错误。

代码示例

  1. # key 存在且 newkey 不存在
  2.  
  3. redis> SET message "hello world"
  4. OK
  5.  
  6. redis> RENAME message greeting
  7. OK
  8.  
  9. redis> EXISTS message               # message 不复存在
  10. (integer) 0
  11.  
  12. redis> EXISTS greeting              # greeting 取而代之
  13. (integer) 1
  14.  
  15.  
  16. # 当 key 不存在时，返回错误
  17.  
  18. redis> RENAME fake_key never_exists
  19. (error) ERR no such key
  20.  
  21.  
  22. # newkey 已存在时， RENAME 会覆盖旧 newkey
  23.  
  24. redis> SET pc "lenovo"
  25. OK
  26.  
  27. redis> SET personal_computer "dell"
  28. OK
  29.  
  30. redis> RENAME pc personal_computer
  31. OK
  32.  
  33. redis> GET pc
  34. (nil)
  35.  
  36. redis:1> GET personal_computer      # 原来的值 dell 被覆盖了
  37. "lenovo"