RENAME
Syntax
RENAME key newkey
- Available since:
- 1.0.0
- Time complexity:
- O(1)
- ACL categories:
-
@keyspace
,@write
,@slow
,
Renames key
to newkey
.
It returns an error when key
does not exist.
If newkey
already exists it is overwritten, when this happens RENAME
executes an implicit DEL
operation, so if the deleted key contains a very big value it may cause high latency even if RENAME
itself is usually a constant-time operation.
In Cluster mode, both key
and newkey
must be in the same hash slot, meaning that in practice only keys that have the same hash tag can be reliably renamed in cluster.
Examples
Behavior change history
>= 3.2.0
: The command no longer returns an error when source and destination names are the same.
RESP2/RESP3 Reply
Simple string reply:OK
.