O que são conjuntos ordenados e como são usados?

Question

Accepted Answer

**Conjuntos ordenados** (ZSETs) são uma das estruturas mais poderosas do Redis — coleções de **membros únicos cada um com uma pontuação numérica**, automaticamente mantidos **ordenados por pontuação**. Eles são a estrutura ideal para classificações, rankings, filas de prioridade e dados ordenados por tempo.

## Operações de conjunto ordenado

```bash
# add members with scores; the set stays ordered by score automatically
ZADD leaderboard 100 "Ann" 90 "Bob" 110 "Carol"
ZRANGE leaderboard 0 -1 WITHSCORES        # ascending by score: Bob(90), Ann(100), Carol(110)
ZREVRANGE leaderboard 0 2 WITHSCORES      # DESCENDING top 3 (highest scores first)
ZRANK leaderboard "Ann"                    # Ann's rank (position) ascending
ZREVRANK leaderboard "Ann"                 # rank descending (e.g. "2nd place")
ZSCORE leaderboard "Ann"                   # => 100 (Ann's score)
ZINCRBY leaderboard 5 "Ann"               # add 5 to Ann's score (atomic)
```

Os membros são únicos (como um conjunto), mas cada um tem uma pontuação, e o conjunto é sempre ordenado por pontuação — então você pode obter intervalos, ranks e resultados ordenados com eficiência.

## Caso de uso: placar / ranking

```bash
# a game leaderboard — update scores, get top players and ranks instantly
ZINCRBY game:scores 10 "player1"          # player scores 10 points
ZREVRANGE game:scores 0 9 WITHSCORES      # top 10 players
ZREVRANK game:scores "player1"             # this player's rank
# → all efficient; the sorted set keeps everything ranked automatically
```

**Placares** são o uso clássico: pontuações são atualizadas e você obtém instantaneamente os top N e o rank de qualquer jogador — com eficiência, sem ordenação manual.

## Consultas por intervalo de pontuação

```bash
ZRANGEBYSCORE leaderboard 90 100          # members with scores 90-100
ZREMRANGEBYSCORE events 0 1609459200      # remove old items by score (e.g. timestamp)
# → using a TIMESTAMP as the score makes a time-ordered set (priority queue, time-series)
```

Usando um **timestamp como a pontuação** cria dados ordenados por tempo — um padrão comum para filas de prioridade, tarefas agendadas e dados em janelas de tempo.

## Por que isso importa

Os conjuntos ordenados são uma das estruturas de dados mais poderosas e distintivas do Redis, então compreendê-los é um conhecimento valioso que desbloqueia casos de uso importantes.

A combinação — **membros únicos, cada um com uma pontuação, automaticamente mantidos ordenados** — resolve com eficiência problemas que seriam trabalhosos em outro lugar.

A aplicação clássica é **placares/rankings**: pontuações são atualizadas (`ZINCRBY`) e você obtém instantaneamente os **top N** (`ZREVRANGE`) e o **rank** (`ZREVRANK`) de qualquer membro sem ordenação manual — tornando placares em tempo real (comuns em jogos, competições, conteúdo em tendência) triviais e eficientes, o que é uma marca registrada do Redis.

Além de placares, conjuntos ordenados alimentam **filas de prioridade** (pontuação = prioridade), **dados ordenados por tempo e tarefas agendadas** (usando um **timestamp como a pontuação** para criar conjuntos ordenados por tempo, permitindo consultas por intervalo de tempo e remoção de itens antigos — um padrão comum para séries temporais, trabalhos atrasados e dados em janelas de tempo), e **consultas por intervalo de pontuação** (`ZRANGEBYSCORE`).

Compreender conjuntos ordenados e esses padrões permite resolver problemas de ranking, priorização e ordenação por tempo elegantemente com Redis.

Como rankings, placares, filas de prioridade e dados ordenados por tempo são necessidades comuns, e como conjuntos ordenados fornecem uma estrutura eficiente e elegante para todos eles (mantendo automaticamente a ordem por pontuação), compreender conjuntos ordenados — as operações, o caso de uso de placar e o padrão timestamp-como-pontuação para dados ordenados por tempo — é um conhecimento Redis valioso e distintivo que desbloqueia capacidades poderosas, uma das estruturas que melhor demonstra por que os tipos de dados ricos do Redis o tornam muito mais do que um simples cache.