Cluster Redis
fonctionnelRedis Cluster, mode cluster ElastiCache et MemoryDB : routage des slots, carte des nœuds pour les adresses de nœuds inaccessibles, transferts SSH par nœud et topologie.
SQLLY se connecte à Redis Cluster, aux clusters auto-hébergés, à Amazon ElastiCache en mode cluster et à Amazon MemoryDB - et dirige chaque commande vers le nœud qui possède le slot de hachage de sa clé. Lorsque le cluster déplace un slot (une bascule ou un redécoupage), le client suit le
MOVED ou ASK réponse, met à jour sa carte des slots et vous indique combien de redirections un script a vues. Le navigateur de clés, l'analyseur de mémoire, les actions en masse, le Profileur et le visualiseur Pub/Sub fonctionnent tous sur chaque maître.
Connexion
Créez une connexion Redis comme d'habitude. Dans Serveur vous pouvez lister plusieurs nœuds de départ, séparés par des virgules (10.0.0.1:7000, 10.0.0.2:7001); une entrée sans port utilise le Port champ. Coller une URL telle que
redis://user:[email protected]:7000,10.0.0.2:7001 garde chaque hôte. Sous
Mode cluster , choisissez :
- Détecter automatiquement (par défaut) - la première connexion interroge le serveur
INFO clusteret mémorise la réponse jusqu'à ce que vous quittiez, donc un seul serveur ne coûte qu'une sonde supplémentaire par session et rien d'autre ne change. - Serveur unique - ne jamais acheminer par slot, même si le serveur est un nœud de cluster.
- Cluster Redis - toujours acheminer par slot.
Un cluster a une base de données logique unique, donc laissez Base de données vide ou réglez-la sur 0. Pour ElastiCache, dirigez la connexion vers le point de terminaison de configuration du cluster ; MemoryDB est toujours un cluster.
Carte des nœuds : quand les nœuds annoncent des adresses que vous ne pouvez pas joindre
Les nœuds du cluster indiquent aux clients où se trouvent les autres nœuds, en utilisant les adresses qu'ils ont été configurés pour annoncer. Derrière un NAT, une redirection de port Docker ou un bastion SSH, ce sont souvent des adresses privées que cette machine ne peut pas atteindre. Le Carte des nœuds du cluster le champ les réécrit : un advertised host:port => dial host:port par ligne, par exemple 10.0.0.5:7001 => 127.0.0.1:17001. L'adresse annoncée continue de nommer le nœud (dans la carte des emplacements, dans les redirections et en tant que nom de serveur TLS) ; seul le socket va à l'adresse de numérotation.
Ce que l'éditeur refuse sur un cluster
Chaque commande est refusée avant d'être envoyée, avec un message qui nomme la règle :
- Commandes multi-clés sur plusieurs slots -
MGET,MSET,DELavec plusieurs clés,SUNION,RENAME,EVALavec plusieurs clés et autres ne s'exécutent que si chaque clé correspond au même slot. Donnez un hash tag commun aux clés liées :user:{42}:profileetuser:{42}:cartpartager un emplacement. SELECTde tout sauf 0 - un cluster a une base de données logique.KEYSetSCAN-KEYSbloquerait chaque maître, et unSCANle curseur appartient à un seul nœud. Utilisez le navigateur de clés, ouSQLLY.KEYS pattern [limit [cursor]], qui parcourt chaque maître par pages et retourne un curseur qui continue à travers eux.MULTI/EXEC- chaque commande est routée individuellement, donc une transaction ne peut pas rester sur un seul nœud depuis l'éditeur.
Exécution d'une commande sur les nœuds choisis
Préfixez une ligne avec SQLLY.ON et une cible pour l'envoyer aux nœuds que vous choisissez au lieu du nœud qui possède sa clé. La cible est masters,
replicas, all, l'adresse d'un nœud host:port comme le liste la vue de topologie du cluster, ou plusieurs de ceux-ci séparés par des virgules :
SQLLY.ON masters DBSIZE- une ligne par maître avec son nombre de clés.SQLLY.ON masters FLUSHALL- vide chaque maître (les répliques suivent).SQLLY.ON 10.0.0.4:7003 INFO replication- la réponse d'une seule réplique.SQLLY.ON replicas DBSIZE- vérifiez que chaque réplique détient autant de clés que son maître.
La ligne s’exécute sur chaque nœud exactement telle qu’elle est tapée, de la même façon que redis-cli se passe de
-c: aucune redirection n'est suivie, donc un nœud qui ne possède pas une clé répond
MOVED, et les commandes refusées ci-dessus (KEYS, SCAN) sont exécutées sur le nœud choisi. Les répliques sont basculées vers READONLY d'abord pour qu'ils servent les lectures clés. Plusieurs nœuds répondent dans une grille avec nœud et
rôle colonnes, et un nœud qui répond avec une erreur obtient sa propre ligne ; chaque nœud est connecté avant que la commande ne s'exécute où que ce soit, donc un nœud inaccessible arrête la chaîne avant que le moindre nœud ne l'ait exécutée. Le préfixe ne change rien à la sécurité : une connexion en lecture seule refuse toujours SQLLY.ON masters FLUSHALL, et les commandes d'écriture et destructives demandent toujours une confirmation. Dans la vue Topologie du Cluster, sélectionnez un nœud et appuyez sur
Requête sur le nœud pour ouvrir un onglet de requête qui commence à la ligne de ce nœud.
Lorsque le client a suivi des redirections pendant l'exécution d'un script, le volet Messages indique combien (par exemple après un basculement). C'est normal juste après un déplacement de slots du cluster ; un flux constant de redirections signale un resharding en cours.
Outils sur l'ensemble du cluster
- Navigateur de clés - liste les clés de chaque maître tour à tour, jusqu'à son budget habituel ; quand il s'arrête prématurément, la ligne de note indique combien de clés il a parcourues sur combien de maîtres, et Analyser davantage reprend au nœud où il s'était arrêté.
- Analyseur de mémoire - l'échantillon est réparti entre les masters au prorata de leur nombre de clés, et le total est cumulé sur l'ensemble.
- Suppression en masse - les clés correspondantes sont regroupées par slot de hachage afin que chaque
UNLINKlot reste dans un seul slot. - Profileur - s'exécute
MONITORsur chaque master à la fois et fusionne les flux dans une seule table avec un nœud colonne. - Visionneuse Pub/Sub - l'abonnement aux notifications de keyspace se fait sur chaque maître (elles sont par nœud), celui aux canaux ordinaires et aux motifs sur un seul maître (un cluster distribue
PUBLISHpartout), et les canaux shardés - entrez-les avec un préfixe#, comme#orders- sur le maître qui possède chaque canal. Les lignes portent une nœud colonne. Les canaux partitionnés fonctionnent aussi sur un serveur Redis 7 autonome.
Topologie du cluster
Cliquez droit sur une base de données Redis et choisissez Outils › Topologie du cluster…, exécutez
Topologie du Cluster Redis… à partir de la palette de commandes, ou utilisez le lien sur le Tableau de bord du serveur d'une connexion de cluster. Le volet liste chaque nœud de
CLUSTER SHARDS (ou CLUSTER NODES sur les serveurs avant la version 7.0 : son identifiant, son rôle, l'adresse qu'il annonce, l'adresse que SQLLY utilise pour le joindre, son nom d'hôte annoncé et le nom de serveur TLS envoyé par le client, ses slots, son état de santé, le décalage de réplication et l'état des liens. Le pied de page compte les masters et les répliques, vérifie que les 16 384 slots sont couverts, et nomme tout nœud qui n'est pas en bonne santé ou qui est joint à une autre adresse que celle qu'il annonce.
Trace exécute la même vérification étape par étape que Tester la connexion pour chaque nœud, recherche de nom, tunnel ou proxy (avec la carte des nœuds), TCP, TLS (vérifié par rapport à l'adresse annoncée par le nœud), connexion, protocole et ping, base de données, et CLUSTER INFO - une ligne par étape, donc la première ligne en échec vous dit quoi corriger : une entrée erronée dans la carte des nœuds, un port bloqué, une incompatibilité de nom TLS, un problème d'ACL, ou un nœud qui ne signale pas un cluster sain. Les deux rapports sont également disponibles sous forme de SQLLY.TOPOLOGY et SQLLY.TRACE dans un onglet de requête ; ils ne font que lire.