rename
RENAME
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-
Note: Before Redis 3-2-0, an error is returned if source and destination names are the same-
Return value
Examples
redis> SET mykey "Hello"
"OK"
redis> RENAME mykey myotherkey "OK"
redis> GET myotherkey "Hello"
© 2009–2017 Salvatore Sanfilippo
Licensed under the Creative Commons Attribution-ShareAlike License 4.0.
https://redis.io/commands/rename