RENAMENX

Syntax
RENAMENX key newkey
Available since:
Redis Open Source 1.0.0
Time complexity:
O(1)
ACL categories:
@keyspace, @write, @fast,
Compatibility:
Redis Enterprise and Redis Cloud compatibility

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

SET mykey "Hello" SET myotherkey "World" RENAMENX mykey myotherkey GET myotherkey

Redis Enterprise and Redis Cloud compatibility

Redis
Enterprise		 Redis
Cloud		 Notes
✅ Standard
✅ Active-Active		 ✅ Standard
✅ Active-Active		 For Active-Active or clustered databases, the original key and new key must be in the same hash slot.

Return information

One of the following:

History

  • Starting with Redis version 3.2.0: The command no longer returns an error when source and destination names are the same.
RATE THIS PAGE
Back to top ↑