Massenaktionen
funktionalSchlüssel per Muster löschen oder ablaufen lassen, zuerst mit einer Probelauf-Zählung, sowie Befehlsdateien importieren.
Massenaktionen räumen viele Schlüssel auf einmal auf, ohne auf die Sicherheit der Einzelschlüssel-Dialoge zu verzichten. Klicke mit der rechten Maustaste auf eine Redis-Datenbank oder einen Schlüsselordner im Explorer (bei einer Datenbank liegen die Lösch- und TTL-Änderungen unter Massenbearbeitung und die Befehlsdateien unter Import / Export):
- Schlüssel nach Muster löschen… (Datenbank) oder Schlüssel im Ordner löschen… (Ordner)
- TTL nach Muster setzen… oder TTL im Ordner setzen… - für jeden passenden Schlüssel eine Ablaufzeit festlegen oder anhaken Stattdessen Ablauf entfernen (PERSIST) ankreuzen, um sie zu löschen
- Befehlsdatei importieren… (Datenbank) - eine Datei mit Redis-Befehlen ausführen, einen Befehl pro Zeile
- Als Befehlsdatei exportieren… (Datenbank) oder Ordner als Befehlsdatei exportieren… (Ordner) - schreibt die passenden Schlüssel in eine Datei, die Befehlsdatei importieren… wieder einliest
Das Menü eines einzelnen Schlüssels fügt hinzu Umbenennen… (RENAMENX, oder RENAME wenn du Überschreiben erlaubst) und unter Kopieren nach, In Datenbank kopieren… (COPY key key DB n, Redis 6.2 und neuer) und In Verbindung kopieren… (DUMP auf dieser Verbindung, RESTORE auf der von dir gewählten, Ablauf inklusive). Jede zeigt den exakten Befehl, bevor er ausgeführt wird, ist auf schreibgeschützten und gesperrten Produktionsverbindungen deaktiviert (In Verbindung kopieren prüft die Ziel- Verbindung), und verlangt einen zweiten Klick, wo ein Abfrage-Tab dies bestätigen würde. Das Ankreuzen von Ersetzen überschreibt einen Schlüssel, der bereits am Ziel existiert; ohne das lehnt das Kopieren ab und meldet es.
Erst ein Probelauf
Löschen und TTL schreiben nie zuerst. Der Dialog startet mit dem Präfix des Ordners oder dem aktuellen Schlüsselfilter der Datenbank, und Übereinstimmende Schlüssel zählen durchläuft den Schlüsselbereich mit dem gleichen begrenzten SCAN wie der Schlüsselbrowser (bis zu 25.000 Schlüssel), sodass die Zählung nichts ändert. Die Zählung läuft seitenweise mit einer laufenden Gesamtzahl und einem Stoppen Schaltfläche; eine gestoppte oder begrenzte Zählung wird als teilweise, und der Anwenden-Schritt berührt nur die Schlüssel, die der Trockenlauf aufgelistet hat, niemals den Rest. Du siehst, wie viele Schlüssel matchen, bevor irgendetwas angewendet werden kann. Eine Massenlöschung verlangt, dass du die Anzahl der gefundenen Schlüssel eintippst, bevor die Schaltfläche aktiv wird, und führt dann gebündelte UNLINK Befehle mit einer Fortschrittsanzeige und einem Stoppen Schaltfläche; Batches starten bei 500 Schlüsseln und schrumpfen (bis auf 50), sobald einer länger als eine Sekunde dauert, damit Stop nie lange auf den laufenden Batch warten muss. Eine TTL-Änderung führt jeweils einen EXPIRE oder PERSIST pro Schlüssel, in Batches mit gleicher Geschwindigkeit; das Sekundenfeld und das Stattdessen Ablauf entfernen (PERSIST) Feld bleiben nach der Zählung bearbeitbar. Binäre Schlüsselnamen werden durchgehend byte-exakt beibehalten.


Mit den ausgewählten Schlüsseln arbeiten
Wenn du die gewünschten Schlüssel lieber auswählst, als sie mit einem Muster zu beschreiben, liste sie in einem Abfragetab auf mit SQLLY.KEYS <pattern> <limit>, das Raster sortieren oder filtern (nach ttl_seconds, zum Beispiel), markiere die Zeilen, klicke mit der rechten Maustaste und wähle Tools › Redis Keys › Ausgewählte Schlüssel löschen…, TTL auf ausgewählte Schlüssel setzen… oder Ablaufdatum von ausgewählten Schlüsseln entfernen…. Es gibt keinen Probelauf, auf den du warten müsstest: Die Auswahl ist die Liste, der Dialog öffnet sich also direkt zur Bestätigung mit den angezeigten Schlüsseln. Ein Löschen verlangt weiterhin, dass du die Schlüsselanzahl eintippst, und Schlüssel in einem Cluster werden in Stapeln gelöscht, die innerhalb eines Hash-Slots bleiben. Die Aktion nutzt die Verbindung und Datenbank des Tabs, zu dem das Raster gehört. Siehe den Schlüsselbrowser dafür, für welche Ergebnisse das Menü angeboten wird.
Importieren einer Befehlsdatei
Wähle eine UTF-8-Textdatei mit einem Befehl pro Zeile (SET, HSET, EXPIRE…; leere Zeilen und # Kommentare werden übersprungen). Schreibe binäre Werte als in Anführungszeichen gesetzte "\xHH" Escape-Zeichen. SQLly liest und analysiert die gesamte Datei, bevor irgendetwas ausgeführt wird, und lehnt eine Datei ab, die kein ausführbares Befehls-Skript ist, wobei die Zeile benannt wird: ein unausgeglichenes Anführungszeichen, eine fehlerhafte JSON-Zeile oder Bytes, die kein gültiges UTF-8 sind. Der Lauf versucht dann jede Zeile höchstens einmal, mit einer fortlaufenden Zählung der verarbeiteten Befehle. Eine fehlerhafte Zeile stoppt den Import nicht: Jeder Fehler wird mit Zeilennummer, Befehl und Server-Fehler aufgelistet, und die Zusammenfassung zählt, was erfolgreich war und was fehlgeschlagen ist. Ein SELECT innerhalb der Datei wird auf die nachfolgenden Zeilen übertragen.
Die Datei läuft in Batches zu etwa 200 Zeilen, jeder auf seiner eigenen Verbindung, sodass ein MULTI … EXEC Block wird niemals über zwei Batches aufgeteilt. Wenn eine Zeile innerhalb einer Transaktion fehlschlägt, wird die Transaktion verworfen: der Rest dieses Blocks wird übersprungen, anstatt außerhalb davon ausgeführt zu werden, und die Zusammenfassung zählt die übersprungenen Zeilen.
Einen Ordner als Befehlsdatei exportieren
Der Export schreibt jeden Schlüssel, der dem Präfix des Ordners (oder dem Schlüssel-Filter der Datenbank) entspricht, als die Befehle, die ihn wiederherstellen: SET für Strings, HSET, RPUSH, SADD und ZADD in Zeilen von bis zu 500 Elementen, jeweils eines XADD pro Stream-Eintrag mit seiner ursprünglichen ID, JSON.SET für JSON-Dokumente, dann PEXPIRE für einen Schlüssel, der eine Restlaufzeit hatte (gezählt ab dem Import). Binäre Schlüsselnamen und Werte werden geschrieben als "\xHH" Escape-Sequenzen, sodass das Importieren der Datei in eine leere Datenbank die gleichen Bytes und die gleiche Anzahl an Schlüsseln zurückgibt. Es wird nur gelesen: Nichts auf dem Server ändert sich, daher funktioniert es auch bei schreibgeschützten Verbindungen.
Der Export stoppt bei dem von dir gewählten Schlüssellimit (standardmäßig 10.000) und bei 8 MB, dem Dateilimit des Imports, sodass sich jeder Export wieder importieren lässt. Ein gestoppter Export endet mit einer # partial Zeile, und Typen, die der Import nicht wiederherstellen kann (andere Modultypen), werden als # skipped Kommentare aufgelistet, statt stillschweigend weggelassen zu werden. Consumer-Gruppen von Streams werden nicht exportiert, nur die Einträge. Ein Import über bestehende Schlüssel hängt an Listen und Streams an. Exportiere in eine leere Datenbank oder lösche zuerst den Ordner.
Sicherheitsüberprüfung
Bevor ein Import ausgeführt wird, wird jede Zeile gegen dieselbe Redis-Befehlsliste geprüft, die auch der Abfrage-Editor verwendet. Der Dialog zeigt an, wie viele Zeilen geschrieben werden, und listet nach Zeilennummer jeden destruktiven oder serververwaltungsbezogenen Befehl auf, den er gefunden hat, wie etwa FLUSHALL, FLUSHDB, DEL, CONFIG SET, SHUTDOWN, DEBUG, SCRIPT, MODULE und ACL. Wenn welche vorhanden sind, oder wenn die Sicherheitseinstellungen der Verbindung den Editor eine Bestätigung verlangen lassen würden, musst du RUN ALL eingeben, bevor die Datei ausgeführt werden kann.
Massenschreibvorgänge und Importe sind auf schreibgeschützten Verbindungen deaktiviert, und auf Produktionsverbindungen, solange deren Schreibvorgänge gesperrt sind. Die Explorer-Einträge sind ausgegraut, und die Dialoge erklären warum, lassen dich aber trotzdem die Anzahl oder die Datei prüfen. Schreibe die Schreibvorgänge zuerst über den Chip in der Statusleiste frei. Die Sperre wird beim Bestätigen erneut geprüft, sodass eine Entsperrung, die abläuft, während der Dialog offen ist, weiter gilt. Wenn du den Dialog schließt, während ein Lauf läuft, stoppt er nach dem laufenden Batch, und die Teilauswertung landet in der Statusleiste.