redis-py 指南 (Python)

将你的 Python 应用连接到 Redis 数据库

redis-py 是 Redis 的 Python 客户端。以下部分解释了如何安装 redis-py 并将你的应用连接到 Redis 数据库。

redis-py 需要一个正在运行的 Redis 服务器。有关 Redis 开源安装说明，请参阅此处。

你也可以使用对象映射客户端接口访问 Redis。更多信息请参阅 RedisOM for Python。

安装

要安装 redis-py，请输入

pip install redis

为了获得更快的性能，请安装支持 hiredis 的 Redis。这提供了编译后的响应解析器，在大多数情况下无需更改代码。默认情况下，如果 hiredis >= 1.0 可用，redis-py 会尝试使用它进行响应解析。

注意
Python distutils 打包方案不再是 Python 3.12 及更高版本的一部分。如果你在 Python 3.12 环境中安装 redis-py 时遇到困难，请考虑更新到 redis-py 的最新版本。
pip install redis[hiredis]

连接和测试

连接到本地主机（localhost）上的 6379 端口，在 Redis 中设置一个值，然后检索它。所有响应在 Python 中都以字节形式返回。要接收解码后的字符串，请设置 decode_responses=True。更多连接选项，请参阅这些示例。

r = redis.Redis(host='localhost', port=6379, decode_responses=True)

存储和检索一个简单的字符串。

r.set('foo', 'bar')
# True
r.get('foo')
# bar

存储和检索一个字典 (dict)。

r.hset('user-session:123', mapping={
    'name': 'John',
    "surname": 'Smith',
    "company": 'Redis',
    "age": 29
})
# True

r.hgetall('user-session:123')
# {'surname': 'Smith', 'name': 'John', 'company': 'Redis', 'age': '29'}

更多信息

redis-py 网站包含命令参考和一些针对各种任务的教程。redis-py 的 GitHub 仓库中也有一些示例。

另请参阅本节中的其他页面以获取更多信息和示例

评价本页
返回顶部 ↑