• RENAME key newkey
    • 返回值
    • 代码示例

    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"