Les éléments sont automatiquement triés par leur score, permettant des opérations de tri et de recherche efficaces.

L’image illustre un ensemble trié Redis, où les éléments sont ordonnés selon leur score numérique. Chaque élément est unique et associé à un score qui détermine sa position dans l’ensemble.

Commandes principales

Pour ajouter un élément à un ensemble trié, utiliser la commande ZADD. Si l’élément existe déjà, son score est mis à jour. Pour supprimer un élément, utiliser la commande ZREM.

ZADD leaderboard 1000 player1
ZADD leaderboard 1200 player1  # updates the score
ZREM leaderboard player2       # removes an element

Pour récupérer des éléments avec leurs scores, utiliser la commande ZRANGE avec l’option WITHSCORES :

ZRANGE leaderboard 0 -1 WITHSCORES

Cette commande renvoie tous les éléments dans l'ensemble du classement ainsi que leurs scores. Si vous souhaitez uniquement les éléments sans leurs scores, omettez le paramètre WITHSCORES.

Pour récupérer les éléments dans une plage de scores spécifique, utilisez la commande ZRANGEBYSCORE :

ZRANGEBYSCORE leaderboard 500 1500

Cela sélectionnera tous les éléments avec des scores compris entre 500 et 1500.

Les commandes telles que ZCOUNT et ZRANK sont utiles pour le comptage des éléments dans une plage de scores et pour trouver le rang d’un élément spécifique dans un ensemble trié :

ZCOUNT leaderboard 500 1500  # counts elements in the range
ZRANK leaderboard player1    # gets the rank of an element