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
的示例。
请参阅本节中的其他页面以获取更多信息和示例: