Renames a key only when the target key name doesn’t exist.
RENAMENX
key
newkey
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.
One of the following:
Integer reply:
1
if key was renamed to newkey.
Integer reply:
0
if newkey already exists.
O(1)
@fast @keyspace @write
127.0.0.1:6379> SET mykey "Hello"
OK
127.0.0.1:6379> SET myotherkey "World"
OK
127.0.0.1:6379> RENAMENX mykey myotherkey
(integer) 0
127.0.0.1:6379> GET myotherkey
"World"
COPY, DEL, DUMP, EXISTS, EXPIRE, EXPIREAT, EXPIRETIME, KEYS, MIGRATE, MOVE, OBJECT, OBJECT ENCODING, OBJECT FREQ, OBJECT HELP, OBJECT IDLETIME, OBJECT REFCOUNT, PERSIST, PEXPIRE, PEXPIREAT, PEXPIRETIME, PTTL, RANDOMKEY, RENAME, RESTORE, SCAN, SORT, SORT_RO, TOUCH, TTL, TYPE, UNLINK, WAIT, WAITAOF.