Zum Hauptinhalt springen

Clientverwaltung

CLIENT ID​

Syntax​

    CLIENT ID

Der Befehl gibt nur die ID der aktuellen Verbindung zurück. Jede Verbindungs-ID hat bestimmte Garantien

  1. Sie wird niemals wiederholt, sodass, wenn CLIENT ID denselben Wert zurückgibt, der Aufrufer sicher sein kann, dass der zugrunde liegende Client die Verbindung nicht getrennt und neu verbunden hat, sondern es sich immer noch um dieselbe Verbindung handelt.
  2. Die ID ist monoton steigend. Wenn die ID einer Verbindung größer ist als die ID einer anderen Verbindung, ist garantiert, dass die zweite Verbindung zu einem späteren Zeitpunkt mit dem Server hergestellt wurde.

Resp Reply​

Integer-Antwort: die ID des Clients.

CLIENT INFO​

Syntax​

    CLIENT INFO

Der Befehl gibt Informationen und Statistiken über die aktuelle Client-Verbindung in einem weitgehend lesbaren Format zurück.

Resp Reply​

Bulk-String-Antwort: ein eindeutiger String für den aktuellen Client, wie auf der Seite CLIENT LIST beschrieben.

CLIENT GETNAME​

Syntax​

    CLIENT GETNAME

Der Befehl gibt den Namen der aktuellen Verbindung zurück, wie er von CLIENT SETNAME festgelegt wurde.

RESP-Antwort​

Bulk-String-Antwort: der Name des Clients oder ein leerer String, wenn kein Name festgelegt ist.

CLIENT SETNAME​

Syntax​

    CLIENT SETNAME <name>

Der Befehl legt den Namen der aktuellen Verbindung fest.

RESP-Antwort​

Simple-String-Antwort: OK, wenn der Verbindungsname erfolgreich festgelegt wurde.

CLIENT SETINFO​

Syntax​

    CLIENT SETINFO <LIB-NAME libname | LIB-VER libver>

Der Befehl setzt den Wert eines bestimmten Abschnitts der aktuellen Client-Verbindung.

Derzeit sind die unterstützten Attribute:

  • LIB-NAME - soll den Namen der verwendeten Client-Bibliothek enthalten.
  • LIB-VER - soll die Version der Client-Bibliothek enthalten.

RESP-Antwort​

Simple-String-Antwort: OK, wenn der Wert des Abschnitts erfolgreich festgelegt wurde.

CLIENT KILL​

Syntax​

    CLIENT KILL <ip:port | <[ID client-id] | [TYPE <NORMAL | MASTER |
        SLAVE | REPLICA | PUBSUB>] | [USER username] | [ADDR ip:port] |
        [LADDR ip:port] | [SKIPME <YES | NO>] | [MAXAGE maxage]
        [[ID client-id] | [TYPE <NORMAL | MASTER | SLAVE | REPLICA |
        PUBSUB>] | [USER username] | [ADDR ip:port] | [LADDR ip:port] |
        [SKIPME <YES | NO>] | [MAXAGE maxage] ...]>>

Der Befehl CLIENT KILL schließt eine gegebene Client-Verbindung.

  • CLIENT KILL addr:port. Dies killt den Client, der der angegebenen Adresse und dem angegebenen Port entspricht.
  • CLIENT KILL ADDR ip:port. Dies killt den Client, der der angegebenen Adresse und dem angegebenen Port entspricht.
  • CLIENT KILL LADDR ip:port. Kills alle Clients, die mit der angegebenen lokalen (bind) Adresse verbunden sind.
  • CLIENT KILL ID client-id. Ermöglicht das Killen eines Clients anhand seines eindeutigen ID-Feldes. Client-IDs werden über den Befehl CLIENT LIST abgerufen.
  • CLIENT KILL TYPE type, wobei type einer von normal, master, replica und pubsub ist. Dies schließt die Verbindungen aller Clients der angegebenen Klasse. Beachten Sie, dass Clients, die im Befehl MONITOR blockiert sind, zur normalen Klasse gezählt werden.
  • CLIENT KILL USER username. Schließt alle Verbindungen, die mit dem angegebenen ACL-Benutzernamen authentifiziert sind. Gibt jedoch einen Fehler zurück, wenn der Benutzername keinem vorhandenen ACL-Benutzer zugeordnet ist.
  • CLIENT KILL SKIPME yes/no. Standardmäßig ist diese Option auf yes gesetzt, d. h. der Client, der den Befehl aufruft, wird nicht gekillt. Das Setzen dieser Option auf no hat zur Folge, dass auch der Client, der den Befehl aufruft, gekillt wird.
  • CLIENT KILL MAXAGE maxage. Schließt alle Verbindungen, die älter als das angegebene Alter in Sekunden sind.

RESP-Antwort​

Eine der folgenden

  • Simple-String-Antwort: OK, wenn im 3-Argumenten-Format aufgerufen und die Verbindung geschlossen wurde.
  • Integer-Antwort: wenn im Filter/Wert-Format aufgerufen, die Anzahl der gekillten Clients.

CLIENT LIST​

Syntax​

    CLIENT LIST [TYPE <NORMAL | MASTER | REPLICA | PUBSUB>]
        [ID client-id [client-id ...]]

Der Befehl CLIENT LIST gibt Informationen und Statistiken über die vom Server verwalteten Client-Verbindungen in einem weitgehend lesbaren Format zurück.

Sie können einen der optionalen Unterbefehle verwenden, um die Liste zu filtern. Der Unterbefehl TYPE type filtert die Liste nach den Client-Typen, wobei type einer von normal, master, replica und pubsub ist.

RESP-Antwort​

Bulk-String-Antwort: Informationen und Statistiken über Client-Verbindungen.

CLIENT UNBLOCK​

Syntax​

    CLIENT UNBLOCK <client-id> [TIMEOUT | ERROR]

Der Befehl entblockiert einen Client, der durch einen blockierenden Befehl wie BRPOP, XREAD oder BLPOP blockiert wurde.

Das optionale Argument gibt an, wie der Client entblockiert werden soll

  • TIMEOUT - Entblockiert den Client, als ob ein Timeout aufgetreten wäre (Standard)
  • ERROR - Entblockiert den Client und gibt einen Fehler zurück

RESP-Antwort​

Integer-Antwort

  • 1, wenn der Client entblockiert wurde
  • 0, wenn der Client nicht blockiert war