Commande Redis RENAME
Clés RedisLa commande Redis RENAME est utilisée pour modifier le nom d'une clé.
Syntaxe
La syntaxe de base de la commande Redis RENAME est la suivante :
redis 127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME
Versions disponibles
>= 1.0.0
Valeur de retour
Renvoie OK lorsque le renommage réussit, et renvoie une erreur lorsqu'il échoue.
Lorsque OLD_KEY_NAME et NEW_KEY_NAME sont identiques, ou lorsque OLD_KEY_NAME n'existe pas, une erreur est renvoyée. Lorsque NEW_KEY_NAME existe déjà, la commande RENAME écrasera l'ancienne valeur.
Exemples
Exemples
# key existe et newkey n'existe pas
redis> SET message "hello world"
OK
redis> RENAME message greeting
OK
redis> EXISTS message # le message n'existe plus
(entier) 0
redis> EXISTS greeting # greeting prend sa place
(entier) 1
# renvoie une erreur lorsque la clé n'existe pas
redis> RENAME fake_key never_exists
(erreur) ERR no such key
# lorsque newkey existe déjà, RENAME écrase l'ancien newkey
redis> SET pc "lenovo"
OK
redis> SET personal_computer "dell"
OK
redis> RENAME pc personal_computer
OK
redis> GET pc
(nil)
redis> GET personal_computer # la valeur d'origine dell a été écrasée
"lenovo"
redis> SET message "hello world"
OK
redis> RENAME message greeting
OK
redis> EXISTS message # le message n'existe plus
(entier) 0
redis> EXISTS greeting # greeting prend sa place
(entier) 1
# renvoie une erreur lorsque la clé n'existe pas
redis> RENAME fake_key never_exists
(erreur) ERR no such key
# lorsque newkey existe déjà, RENAME écrase l'ancien newkey
redis> SET pc "lenovo"
OK
redis> SET personal_computer "dell"
OK
redis> RENAME pc personal_computer
OK
redis> GET pc
(nil)
redis> GET personal_computer # la valeur d'origine dell a été écrasée
"lenovo"
Autres extensions