クエリ テキスト

サンプル ドキュメント

次のセクションでは、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 配列フィールドを指定します。

次の例では、title fast_and_furious_moviesコレクションの フィールドに対してテキスト クエリを実行します。 フィールドでテキスト検索を有効にするには、次のスニペットを含む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()エスケープされた引用符を含むフレーズを メソッドに渡して、テキスト クエリでフレーズを指定します。エスケープされた引用符は、バックスラッシュ文字が前に付いた二重引用符文字です。フレーズの前後にエスケープされた引用符を付けない場合、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"] }