検索テキスト

サンプル ドキュメント

次のセクションでは、 fast_and_furious_moviesコレクションでのテキスト検索の例を紹介します。 各セクションでは、 collectionという名前の変数を使用して、 fast_and_furious_moviesコレクションのMongoCollectionインスタンスを参照します。

fast_and_furious_moviesコレクションには、映画「F形式」の構成要素であるいくつかの映画の 1 つを説明するドキュメントが含まれています。 各ドキュメントには、タイトル フィールドとタグ フィールドが含まれています。

{ "_id": 1, "title": "2 Fast 2 Furious ", "tags": ["undercover", "drug dealer"] }
{ "_id": 2, "title": "Fast 5", "tags": ["bank robbery", "full team"] }
{ "_id": 3, "title": "Furious 7", "tags": ["emotional"] }
{ "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }

Text Index

テキスト検索を実行する前に、テキストインデックスを作成する必要があります。 テキストインデックスは、テキスト検索を実行する string または string 配列フィールドを指定します。

次の例では、 fast_and_furious_moviesコレクションのtitleフィールドでテキスト検索を実行します。 titleフィールドでテキスト検索を有効にするには、次のスニペットを含むインデックスビルダを使用して テキスト インデックス を作成します。

collection.createIndex(Indexes.text("title"));

詳細については、次のリソースを参照してください。

• インデックス ガイドの「テキスト インデックス」セクション

• テキストインデックスのサーバー マニュアル エントリ

オプションの指定

大文字と小文字の区別などのテキスト検索オプションを指定するには、 Filters.text()メソッドの 2 番目のパラメータとしてTextSearchOptionsを含めることができます。 デフォルトでは、テキスト検索は大文字と小文字を区別せずに実行されます。つまり、検索は小文字と大文字の値に一致します。

大文字と小文字を区別した検索を指定するには、次のスニペットを使用します。

TextSearchOptions options = new TextSearchOptions().caseSensitive(true);
Bson filter = Filters.text("SomeText", options);

このセクションで説明されるメソッドとクラスの詳細については、次の API ドキュメントを参照してください。

• Filters.text()

• TextSearchOptions

タームでテキストを検索

タームを string としてFilters.text()メソッドに渡し、テキスト検索でタームを指定します。

Bson filter = Filters.text("fast");
collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));

{ "_id": 1, "title": "2 Fast 2 Furious ", "tags": ["undercover", "drug dealer"] }
{ "_id": 2, "title": "Fast 5", "tags": ["bank robbery", "full team"] }

Bson filter = Filters.text("fate 7");
collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));

{ "_id": 3, "title": "Furious 7", "tags": ["emotional"] }
{ "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }

フレーズでテキストを検索

エスケープされた引用符を含むフレーズをFilters.text()メソッドに渡して、テキスト検索でフレーズを指定します。 エスケープされた引用符は、バックスラッシュ文字が前に付いたdouble引用符文字です。 フレーズの前後にエスケープされた引用符を付けない場合、 find()メソッドはターム検索を実行します。

Bson filter = Filters.text("\"fate of the furious\"");
collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));

{ "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }

タームを除外した検索テキスト

テキスト検索から除外する各タームについて、 Filters.text()ビルダー メソッドに渡す string において、タームの前にマイナス記号を付けます。

検索から返されるドキュメントには、テキスト インデックス フィールドに除外されたタームが含まれていません。

Bson filter = Filters.text("furious -fast");
collection.find(filter).forEach(doc -> System.out.println(doc.toJson()));

{ "_id": 3, "title": "Furious 7", "tags": ["emotional"] }
{ "_id": 4, "title": "The Fate of the Furious", "tags": ["betrayal"] }