Redis RENAME-Befehl

Redis-Schlüssel

Der Redis RENAME-Befehl wird verwendet, um den Namen eines Schlüssels zu ändern.

Syntax

Die grundlegende Syntax des Redis RENAME-Befehls lautet wie folgt:

redis 127.0.0.1:6379> RENAME OLD_KEY_NAME NEW_KEY_NAME

Verfügbare Versionen

>= 1.0.0

Rückgabewert

Gibt OK zurück, wenn die Umbenennung erfolgreich ist, und gibt einen Fehler zurück, wenn sie fehlschlägt.

Wenn OLD_KEY_NAME und NEW_KEY_NAME identisch sind oder wenn OLD_KEY_NAME nicht existiert, wird ein Fehler zurückgegeben. Wenn NEW_KEY_NAME bereits existiert, überschreibt der RENAME-Befehl den alten Wert.

Beispiele

Beispiele

# key existiert und newkey existiert nicht

redis> SET message "hello world"
Gut

redis> RENAME message greeting
Gut

redis> EXISTS message               # message existiert nicht mehr
(integer) 0

redis> EXISTS greeting              # greeting nimmt seinen Platz ein
(integer) 1


# gibt einen Fehler zurück, wenn der Schlüssel nicht existiert

redis> RENAME fake_key never_exists
(error) ERR no such key


# wenn newkey bereits existiert, überschreibt RENAME den alten newkey

redis> SET pc "lenovo"
Gut

redis> SET personal_computer "dell"
Gut

redis> RENAME pc personal_computer
Gut

redis> GET pc
(nil)

redis> GET personal_computer      # der ursprüngliche Wert dell wurde überschrieben
"lenovo"

Redis-Schlüssel

Weitere Erweiterungen