Tair (Redis® OSS-Compatible):exZset

Présentation

Les ensembles triés Redis ne prennent en charge qu'un seul score par membre, ce qui rend complexe la mise en œuvre de classements multidimensionnels. Les solutions de contournement courantes, telles que la combinaison des scores via l'encodage IEEE 754 ou la concaténation de chaînes, entraînent une perte de précision, complexifient la logique d'encodage et de décodage, et empêchent l'incrémentation atomique des dimensions individuelles du score.

TairZset résout ces limitations grâce à une structure de données native multidimensionnelle :

• Jusqu'à 256 dimensions de score par membre, formatées comme suit : score1#score2#...#scoreN

• Priorité de gauche à droite : lors de la comparaison de deux membres, la première dimension est évaluée en premier ; si les valeurs sont égales, la deuxième dimension est comparée, et ainsi de suite.

• Incrémentations atomiques : la commande EXZINCRBY incrémente une dimension spécifique sans nécessiter de cycle lecture-modification-écriture.

• Compatibilité API : les commandes reproduisent le fonctionnement des commandes natives des ensembles triés, éliminant ainsi tout besoin de logique d'encodage ou de décodage côté client.

• Classements réguliers et distribués : prend en charge les architectures de classement sur nœud unique ainsi que les architectures distribuées.

• Client open source TairJedis : disponible à l'adresse TairJedis SDK ; utilisez le code source ouvert comme référence pour implémenter des clients dans d'autres langages.

Le module est open source et disponible sur TairZset sur GitHub.

Cas d'utilisation

Le scoring multidimensionnel fait de TairZset la solution idéale pour tout système de classement où une seule métrique s'avère insuffisante :

• Classements de streaming en direct : classez les streamers d'abord par popularité, puis par nombre de « J'aime », puis par montant des cadeaux reçus — popularity#likes#gift_amount

• Tableaux des médailles : classez les concurrents par médailles d'or, puis d'argent, puis de bronze — gold#silver#bronze

• Classements de jeux vidéo : classez les joueurs par score, puis par temps d'achèvement des tâches, puis par rang du joueur — score#completion_time#player_rank

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Une instance Tair optimisée pour la mémoire

• Pour les instances optimisées pour la mémoire compatibles avec Redis 5.0 : version mineure 1.7.1 ou ultérieure.

Mettez à jour vers la dernière version mineure pour bénéficier du plus grand nombre de fonctionnalités et d'une stabilité optimale. Consultez la rubrique Mise à jour de la version mineure d'une instance . Pour les instances en cluster ou les instances avec séparation lecture/écriture, mettez également à jour les nœuds proxy afin de garantir le bon fonctionnement de toutes les commandes.

Notes d'utilisation

• Toutes les commandes TairZset s'appliquent aux données TairZset stockées dans les instances Tair. L'exécution de ces commandes sur une clé contenant un type de données différent renvoie une erreur.

• Cohérence du format de score : tous les membres d'une même clé doivent utiliser le même nombre de dimensions de score. Le mélange de formats tels que 1#2#3 et 1#2 au sein d'une même clé provoque une erreur.

• Format d'incrémentation : la valeur increment de la commande EXZINCRBY doit correspondre au format de dimension du score du membre cible. Pour incrémenter une seule dimension d'un score à trois dimensions, vous devez spécifier les trois dimensions (par exemple, EXZINCRBY key 0#1#0 member).

• Les valeurs +inf et -inf sont des valeurs de score valides pour toutes les commandes basées sur des plages de scores.

Démarrage rapide

L'exemple suivant illustre la création d'un classement de streaming en direct à deux dimensions : le tri s'effectue d'abord par popularité, puis par nombre de « J'aime ».

# Add streamers with initial scores (popularity#likes)
EXZADD leaderboard 1000#500 alice 800#900 bob 1000#300 carol

# Atomically increment alice's likes without a read-modify-write cycle
EXZINCRBY leaderboard 0#100 alice

# Get the full leaderboard, highest score first
EXZREVRANGE leaderboard 0 -1 WITHSCORES
# 1) "alice"
# 2) "1000#600"
# 3) "carol"
# 4) "1000#300"
# 5) "bob"
# 6) "800#900"

# Get alice's rank (highest = rank 0)
EXZREVRANK leaderboard alice
# (integer) 0

Commandes

Le tableau ci-dessous répertorie toutes les commandes TairZset. Utilisez la commande native Redis DEL pour supprimer les clés TairZset.

Conventions syntaxiques utilisées dans cette rubrique :

• MOT_CLÉ_MAJUSCULE : mot-clé de commande

• _italique_ : variable

• [option] : paramètre facultatif

• A|B : options mutuellement exclusives (choisissez-en une)

• ... : le paramètre précédent peut être répété

EXZADD

Comportement :

• Si la clé n'existe pas, elle est créée.

• Si un membre n'existe pas, il est ajouté avec le score indiqué.

• Si un membre existe déjà, son score est écrasé (sauf si l'option NX est spécifiée).

• Chaque score est une représentation sous forme de chaîne d'un nombre en virgule flottante double précision. Les valeurs +inf et -inf sont valides.

Pour utiliser le scoring multidimensionnel, séparez chaque dimension par le caractère # , par exemple 111#222#121 . Tous les membres de la clé doivent utiliser le même nombre de dimensions.

Options :

Valeur de retour :

• Sans option : le nombre de membres nouvellement ajoutés (les membres dont seul le score a été mis à jour ne sont pas comptés)

• Avec l'option CH : le nombre de membres ajoutés ou dont le score a changé

• Avec l'option INCR : le nouveau score du membre sous forme de chaîne (par exemple, "2#0#6"); renvoie nil si l'opération est ignorée en raison des options NX ou XX

Exemple :

EXZADD testkey NX 1#0#3 a 1#0#2 b
(integer) 2

EXZINCRBY

Comportement :

• Si la clé ou le membre n'existe pas, les deux sont créés et le score est défini sur la valeur increment.

• Si le membre existe, son score est incrémenté de la valeur increment.

• Chaque dimension de score est un nombre en virgule flottante double précision. Les valeurs +inf et -inf sont valides.

• Pour décrémenter un score, passez une valeur increment négative.

Pour les scores multidimensionnels, le paramètre increment doit utiliser le même format que le score du membre. Par exemple, pour incrémenter uniquement la deuxième dimension d'un score à trois dimensions, utilisez 0#1#0 .

Valeur de retour : le nouveau score du membre sous forme de chaîne. Pour les scores multidimensionnels, le format est "score1#score2#..." (par exemple, "2#0#6").

Exemple :

EXZINCRBY testkey 2#2#1 a
"3#2#4"

EXZSCORE

Valeur de retour : le score du membre sous forme de chaîne. Pour les scores multidimensionnels, le format est "score1#score2#..." (par exemple, "3#2#4").

Exemple :

EXZSCORE testkey a
"3#2#4"

EXZRANGE

Options :

Return value: une liste des membres situés dans la plage spécifiée, avec leurs scores si l'option WITHSCORES est indiquée.

Exemple :

EXZRANGE testkey 0 -1 WITHSCORES
1) "b"
2) "1#0#2"
3) "a"
4) "3#2#4"

EXZREVRANGE

Options :

Return value: une liste des membres situés dans la plage spécifiée, avec leurs scores si l'option WITHSCORES est indiquée.

Exemple :

EXZREVRANGE testkey 0 -1 WITHSCORES
1) "a"
2) "3#2#4"
3) "b"
4) "1#0#2"

EXZRANGEBYSCORE

Options :

Return value: une liste des membres situés dans la plage de scores, avec leurs scores si l'option WITHSCORES est indiquée.

Exemple :

EXZRANGEBYSCORE testkey 0#0#0 6#6#6 WITHSCORES
1) "b"
2) "1#0#2"
3) "a"
4) "3#2#4"

EXZREVRANGEBYSCORE

Options :

Return value: une liste des membres situés dans la plage de scores, avec leurs scores si l'option WITHSCORES est indiquée.

Exemple :

EXZREVRANGEBYSCORE testkey 6#6#6 0#0#0 WITHSCORES
1) "a"
2) "3#2#4"
3) "b"
4) "1#0#2"

EXZRANGEBYLEX

Si les membres ont des scores différents, l'ensemble renvoyé est indéfini. La comparaison lexicographique utilise la fonction C memcmp() , qui compare les octets un par un. Si deux chaînes partagent un préfixe commun, la chaîne la plus longue obtient un rang supérieur.

Options :

Return value: une liste des membres situés dans la plage lexicographique.

Exemple :

EXZRANGEBYLEX zzz [a [b
1) "aba"
2) "abc"

EXZREVRANGEBYLEX

Options :

Return value: une liste des membres situés dans la plage lexicographique, dans l'ordre inverse.

Exemple :

EXZREVRANGEBYLEX zzz [b [a
1) "abc"
2) "aba"

EXZREM

Valeur de retour : le nombre de membres supprimés (sans compter les membres inexistants).

Exemple :

EXZREM testkey a
(integer) 1

EXZREMRANGEBYSCORE

Options :

Valeur de retour : le nombre de membres supprimés.

Exemple :

EXZREMRANGEBYSCORE testkey 3#2#4 6#6#6
(integer) 1

EXZREMRANGEBYRANK

Options :

Valeur de retour : le nombre de membres supprimés.

Exemple :

EXZREMRANGEBYRANK testkey 0 1
(integer) 1

EXZREMRANGEBYLEX

Options :

Valeur de retour : le nombre de membres supprimés.

Exemple :

EXZREMRANGEBYLEX testkey [a [b
(integer) 2

EXZCARD

Valeur de retour : le nombre de membres (entier).

Exemple :

EXZCARD testkey
(integer) 2

EXZRANK

Valeur de retour :

• Le rang du membre (entier) si le membre existe

• nil si la clé ou le membre n'existe pas

Exemple :

EXZRANK testkey b
(integer) 0

EXZREVRANK

Valeur de retour :

• Le rang du membre (entier) si le membre existe

• nil si la clé ou le membre n'existe pas

Exemple :

EXZREVRANK testkey b
(integer) 1

EXZCOUNT

Options :

Valeur de retour : le nombre de membres situés dans la plage de scores (entier).

Exemple :

EXZCOUNT testkey (1#0#2 6#6#6
(integer) 1

EXZLEXCOUNT

Si les membres ont des scores différents, le résultat est indéfini. La comparaison lexicographique utilise la fonction C memcmp() . Si deux chaînes partagent un préfixe commun, la chaîne la plus longue obtient un rang supérieur.

Options :

Valeur de retour : le nombre de membres situés dans la plage lexicographique (entier).

Exemple :

EXZLEXCOUNT zzz [a [b
(integer) 2

EXZRANKBYSCORE

Valeur de retour : le rang du score spécifié (entier).

Exemple :

EXZRANKBYSCORE testkey 2#0#2
(integer) 1

EXZREVRANKBYSCORE

Valeur de retour : le rang du score spécifié (entier).

Exemple :

EXZREVRANKBYSCORE testkey 2#0#2
(integer) 1

Étapes suivantes

• Implémentez facilement des classements multidimensionnels avec exZset

• Implémentez des classements avec architecture distribuée à l'aide d'exZset