aioredis-py 异步Redis客户端入门指南-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01018/article/details/148886619

aioredis-py 异步Redis客户端入门指南

什么是aioredis-py

aioredis-py是一个基于Python asyncio的Redis客户端库，专为异步编程设计。它提供了与Redis服务器交互的高性能异步接口，是构建高性能异步应用的理想选择。

安装指南

基础安装

使用pip可以轻松安装aioredis-py：

pip install aioredis

这个命令会同时安装aioredis及其依赖的async-timeout库。

高性能解析支持

如果需要更高的性能，可以安装hiredis解析器：

pip install aioredis[hiredis]

hiredis是一个C语言实现的Redis协议解析器，能显著提高解析Redis响应数据的速度。

连接Redis服务器

基本连接方式

使用aioredis.from_url方法可以创建一个连接池支持的Redis客户端：

import aioredis

redis = await aioredis.from_url("redis://localhost")

这个方法支持TCP和UNIX socket两种连接方式。

连接指定数据库

有两种方式可以指定连接的数据库：

通过关键字参数：

redis = await aioredis.from_url("redis://localhost", db=1)

通过URI路径：

redis = await aioredis.from_url("redis://localhost/1")

注意：URI中指定的数据库索引会覆盖关键字参数。

连接ACL保护的Redis实例

对于需要认证的Redis实例，可以通过以下方式连接：

使用关键字参数：

redis = await aioredis.from_url(
    "redis://localhost", username="user", password="sEcRet"
)

通过URI认证部分：

redis = await aioredis.from_url("redis://user:sEcRet@localhost/")

响应解码处理

默认行为

默认情况下，aioredis-py会返回字节类型(bytes)的响应数据。Redis错误消息会被自动解码为UTF-8字符串。

自动解码响应

如果确定Redis中的数据是有效的字符串，可以通过设置decode_responses=True来自动解码：

await redis.set("key", "value")
value = await redis.get("key", decode_responses=True)
print(value)  # 输出: "value"

对于列表、哈希、集合等复杂数据类型，aioredis-py会自动解码：

await redis.hset("hash", mapping={"foo": "bar", "hello": "world"})
result = await redis.hgetall("hash")
print(result)  # 输出: {'foo': 'bar', 'hello': 'world'}

事务处理

aioredis-py支持Redis的事务(Multi/Exec)功能：

async with redis.pipeline(transaction=True) as pipe:
    ok1, ok2 = await (pipe.set("key1", "value1").set("key2", "value2").execute())

使用管道(Pipeline)可以批量执行命令，所有命令会被缓冲在内存中，直到调用execute()才会一次性发送到Redis服务器执行。

发布/订阅模式

aioredis-py支持Redis的发布/订阅功能：

订阅特定频道

pubsub = redis.pubsub()
await pubsub.subscribe("channel1")

async for message in pubsub.listen():
    print(message)

模式订阅

pubsub = redis.pubsub()
await pubsub.psubscribe("news.*")

async for message in pubsub.listen():
    print(message)

Redis Sentinel支持

aioredis-py可以与Redis Sentinel配合使用：

from aioredis import Sentinel

sentinel = Sentinel([('localhost', 26379)], password="password")
master = sentinel.master_for("mymaster")
slave = sentinel.slave_for("mymaster")

Sentinel客户端会自动检测故障转移并重新连接Redis客户端。