混合搜索:向量、全文与 SQL¶
混合搜索可组合语义向量检索、全文关键词匹配、结构化条件和关系表查询。英文教程示例使用 MatrixOne Python SDK 的 ORM 查询接口;向量和全文索引仍需分别按各自要求配置。
准备数据和索引¶
示例先定义带向量列和 FulltextIndex 的文章表,启用全文功能并插入文章数据;再在已有向量数据上创建 IVF 索引。实际使用时,先用代表性数据验证两类检索条件,再组合过滤和排序。
向量 + 全文 + SQL 条件¶
以下查询要求标题或正文匹配 learning,只保留评分不低于 4.7 的文章,并按向量 L2 距离排序:
from matrixone.sqlalchemy_ext import boolean_match
results = client.query(
Article.id,
Article.title,
Article.rating,
Article.embedding.l2_distance(query_vector).label("distance"),
).filter(
boolean_match(Article.title, Article.content).must("learning")
).filter(
Article.rating >= 4.7
).order_by("distance").limit(10).all()
这里全文匹配和评分条件共同筛选结果,距离用于排序。生产查询应根据业务需求选择 LIMIT,并用真实数据检查执行计划和结果。
向量查询 + JOIN¶
可以把向量查询结果与分类表关联,返回关联表字段:
results = client.query(
Article.title,
Category.name.label("category"),
Article.embedding.l2_distance(query_vector).label("distance"),
).join(
Category, Article.category_id == Category.cat_id
).order_by("distance").limit(5).all()
教程还展示全文 + WHERE、全文 + JOIN、CTE、子查询和聚合等模式。“混合搜索”不是固定的单一算法,而是按应用需求组合 SQL 条件和检索方式。
相关文档¶
FULLTEXT2 SQL 检索示例:这是 SQL FULLTEXT2 示例,与本页 Python SDK 的
FulltextIndex/boolean_match调用形式不同。