命令介绍
Search Module(
valkey-search)提供全文索引与向量相似度搜索能力,将搜索引擎能力嵌入键空间。该模块适用于商品搜索(关键词 + 属性过滤)、AI 应用中的向量语义检索、日志全文分析等需要高性能搜索与查询的场景。该模块自 Valkey 8.0 起支持,不属于 Redis 内核命令集。其核心命令按功能可分为以下三类:索引管理
FT.CREATE:定义索引结构,支持对 Hash 或 JSON 字段建立倒排索引(TEXT)、数值索引(NUMERIC)、标签索引(TAG)和向量索引(FLAT / HNSW)。
FT.DROPINDEX:删除索引(可选是否同时删除关联的文档数据)。
FT.INFO:查看索引的统计信息,包括文档数、字段定义、索引大小等。
FT._LIST:列出当前实例中的所有索引。
全文搜索与混合检索
FT.SEARCH:执行全文查询、范围过滤、Tag 匹配与向量近邻搜索的混合检索,支持分页、排序、高亮、摘要等功能。
聚合分析
FT.AGGREGATE:对查询结果进行分组(GROUPBY)、排序(SORTBY)、投影(APPLY)、过滤(FILTER)等聚合分析操作,支持构建复杂的实时数据分析管道。
命令支持概览
索引管理命令:
FT.CREATE、FT.DROPINDEX、FT.INFO、FT._LIST,用于创建、删除、查看和列出全文/向量搜索索引。Valkey 8.0标准架构与集群架构均支持。查询命令:
FT.SEARCH、FT.AGGREGATE,用于对索引执行搜索与聚合操作。Valkey 8.0标准架构与集群架构均支持。跨 Slot 限制:Search Module 在集群架构下通过内部协调机制跨分片操作索引,不存在传统意义上的单键跨 Slot 限制。
命令兼容性矩阵
命令 | Valkey 9.0标准架构 | Valkey 9.0集群架构 | Valkey 8.0标准架构 | Valkey 8.0集群架构 |
ft.create | ✓ | ✓ | ✓ | ✓ |
ft.search | ✓ | ✓ | ✓ | ✓ |
ft.aggregate | ✓ | ✓ | ✓ | ✓ |
ft.info | ✓ | ✓ | ✓ | ✓ |
ft.dropindex | ✓ | ✓ | ✓ | ✓ |
ft._list | ✓ | ✓ | ✓ | ✓ |