RENAMENX
Syntax
RENAMENX key newkey
- Available since:
- 1.0.0
- Time complexity:
- O(1)
- ACL categories:
-
@keyspace
,@write
,@fast
,
Renames key
to newkey
if newkey
does not yet exist.
It returns an error when key
does not exist.
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
RESP2/RESP3 Reply
One of the following:
- Integer reply:
1
if key was renamed to newkey. - Integer reply:
0
if newkey already exists.
History
- Starting with Redis version 3.2.0: The command no longer returns an error when source and destination names are the same.