Zum Hauptinhalt springen

Roher String Befehle

APPEND​

Syntax​

    APPEND key value

Wenn der Schlüssel bereits existiert und eine Zeichenkette ist, hängt dieser Befehl den Wert am Ende der Zeichenkette an. Wenn der Schlüssel nicht existiert, wird er erstellt und als leere Zeichenkette gesetzt.

RESP-Antwort​

Integer-Antwort: die Länge der Zeichenkette nach der Append-Operation.

DECR​

Syntax​

    DECR key

Dekrementiert die unter dem Schlüssel gespeicherte Zahl um eins. Wenn der Schlüssel nicht existiert, wird er vor der Ausführung der Operation auf 0 gesetzt. Ein Fehler wird zurückgegeben, wenn der Schlüssel einen Wert des falschen Typs enthält oder eine Zeichenkette enthält, die nicht als Ganzzahl dargestellt werden kann.

RESP-Antwort​

Integer-Antwort: der Wert des Schlüssels nach der Dekrementierung.

DECRBY​

Syntax​

    DECRBY key decrement

Dekrementiert die unter dem Schlüssel gespeicherte Zahl um den Wert des Parameters decrement. Wenn der Schlüssel nicht existiert, wird er vor der Ausführung der Operation auf 0 gesetzt. Ein Fehler wird zurückgegeben, wenn der Schlüssel einen Wert des falschen Typs enthält oder eine Zeichenkette enthält, die nicht als Ganzzahl dargestellt werden kann.

RESP-Antwort​

Integer-Antwort: der Wert des Schlüssels nach der Dekrementierung.

GET​

Syntax​

    GET key

Ruft den Wert des Schlüssels ab. Wenn der Schlüssel nicht existiert, wird nil zurückgegeben.

RESP-Antwort​

Eine der folgenden

  • Bulk-String-Antwort: der Wert des Schlüssels.
  • Nil-Antwort: wenn der Schlüssel nicht existiert.

GETEX​

Syntax​

    GETEX key [EX seconds | PX milliseconds | EXAT unix-time-seconds | PXAT unix-time-milliseconds | PERSIST]

Ruft den Wert des Schlüssels ab und setzt optional dessen Ablaufdatum. GETEX ist ähnlich wie GET, ist aber ein Schreibbefehl mit zusätzlichen Optionen.

Der GETEX-Befehl unterstützt eine Reihe von Optionen, die sein Verhalten modifizieren

  • EX Sekunden -- Legt die angegebene Ablaufzeit in Sekunden fest.
  • PX Millisekunden -- Legt die angegebene Ablaufzeit in Millisekunden fest.
  • EXAT Zeitstempel-Sekunden -- Legt die angegebene Unix-Zeit fest, zu der der Schlüssel abläuft, in Sekunden.
  • PXAT Zeitstempel-Millisekunden -- Legt die angegebene Unix-Zeit fest, zu der der Schlüssel abläuft, in Millisekunden.
  • PERSIST -- Entfernt die für den Schlüssel festgelegte Lebensdauer.

RESP-Antwort​

Eine der folgenden

  • Bulk-String-Antwort: der Wert des Schlüssels.
  • Nil-Antwort: wenn der Schlüssel nicht existiert oder wenn der Werttyp des Schlüssels keine Zeichenkette ist.

GETDEL​

Syntax​

    GETDEL key

Ruft den Wert des Schlüssels ab und löscht den Schlüssel. Dieser Befehl ist ähnlich wie GET, aber er löscht auch den Schlüssel im Erfolgsfall (nur wenn der Werttyp des Schlüssels eine Zeichenkette ist).

RESP-Antwort​

Eine der folgenden

  • Bulk-String-Antwort: der Wert des Schlüssels.
  • Nil-Antwort: wenn der Schlüssel nicht existiert oder wenn der Werttyp des Schlüssels keine Zeichenkette ist.

GETSET​

Hinweis: GETSET ist ein veralteter Befehl, verwenden Sie SET mit dem Argument GET bei der Migration oder beim Schreiben neuen Codes.

Syntax​

    GETSET key value

Setzt atomar den Schlüssel auf den Wert und gibt den alten Wert zurück, der im Schlüssel gespeichert war.

RESP-Antwort​

Eine der folgenden

  • Bulk-String-Antwort: der alte Wert, der im Schlüssel gespeichert war.
  • Null-Antwort: wenn der Schlüssel nicht existiert.

GETRANGE​

Syntax​

    GETRANGE key start end

Gibt die Teilzeichenkette des im Schlüssel gespeicherten Zeichenkettenwerts zurück, bestimmt durch die Offsets start und end (beide sind inklusive).

RESP-Antwort​

Bulk-String-Antwort: Die Teilzeichenkette des im Schlüssel gespeicherten Zeichenkettenwerts, bestimmt durch die Offsets start und end (beide sind inklusive).

SUBSTR​

Hinweis: SUBSTR ist ein veralteter Befehl, verwenden Sie GETRANGE bei der Migration oder beim Schreiben neuen Codes.

Syntax​

    SUBSTR key start end

Gibt die Teilzeichenkette des im Schlüssel gespeicherten Zeichenkettenwerts zurück, bestimmt durch die Offsets start und end (beide sind inklusive).

RESP-Antwort​

Bulk-String-Antwort: Die Teilzeichenkette des im Schlüssel gespeicherten Zeichenkettenwerts, bestimmt durch die Offsets start und end (beide sind inklusive).

INCR​

Syntax​

    INCR key

Inkrementiert die unter dem Schlüssel gespeicherte Zahl um eins. Wenn der Schlüssel nicht existiert, wird er vor der Ausführung der Operation auf 0 gesetzt.

RESP-Antwort​

Integer-Antwort: der Wert des Schlüssels nach der Inkrementierung.

INCRBY​

Syntax​

    INCRBY key increment

Inkrementiert die unter dem Schlüssel gespeicherte Zahl um den Wert des Parameters increment. Wenn der Schlüssel nicht existiert, wird er vor der Ausführung der Operation auf 0 gesetzt.

RESP-Antwort​

Integer-Antwort: der Wert des Schlüssels nach der Inkrementierung.

INCRBYFLOAT​

Syntax​

    INCRBYFLOAT key increment

Inkrementiert die als Fließkommazahl gespeicherte Zeichenkette im Schlüssel um den angegebenen Inkrementwert. Durch die Verwendung eines negativen Inkrementwerts wird der im Schlüssel gespeicherte Wert dekrementiert. Wenn der Schlüssel nicht existiert, wird er vor der Ausführung der Operation auf 0 gesetzt.

RESP-Antwort​

Bulk-String-Antwort: der Wert des Schlüssels nach der Inkrementierung.

LCS​

Syntax​

    LCS key1 key2 [LEN] [IDX] [MINMATCHLEN len] [WITHMATCHLEN]

Gibt die längste gemeinsame Teilsequenz der Werte zurück, die in Schlüssel1 und Schlüssel2 gespeichert sind.

Der LCS-Befehl unterstützt eine Reihe von Optionen, die sein Verhalten modifizieren

  • LEN -- Gibt die Länge der längsten gemeinsamen Teilsequenz zurück.
  • IDX -- Gibt die Positionen der Übereinstimmungen der längsten gemeinsamen Teilsequenz zurück.
  • MINMATCHLEN len -- Gibt nur Übereinstimmungen mit einer Länge von mindestens len zurück.
  • WITHMATCHLEN -- Gibt die Längen der Übereinstimmungen zurück.

RESP-Antwort​

Eine der folgenden

  • Bulk-String-Antwort: die längste gemeinsame Teilsequenz der Werte, die in Schlüssel1 und Schlüssel2 gespeichert sind.
  • Integer-Antwort: die Länge der längsten gemeinsamen Teilsequenz (wenn LEN angegeben ist).
  • Array-Antwort: die Übereinstimmungspositionen der längsten gemeinsamen Teilsequenz (wenn IDX angegeben ist).

MGET​

Syntax​

    MGET key [key ...]

Gibt die Werte aller angegebenen Schlüssel zurück. Für jeden Schlüssel, der nicht existiert, wird der spezielle Wert nil zurückgegeben.

MSET​

Syntax​

    MSET key value [key value ...]

Setzt die gegebenen Schlüssel auf ihre jeweiligen Werte. MSET ersetzt bestehende Werte durch neue Werte, genau wie das normale SET. Siehe MSETNX, wenn Sie bestehende Werte nicht überschreiben möchten.

RESP-Antwort​

Array-Antwort: eine Liste von Werten an den angegebenen Schlüsseln.

MSETNX​

Syntax​

    MSETNX key value [key value ...]

Setzt die gegebenen Schlüssel auf ihre jeweiligen Werte. MSETNX führt überhaupt keine Operation aus, selbst wenn nur ein einziger Schlüssel bereits existiert.

RESP-Antwort​

Eine der folgenden

  • Integer-Antwort: 0, wenn kein Schlüssel gesetzt wurde (mindestens ein Schlüssel existierte bereits).
  • Integer-Antwort: 1, wenn alle Schlüssel gesetzt wurden.

PSETEX​

Syntax​

    PSETEX key milliseconds value

PSETEX funktioniert genauso wie SETEX, mit dem einzigen Unterschied, dass die Ablaufzeit in Millisekunden statt in Sekunden angegeben wird.

RESP-Antwort​

Einfache Zeichenketten-Antwort: OK.

SET​

Syntax​

    SET key value [NX | XX] [GET] [EX seconds | PX milliseconds] [KEEPTTL] [WITHETAG]

Setzt den Schlüssel key auf den Zeichenkettenwert. Wenn der Schlüssel bereits einen Wert enthält, wird dieser überschrieben, unabhängig von seinem Typ. Jede vorherige Lebensdauer, die mit dem Schlüssel verbunden war, wird bei einer erfolgreichen SET-Operation verworfen.

Optionen

  • EX Sekunden -- Legt die angegebene Ablaufzeit in Sekunden fest (eine positive Ganzzahl).
  • PX Millisekunden -- Legt die angegebene Ablaufzeit in Millisekunden fest (eine positive Ganzzahl).
  • NX -- Setzt den Schlüssel nur, wenn er noch nicht existiert.
  • XX -- Setzt den Schlüssel nur, wenn er bereits existiert.
  • KEEPTTL -- Behält die für den Schlüssel festgelegte Lebensdauer bei.
  • WITHETAG -- Durch Hinzufügen dieser Option wird das Schlüssel-Wert-Paar mit einer anfänglichen ETag gesetzt. Wenn dieser Befehl auf ein bestehendes Schlüssel-Wert-Paar mit einer ETag angewendet wird, aktualisiert dieser Befehl die ETag transparent. Dies ist ein Garnet-spezifischer Befehl. Sie können mehr über ETag-Unterstützung hier lesen. Die Optionen WITHETAG und GET können nicht gleichzeitig gesendet werden.

RESP-Antwort​

Eine der folgenden

  • Nil-Antwort: GET nicht gegeben: Operation wurde abgebrochen (Konflikt mit einer der XX/NX-Optionen).
  • Einfache Zeichenketten-Antwort: OK. GET nicht gegeben: Der Schlüssel wurde gesetzt.
  • Nil-Antwort: GET gegeben: Der Schlüssel existierte vor dem SET nicht.
  • Bulk-String-Antwort: GET gegeben: Der vorherige Wert des Schlüssels.
  • Integer-Antwort: WITHETAG gegeben: Die ETag, die entweder auf den Wert erstellt wurde, oder die aktualisierte ETag.

SETEX​

Syntax​

    SETEX key value

Setzt den Schlüssel key auf den Zeichenkettenwert und legt fest, dass key nach einer bestimmten Anzahl von Sekunden abläuft.

RESP-Antwort​

Einfache Zeichenketten-Antwort: OK.

SETNX​

Hinweis: SETNX ist ein veralteter Befehl, verwenden Sie SET mit dem Argument NX bei der Migration oder beim Schreiben neuen Codes.

Syntax​

    SETNX key value

Setzt den Schlüssel auf den Zeichenkettenwert, wenn der Schlüssel nicht existiert. Wenn der Schlüssel bereits einen Wert enthält, wird keine Operation durchgeführt.

RESP-Antwort​

Eine der folgenden

  • Integer-Antwort: 0, wenn der Schlüssel nicht gesetzt wurde.
  • Integer-Antwort: 1, wenn der Schlüssel gesetzt wurde.

STRLEN​

Syntax​

    STRLEN key

Gibt die Länge des im Schlüssel key gespeicherten Zeichenkettenwerts zurück.

RESP-Antwort​

  • Integer-Antwort: die Länge der im Schlüssel gespeicherten Zeichenkette oder 0, wenn der Schlüssel nicht existiert.

SETRANGE​

Syntax​

    SETRANGE key offset value

Überschreibt einen Teil der im Schlüssel gespeicherten Zeichenkette, beginnend am angegebenen Offset, für die gesamte Länge des Werts.

RESP-Antwort​

  • Integer-Antwort: die Länge der Zeichenkette nach der Modifizierung durch den Befehl.