全文布尔搜索¶
本页对应 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 配置。
相关文档¶
FULLTEXT2SQL 检索示例:不同的 SQL 布尔检索语法和结果验证示例。