使用Redis实现实时排行榜的示例_Redis

为了实现一个实时排行榜系统，我们可以使用redis的有序集合（zset），其底层通常是使用跳跃表实现的。有序集合允许我们按照分数（score）对成员（member）进行排序，因此非常适合用来实现排行榜。本文首先介绍有序集合及其底层数据结构——跳表，然后使用python和redis结合，展示一个简单的排行榜系统。

一、zset 概述

1.1 zset 介绍

实现一个排行榜，很多人可能首先想到的是使用mysql的order by来排序。然而，当数据量达到百万级别时，使用数据库排序的代价是很大的。因此，redis的有序集合（zset）成为了一个更好的选择。

zset（sorted set）的特点如下：

唯一性：集合内的元素（成员）是唯一的。
有序性：与普通set的无序性不同，zset的成员是“有序的”，这种有序性是基于成员所关联的“分数”（score）进行排序的，分数是浮点类型。

1.2 zset 底层原理

zset 是redis中的一种复杂数据结构，它在set的基础上增加了一个权重参数score，使得集合中的元素能按score进行有序排列。

zset的底层实现通常有两种数据结构：

当元素数量较少或元素长度较短时，采用压缩列表（ziplist）。
当元素数量达到一定量或者元素长度超过一定限制时，采用跳跃表（skiplist）。

跳表（skiplist）具有多层链表结构，查询、插入和删除操作的平均时间复杂度均为o(log n)。

1.3 zset 主要操作命令

zadd key score member：将元素及其分数添加到有序集合中。
zincrby key increment member：为有序集合中的元素增加或减少分数。
zrange key start stop [withscores]：获取有序集合中分数从小到大的排名在指定范围内的成员。
zrevrange key start stop [withscores]：获取有序集合中分数从大到小的排名在指定范围内的成员。
zrank key member：获取成员在有序集合中的排名（从小到大的排名，排名从0开始）。
zrevrank key member：获取成员在有序集合中的排名（从大到小的排名，排名从0开始）。
zscore key member：获取成员在有序集合中的分数。
zcard key：获取有序集合的基数，即成员数量。

二、使用 redis 和 python 实现实时排行榜

下面是一个使用python的redis库来操作zset并实现实时排行榜的示例。

2.1 安装所需的库

首先确保已经安装redis库：

pip install redis

2.2 初始化redisleaderboard类

接下来，我们实现一个redisleaderboard类来管理排行榜：

import redis
from flask import flask, render_template
import sys

app = flask(__name__)

# initialize redis connection with error handling
try:
    r = redis.redis(
        host='192.168.88.139',
        password='123456',
        port=6379,
        db=0,
        socket_connect_timeout=3,  # 3 seconds timeout
        decode_responses=true  # automatically decode responses to utf-8
    )
    # test the connection
    r.ping()
    print("成功连接redis", file=sys.stderr)
except redis.connectionerror as e:
    print(f"连接redis失败: {e}", file=sys.stderr)
    r = none  # set to none so we can check later


@app.route('/')
def leaderboard():
    if r is none:
        return render_template('error.html',
                               message="redis server is not available"), 503

    try:
        top_10 = get_top_n(10)
        return render_template('leaderboard.html', leaderboard=top_10)
    except redis.rediserror as e:
        return render_template('error.html',
                               message=f"redis error: {str(e)}"), 500


def get_top_n(n):
    try:
        top_n = r.zrevrange("game_leaderboard", 0, n - 1, withscores=true)
        leaderboard = []
        for rank, (user_id, score) in enumerate(top_n, start=1):
            leaderboard.append({
                "rank": rank,
                "user_id": user_id,  # no need to decode with decode_responses=true
                "score": float(score)
            })
        return leaderboard
    except redis.rediserror as e:
        print(f"redis operation failed: {e}", file=sys.stderr)
        raise  # re-raise the exception to be handled by the route


if __name__ == '__main__':
    app.run(debug=true)

在这里插入图片描述

2.3 案例数据

import redis

r = redis.redis(host='192.168.88.139', password='123456', port=6379, db=0)


def add_score(user_id, score):
    r.zadd("game_leaderboard", {user_id: score})


def update_score(user_id, score):
    r.zincrby("game_leaderboard", score, user_id)


def get_top_n(n):
    top_n = r.zrevrange("game_leaderboard", 0, n - 1, withscores=true)
    leaderboard = []
    for rank, (user_id, score) in enumerate(top_n, start=1):
        leaderboard.append({
            "rank": rank,
            "user_id": user_id.decode("utf-8"),
            "score": score
        })
    return leaderboard


def get_user_rank_and_score(user_id):
    rank = r.zrevrank("game_leaderboard", user_id)
    if rank is not none:
        rank += 1
    score = r.zscore("game_leaderboard", user_id)
    return rank, score


if __name__ == '__main__':
    # 添加初始得分
    add_score('user1', 100)
    add_score('user2', 150)
    add_score('user3', 50)

    # 更新得分（加分操作），如果用户不存在，会将其得分初始化为该值
    update_score('user1', 30)
    update_score('user2', 20)
    update_score('user3', -10)

    # 获取前2名的用户
    top_2 = get_top_n(2)
    for entry in top_2:
        print(f"rank {entry['rank']}: userid: {entry['user_id']} with score {entry['score']}")

    # 获取特定用户的排名和得分
    rank, score = get_user_rank_and_score('user1')
    if rank is not none and score is not none:
        print(f"user user1 is ranked {rank} with a score of {score}.")
    else:
        print("user user1 is not found in the leaderboard.")

2.4 前端

需要创建一个templates文件夹，并在其中存放leaderboard.html文件：

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>leaderboard</title>
    <style>
        table {
            width: 100%;
            border-collapse: collapse;
        }
        th, td {
            border: 1px solid black;
            padding: 8px;
            text-align: left;
        }
    </style>
</head>
<body>
    <h1>leaderboard</h1>
    <table>
        <thead>
            <tr>
                <th>rank</th>
                <th>user id</th>
                <th>score</th>
            </tr>
        </thead>
        <tbody>
            {% for entry in leaderboard %}
            <tr>
                <td>{{ entry.rank }}</td>
                <td>{{ entry.user_id }}</td>
                <td>{{ entry.score }}</td>
            </tr>
            {% endfor %}
        </tbody>
    </table>
</body>
</html>

三、结论

redis的有序集合(zset)由于其高效的插入、删除、查询及排序操作，是实现实时排行榜的理想选择。跳表作为zset的底层数据结构之一，保证了这些操作的时间复杂度为o(log n)。结合python的redis库，可以快速实现一个功能强大、高效的实时排行榜系统。

这种排行榜实现方案非常适合用于在线游戏、社交平台等各种应用场景。

到此这篇关于使用redis实现实时排行榜的示例的文章就介绍到这了,更多相关redis 实时排行榜内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！

使用Redis实现实时排行榜的示例

2025年04月21日 • Redis •我要评论