redis-py 指南 (Python)

将您的Python应用程序连接到Redis数据库

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

redis-py 需要一个正在运行的 Redis 或 Redis Stack 服务器。有关 Redis 安装说明,请参阅 Getting started

你也可以通过对象映射客户端接口访问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]

连接和测试

连接到本地主机的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

存储和检索一个字典。

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 网站 提供了命令参考 和一些针对不同任务的教程。 在GitHub 仓库中也有一些redis-py的示例。

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

RATE THIS PAGE
Back to top ↑