Renames a key and overwrites the destination.
RENAME
key newkey
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.
Simple string
reply: OK
.
O(1)
@keyspace @slow @write
127.0.0.1:6379> SET mykey "Hello"
OK
127.0.0.1:6379> RENAME mykey myotherkey
OK
127.0.0.1:6379> GET myotherkey
"Hello"
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, RENAMENX, RESTORE, SCAN, SORT, SORT_RO, TOUCH, TTL, TYPE, UNLINK, WAIT, WAITAOF.