文本搜索(Text Search)
MongoDB 支持对文档中的字符串内容执行文本搜索的查询操作。要执行文本搜索,MongoDB 使用文本索引和 $text
查询运算符。要了解有关文本搜索的更多信息,请参阅服务器手册中的文本搜索。
驱动程序提供了Filters.text()
辅助方法来促进文本搜索查询筛选器的创建。
先决条件
您必须设置以下组件才能运行本指南中的代码示例:
集合,其中填充了Github
test.restaurants
文档资产 中restaurants.json
文件中的文档。以下 import 语句:
import com.mongodb.client.MongoClients; import com.mongodb.client.MongoClient; import com.mongodb.client.MongoCollection; import com.mongodb.client.MongoDatabase; import com.mongodb.client.model.Indexes; import com.mongodb.client.model.Filters; import com.mongodb.client.model.Sorts; import com.mongodb.client.model.TextSearchOptions; import com.mongodb.client.model.Projections; import org.bson.Document;
重要
本指南使用Subscriber
实现,如快速入门入门知识中所述。
连接到 MongoDB 部署
首先,连接到 MongoDB 部署并声明和定义MongoDatabase
和MongoCollection
实例。
以下代码连接到在端口27017
上的localhost
上运行的独立 MongoDB 部署。 然后,定义database
变量以引用test
数据库,并collection
变量以引用restaurants
集合:
MongoClient mongoClient = MongoClients.create(); MongoDatabase database = mongoClient.getDatabase("test"); MongoCollection<Document> collection = database.getCollection("restaurants");
要了解有关连接到 MongoDB 部署的更多信息,请参阅连接到 MongoDB教程。
创建文本索引
要创建文本索引,请使用Indexes.text()
静态助手为文本索引创建规范,并将规范传递给MongoCollection.createIndex()
方法以创建索引。
name
restaurants
以下示例在collection的字段上创建文本索引:
MongoCollection<Document> collection = database.getCollection("restaurants"); collection.createIndex(Indexes.text("name")).subscribe(new PrintToStringSubscriber<String>());
执行文本Atlas Search
要执行文本Atlas Search ,请使用 Filters.text()
辅助方法指定文本Atlas Search查询筛选器。
例如,以下代码对name
字段执行文本搜索以匹配字符串"bakery"
或"coffee"
:
collection .countDocuments(Filters.text("bakery coffee")) .subscribe(new PrintSubscriber<Long>("Text search matches: %s"));
文本分数
对于每个匹配的文档,文本搜索都会分配一个分数,该分数表示文档与指定文本搜索查询筛选器的相关性。要返回分数并按分数排序,请在投影文档和排序表达式中使用$meta
操作符:
collection.find(Filters.text("bakery cafe")) .projection(Projections.metaTextScore("score")) .sort(Sorts.metaTextScore("score")) .subscribe(new PrintDocumentSubscriber());
指定文本Atlas Search选项
Filters.text()
助手可以接受各种文本Atlas Search选项。 驱动程序提供了TextSearchOptions
类来指定这些选项。
例如,以下文本Atlas Search在对单词 "cafe"
执行文本Atlas Search时指定文本Atlas Search语言选项:
collection.countDocuments( Filters.text("cafe", new TextSearchOptions().language("english")) ).subscribe(new PrintSubscriber<Long>("Text search matches (english): %s"));
要了解有关文本Atlas Search的更多信息,请参阅MongoDB Server手册中的以下部分: