Actions en masse

fonctionnel

Supprimez des clés par motif ou faites-les expirer, avec un décompte de simulation d’abord, et importez des fichiers de commandes.

Les actions en masse permettent de nettoyer de nombreuses clés en même temps sans renoncer à la sécurité des dialogues à une seule clé. Cliquez avec le bouton droit sur une base de données Redis ou un dossier de clés dans l'explorateur (sur une base de données, les suppressions et modifications de TTL se trouvent sous Modification en masse et les fichiers de commandes sous Importer / Exporter):

  • Supprimer les clés par motif… (base de données) ou Supprimer les clés dans le dossier… (dossier)
  • Définir le TTL par motif… ou Définir le TTL dans le dossier… - définir une date d'expiration sur chaque clé correspondante, ou cocher Supprimer l'expiration (PERSIST) à la place pour la supprimer
  • Importer un fichier de commandes… (base de données) - exécuter un fichier de commandes Redis, une par ligne
  • Exporter en fichier de commandes… (base de données) ou Exporter le dossier en fichier de commandes… (dossier) - écrire les clés correspondantes dans un fichier que la commande Importer un fichier de commandes… réexécute

Le menu d'une seule clé ajoute Renommer… (RENAMENX, ou RENAME lorsque vous autorisez le remplacement) et, sous Copier vers, Copier vers la base de données… (COPY key key DB n, Redis 6.2 et versions ultérieures) et Copier vers la connexion… (DUMP sur cette connexion, RESTORE sur celle que vous choisissez, expiration incluse). Chacun affiche la commande exacte avant son exécution, est désactivé sur les connexions en lecture seule et les connexions de production verrouillées (Copier vers la connexion vérifie le cible connexion aussi), et demande un second clic partout où un onglet de requête demanderait confirmation. Cocher Remplacer remplace une clé qui existe déjà à la destination ; sans cela, la copie est refusée et l'indique.

Simulation d'abord

Supprimer et TTL n'écrivent jamais en premier. Le dialogue part du préfixe du dossier ou du filtre de clé actuel de la base de données, et Compter les clés correspondantes parcourt l'espace des clés avec la même limite SCAN que celle utilisée par le navigateur de clés (jusqu'à 25 000 clés), donc le comptage ne change rien. Le comptage s'exécute une page à la fois avec un total courant et un Arrêter bouton ; un comptage arrêté ou plafonné est étiqueté partiel, et l'étape d'application ne touche que les clés listées par la simulation, jamais les autres. Vous voyez combien de clés correspondent avant de pouvoir appliquer quoi que ce soit. Une suppression en masse vous demande de taper le nombre de clés correspondantes avant que son bouton soit activé, puis s'exécute par lots UNLINK les commandes avec un compteur de progression et un Arrêter bouton ; les lots commencent à 500 clés et rétrécissent (jusqu'à 50) dès que l'un prend plus d'une seconde, donc Stop n'attend jamais longtemps le lot en cours. Un changement de TTL en traite une EXPIRE ou PERSIST par clé, en lots cadencés de la même manière ; le champ secondes et la Supprimer l'expiration (PERSIST) à la place boîte restent modifiables après le comptage. Les noms de clés binaires sont préservés à l'octet près de bout en bout.

SQLly
Suppression en bloc Redis : le nombre de correspondances en simulation (dry run) pour le motif d'un dossier avant l'UNLINK confirmé, exécuté par lots.Suppression en bloc Redis : le nombre de correspondances en simulation (dry run) pour le motif d'un dossier avant l'UNLINK confirmé, exécuté par lots.
Suppression en bloc Redis : le nombre de correspondances en simulation (dry run) pour le motif d'un dossier avant l'UNLINK confirmé, exécuté par lots.

Agir sur les clés que vous avez sélectionnées

Lorsque les clés que vous voulez sont plus faciles à choisir qu'à décrire avec un motif, listez-les dans un onglet de requête avec SQLLY.KEYS <pattern> <limit>, triez ou filtrez la grille (par ttl_seconds, par exemple), sélectionnez les lignes, faites un clic droit et choisissez Outils › Clés Redis › Supprimer les clés sélectionnées…, Définir le TTL sur les clés sélectionnées… ou Supprimer l’expiration des clés sélectionnées…. Il n'y a pas d'exécution à blanc à attendre : la sélection est la liste, donc la boîte de dialogue s'ouvre sur la confirmation avec les clés affichées. Une suppression demande toujours de taper le nombre de clés, et les clés sur un cluster sont supprimées par lots qui restent dans un même slot de hachage. L'action utilise la connexion et la base de données de l'onglet auquel la grille appartient. Voir le navigateur de clés pour lesquels les résultats offrent le menu.

Importer un fichier de commandes

Choisissez un fichier texte UTF-8 avec une commande par ligne (SET, HSET, EXPIRE… ; lignes vides et # les commentaires sont ignorés). Écrivez les valeurs binaires comme des chaînes citées "\xHH" échappements. SQLly lit et analyse tout le fichier avant que quoi que ce soit ne s'exécute, et refuse un fichier qui n'est pas un script de commandes exécutable, en nommant la ligne : un guillemet non fermé, une ligne JSON incorrecte, ou des octets qui ne sont pas UTF-8 valides. L'exécution tente alors chaque ligne au maximum une fois, avec un compte courant des commandes traitées. Une ligne échouée n'arrête pas l'importation : chaque échec est listé avec son numéro de ligne, la commande, et l'erreur du serveur, et le résumé compte ce qui a réussi et ce qui a échoué. Un SELECT dans le fichier s'applique aux lignes qui suivent.

Le fichier s'exécute par lots d'environ 200 lignes, chacun sur sa propre connexion, donc un MULTI … EXEC un bloc n'est jamais scindé entre deux lots. Si une ligne d'une transaction échoue, la transaction est rejetée : le reste du bloc est ignoré au lieu d'être exécuté en dehors d'elle, et le résumé compte les lignes ignorées.

Exporter un dossier en tant que fichier de commandes

L'exportation écrit chaque clé correspondant au préfixe du dossier (ou au filtre de clés de la base de données) sous la forme des commandes qui la reconstruisent : SET pour les chaînes, HSET, RPUSH, SADD et ZADD dans des lignes de 500 membres maximum, un XADD par entrée de flux avec son identifiant d'origine, JSON.SET pour les documents JSON, puis PEXPIRE pour une clé qui avait un temps de vie (compté depuis l'importation). Les noms et valeurs de clés binaires sont écrits comme "\xHH" échappements, donc l'importation du fichier dans une base de données vide restitue les mêmes octets, et le même nombre de clés. Il ne fait que lire : rien ne change sur le serveur, donc cela fonctionne également sur des connexions en lecture seule.

L'exportation s'arrête à la limite de clés que vous choisissez (10 000 par défaut) et à 8 Mo, la limite de taille de fichier de l'importation, si bien que chaque exportation peut être réimportée. Une exportation arrêtée se termine par une # partial ligne, et les types que l'importation ne peut pas reconstruire (autres types de modules) sont listés comme # skipped commentaires plutôt que d'être ignorés en silence. Les groupes de consommateurs de streams ne sont pas exportés, seules les entrées le sont. Une importation sur des clés existantes ajoute aux listes et aux streams. Exportez vers une base de données vide, ou supprimez d'abord le dossier.

Revue de sécurité

Avant qu'une importation ne s'exécute, chaque ligne est vérifiée par rapport à la même liste de commandes Redis que celle utilisée par l'éditeur de requêtes. La boîte de dialogue indique combien de lignes s'écrivent et énumère par numéro de ligne chaque commande destructrice ou d'administration du serveur qu'elle a trouvée, telle que FLUSHALL, FLUSHDB, DEL, CONFIG SET, SHUTDOWN, DEBUG, SCRIPT, MODULE et ACL. Lorsqu'il y en a, ou lorsque les paramètres de sécurité de la connexion feraient que l'éditeur demande une confirmation, vous devez taper RUN ALL avant que le fichier puisse s'exécuter.

Les écritures et importations en masse sont désactivées sur les connexions en lecture seule, ainsi que sur une connexion de production tant que ses écritures sont verrouillées. Les éléments de l’explorateur sont grisés, et les boîtes de dialogue expliquent pourquoi tout en permettant le comptage ou la vérification du fichier. Déverrouillez d’abord les écritures depuis la pastille de la barre d’état. Le verrou est revérifié lorsque vous confirmez, donc un déverrouillage qui expire pendant que la boîte de dialogue est ouverte est pris en compte. Si vous fermez la boîte de dialogue pendant une exécution en cours, elle s’arrête après le lot en cours, et le résumé partiel s’affiche dans la barre d’état.