English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Redis Rename Befehl

Redis key(键)

Der Redis Rename-Befehl wird verwendet, um den Namen eines Keys zu ändern.

Grammatik

Die Grundgrammatik des Redis Rename-Befehls ist wie folgt:

redis 127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME

Verfügbare Version

>= 1.0.0

Rückgabewert

Wenn der Umbenennungserfolg angezeigt wird, wird OK zurückgegeben, im Falle eines Fehlschlags wird ein Fehler zurückgegeben.

Wenn OLD_KEY_NAME und NEW_KEY_NAME gleich sind oder OLD_KEY_NAME nicht existiert, wird ein Fehler zurückgegeben. Wenn NEW_KEY_NAME bereits existiert, wird der Befehl RENAME den alten Wert überschreiben.

在线示例

# key 存在且 newkey 不存在

redis> SET message "hello world"
OK

redis> RENAME message greeting
OK

redis> EXISTS message # message 不复存在
&40;integer&41; 0

redis> EXISTS greeting # greeting 取而代之
&40;integer&41; 1


# 当 key 不存在时,返回错误

redis> RENAME fake_key never_exists
&40;error&41; ERR no such key


# newkey 已存在时, RENAME 命令将覆盖旧 newkey

redis> SET pc "lenovo"
OK

redis> SET personal_computer "dell"
OK

redis> RENAME pc personal_computer
OK

redis> GET pc
&40;nil&41;

redis:1> GET personal_computer # 原来的值 dell 被覆盖了
"lenovo"

Redis key(键)