如何在Python中使用Redis查询匹配{status: 'new'}的JSON文档？

核心结论 #

要高效查询Redis中的JSON字段，必须为目标字段创建并维护索引——这不是Redis落后，而是为了保证查询性能的必要操作。如果不建索引，只能全量遍历所有键并解析JSON，数据量大时完全不可用。

无需ORM，用redis-py直接实现的步骤 #

你不需要引入ORM或者复杂模块，用基础的redis-py客户端就能完成操作，步骤如下：

1. 确认Redis环境

确保你的Redis实例安装了Redis Stack（包含Search & Query和JSON模块），否则无法使用JSON查询和索引功能。

2. 创建针对JSON字段的索引

先为status字段创建索引，示例代码：

import redis

r = redis.Redis(host="your-redis-host", port=6379, db=0)

# 创建索引，指定JSON路径$.status
r.execute_command(
    "FT.CREATE", "json_status_idx",
    "ON", "JSON",
    "PREFIX", "1", "doc:",  # 假设你的JSON文档键都以doc:开头
    "SCHEMA", "$.status", "AS", "status", "TAG"  # TAG类型适合精确匹配
)

• PREFIX 1 "doc:"：只索引键以doc:开头的JSON文档
• $.status AS status：把JSON根节点下的status字段映射为索引字段status
• TAG：字段类型，适合像new这种固定值的精确匹配

3. 执行查询

直接调用FT.SEARCH命令查询status='new'的文档：

# 查询status为new的文档
result = r.execute_command("FT.SEARCH", "json_status_idx", "@status:{new}")

# 解析结果：result[0]是匹配数，后面是键和对应的JSON内容
match_count = result[0]
for i in range(1, len(result), 2):
    doc_key = result[i]
    doc_json = result[i+1]
    print(f"键: {doc_key}, 内容: {doc_json}")

关于“任意字段查询”的说明 #

如果要查询其他JSON字段，同样需要提前为该字段创建索引——Redis的Search模块不会自动发现JSON字段并建索引，必须显式定义，这是为了避免不必要的性能开销（比如自动索引所有字段会占用大量内存）。

为什么需要手动维护索引？ #

Redis的核心依然是键值存储，扩展的JSON查询功能依赖索引来实现O(1)或O(log n)的查询效率。如果自动为所有JSON字段建索引，会导致内存占用暴增，反而影响性能。手动建索引是在灵活性和性能之间的平衡选择。

内容的提问来源于stack exchange，提问作者dcsan