View a markdown version of this page

Premiers pas avec Watch en mode Serverless - Amazon ElastiCache

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Premiers pas avec Watch en mode Serverless

ElastiCache soutient les WATCH commande, qui vous permet de surveiller les modifications apportées aux touches et d'exécuter des modifications conditionnelles transactions. Le WATCH La commande est particulièrement utile pour les applications qui nécessitent un contrôle de simultanéité optimiste, garantissant que les transactions ne sont exécutées que si les clés surveillées n'ont pas été modifiées. Cela inclut les modifications apportées par un client, comme les commandes d'écriture, et par Valkey lui-même, comme l'expiration ou l'expulsion. Si les clés ont été modifiées depuis le moment où elles ont été configurées WATCH et d'ici là EXEC est reçue, l'intégralité de la transaction sera annulée.

Pour ElastiCache Sans serveur, les contraintes suivantes sont introduites :

ElastiCache Sans serveur WATCH est limité à un seul emplacement de hachage. Cela signifie que seules les clés qui correspondent au même emplacement de hachage peuvent être surveillées en même temps par la même connexion, et que la transaction qui suit les commandes de surveillance ne peut fonctionner que sur le même emplacement de hachage. Lorsqu'une application tente de surveiller des clés provenant de différents emplacements de hachage, ou d'exécuter des commandes de transaction qui opèrent sur des clés mappées à un emplacement de hachage différent de celui des clés surveillées, CROSSSLOT l'erreur sera renvoyée. balises de hachage peut être utilisé pour s'assurer que plusieurs clés sont mappées au même emplacement de hachage.

En outre, SCAN la commande ne peut pas être exécutée dans une connexion avec des touches surveillées et retournera command not supported during watch state erreur.

La transaction sera annulée (comme si les touches surveillées avaient été touchées) lorsque ElastiCache Serverless ne sait pas avec certitude si une clé a été modifiée. Par exemple, lorsqu'un slot a été migré et que les clés surveillées sont introuvables sur le même nœud.

Exemples de code

Dans l'exemple suivant, la touche surveillée et la touche spécifiée dans SET mappage de commandes vers différents emplacements de hachage. L'exécution renvoie un CROSSSLOT ERROR.

> WATCH foo:{005119} OK > MULTI OK > SET bar:{011794} 1234 QUEUED > EXEC CROSSSLOT Keys in request don't hash to the same slot

L'exemple suivant montre une transaction réussie, comme la clé définie dans WATCH n'a pas été modifié.

> WATCH foo:{005119} OK > MULTI OK > SET bar:{005119} 1234 QUEUED > EXEC 1) OK

Dans l'exemple suivant, une tentative de WATCH les clés provenant de différents emplacements simultanément au sein de la même connexion client renvoient un CROSSSLOT ERROR.

> WATCH foo:{005119} OK > WATCH bar:{123455} CROSSSLOT Keys in request don't hash to the same slot

Limite de visionnage

Chaque connexion client peut surveiller jusqu'à 1 000 clés en même temps.

Commandes prises en charge liées à Watch

REGARDER et DÉSURVEILLER les commandes sont documentées sur Valkey.io site web. Il fournit une vue d'ensemble complète des commandes, notamment de leur syntaxe, de leur comportement, de leurs valeurs de retour et des conditions d'erreur potentielles.