RENAMENX

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

redis> SET mykey "Hello"
Failed to fetch
redis> SET myotherkey "World"
Failed to fetch
redis> RENAMENX mykey myotherkey
Failed to fetch
redis> GET myotherkey
Failed to fetch

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.