全文布尔搜索

本页对应 MatrixOne Python SDK 的布尔全文检索示例。boolean_match() 可将必含条件、排除条件和相关性调整组合起来;它与 SQL FULLTEXT2 的语法不同。以下示例假定 client 已连接,Article 模型已定义。

常用操作符

方法

含义

匹配结果

must(“a”, “b”)

必须出现

所有必含词都要匹配

must_not(“x”)

排除

含排除词的记录不匹配

encourage(“x”)

提升相关性

匹配记录仍可返回,含该词的结果排名更高

discourage(“x”)

降低相关性

匹配记录仍可返回,含该词的结果排名降低

phrase(“a b”)

短语匹配

按给定词序匹配短语

示例:必须同时包含 machine 和 learning,同时排除 legacy:

from matrixone.sqlalchemy_ext import boolean_match

results = client.query(Article).filter(
    boolean_match(Article.title, Article.content)
    .must("machine", "learning")
    .must_not("legacy")
).execute()

如果某些词只是偏好而非必需条件,可用 encourage(),不要把可选词放进 must():

results = client.query(Article).filter(
    boolean_match(Article.title, Article.content)
    .must("Python")
    .encourage("data", "science")
).execute()

包含 data 或 science 的文章会获得更高相关性,但不含这些可选词的文章仍可能匹配。短语查询会按给定词序匹配:

results = client.query(Article).filter(
    boolean_match(Article.title, Article.content).phrase("neural networks")
).execute()

需要按相关性调整排名时,教程建议使用 BM25,并检查 ft_relevancy_algorithm 配置。

相关文档