検索テキスト

項目一覧

Overview

例
単語の検索
フレーズで検索
否定を含むクエリ
関連性でソート

Overview

テキスト検索では、コレクション内の文字列タイプのフィールドで、指定した単語やフレーズを検索できます。$text 演算子を使用してテキスト検索を実行できます。この演算子は、検索文字列内のスペースで区切られた各タームに対して論理 OR を実行します。また、サポートされている言語の大文字と小文字の区別、ストップワード、単語のステミング（複数形やその他の時制など）を取り扱うための他のオプションを演算子に指定することもできます。これは、トランスクリプト、エッセイ、ウェブページなどの非構造化テキストによく使用されます。

$text クエリ演算子では、コレクションのテキストインデックスに検索フィールドを指定する必要があります。テキストインデックスの作成と、$text クエリ演算子の使用に必要なサンプルコードについては、以下の例を参照してください。

注意

Atlas Search は、MongoDB データを処理して高速で関連性ベースの検索機能を構築するのに役立ちます。完全管理型のサービスとしてのデータベースである MongoDB Atlas を今すぐお試しください。

例

次の例では、sample_mflix データベースの movies コレクションのサンプルデータを使用します。title フィールドでテキスト検索を有効にするには、次のコマンドを使用してテキストインデックスを作成します。

db.movies.createIndex({ title: "text" });

このガイドの例では、単一フィールドのテキストインデックスを使用していますが、複合テキストインデックスを作成して、テキストクエリを複数のフィールドに拡大することもできます。次のコマンドを実行すると、movies コレクションの 2 つのフィールドにテキストインデックスが作成されます。

db.movies.createIndex({ title: "text", plot: "text" });

Tip

テキストインデックスでのフィールドの重みの指定

複合テキストインデックスを作成するときに、重みオプションを指定してインデックス内の特定のテキストフィールドに優先順位を付けることができます。テキスト検索を実行すると、フィールドの重みは、MongoDB が一致する各ドキュメントのテキスト検索スコアを計算する方法に影響します。

テキストインデックスの作成時におけるフィールドの重みの指定方法の詳細については、「インデックスガイド」のテキストインデックスセクションを参照してください。

テキストインデックスは、コレクションあたり 1つのみ作成できます。各テキスト検索クエリでは、そのインデックスに指定されているすべてのフィールドでクエリを実行して一致を探します。

テキストインデックスの詳細については、サーバーマニュアルの「テキストインデックス」を参照してください。

単語の検索

この例では、「trek」という単語を含むタイトルを探すことで、映画「Star Trek」のクエリを実行します。複数の単語を使用してクエリを実行する場合は、単語をスペースで区切って、検索タームのいずれかに一致するドキュメントを検索します（論理演算子 OR）。

  // Create a query that searches for the string "trek"
  const query = { $text: { $search: "trek" } };
  // Return only the `title` of each matched document
  const projection = {
    _id: 0,
    title: 1,
  };
  // Find documents based on our query and projection
  const cursor = movies.find(query).project(projection);

この操作により次のドキュメントが返されます。

{ title: 'Trek Nation' }
{ title: 'Star Trek' }
{ title: 'Star Trek Into Darkness' }
{ title: 'Star Trek: Nemesis' }
{ title: 'Star Trek: Insurrection' }
{ title: 'Star Trek: Generations' }
{ title: 'Star Trek: First Contact' }
{ title: 'Star Trek: The Motion Picture' }
{ title: 'Star Trek VI: The Undiscovered Country' }
{ title: 'Star Trek V: The Final Frontier' }
{ title: 'Star Trek IV: The Voyage Home' }
{ title: 'Star Trek III: The Search for Spock' }
{ title: 'Star Trek II: The Wrath of Khan' }

成功！タイトルに「trek」という単語が含まれる movies コレクション内のすべてのドキュメントがクエリで見つかりました。残念ながら、検索結果に意図しないアイテムが 1 つ含まれていました。「Trek Nation」はスタートレックに関する映画であり、映画シリーズ Star Trek には含まれません。より具体的なフレーズでクエリを実行すると、この問題を解決できます。

フレーズで検索

より具体的なクエリにするには、「trek」という単語だけでなく、「star trek」というフレーズを使用してみてください。フレーズで検索するには、複数の単語を含むフレーズをエスケープ文字が付いた引用符（\"<term>\"）で囲みます。

  // Create a query that searches for the phrase "star trek"
  const query = { $text: { $search: "\"star trek\"" } };
  // Return only the `title` of each matched document
  const projection = {
    _id: 0,
    title: 1,
  };
  // Find documents based on the query and projection
  const cursor = movies.find(query).project(projection);

"trek"というタームだけでなく、 "star trek"というフレーズでクエリを実行すると、次のドキュメントと一致します。

{ title: 'Star Trek' }
{ title: 'Star Trek Into Darkness' }
{ title: 'Star Trek: Nemesis' }
{ title: 'Star Trek: Insurrection' }
{ title: 'Star Trek: Generations' }
{ title: 'Star Trek: First Contact' }
{ title: 'Star Trek: The Motion Picture' }
{ title: 'Star Trek VI: The Undiscovered Country' }
{ title: 'Star Trek V: The Final Frontier' }
{ title: 'Star Trek IV: The Voyage Home' }
{ title: 'Star Trek III: The Search for Spock' }
{ title: 'Star Trek II: The Wrath of Khan' }

これらの結果には、"star trek" というフレーズを含むデータベース内のすべての映画が含まれます。この事例では、結果は架空の『スタートレック』映画のみになります。残念ながら、このクエリはオリジナルの映画シリーズの一部ではない "Star Trek Into Darkness" 映画を返しました。この問題を解決するには、そのドキュメントを除外して省略できます。

否定を含むクエリ

除外されたタームを使用するには、結果セットから省略するタームの前に負の記号 - を付けます。クエリ操作は、このタームを含むドキュメントをすべて検索結果から除外します。このクエリには 2 つの異なるタームが含まれているため、スペースで区切ります。

  // Create a query that searches for the phrase "star trek" while omitting "into darkness"
  const query = { $text: { $search: "\"star trek\"  -\"into darkness\"" } };
  // Include only the `title` field of each matched document
  const projection = {
    _id: 0,
    title: 1,
  };
  // Find documents based on the query and projection
  const cursor = movies.find(query).project(projection);

否定的なタームを使用してクエリを実行すると、次のドキュメントが生成されます。

{ title: 'Star Trek' }
{ title: 'Star Trek: Nemesis' }
{ title: 'Star Trek: Insurrection' }
{ title: 'Star Trek: Generations' }
{ title: 'Star Trek: First Contact' }
{ title: 'Star Trek: The Motion Picture' }
{ title: 'Star Trek VI: The Undiscovered Country' }
{ title: 'Star Trek V: The Final Frontier' }
{ title: 'Star Trek IV: The Voyage Home' }
{ title: 'Star Trek III: The Search for Spock' }
{ title: 'Star Trek II: The Wrath of Khan' }

注意

クエリ操作により、一致するドキュメントを含むカーソルへの参照が返される場合があります。カーソルに格納されているデータを調べる方法については、「カーソルの基礎ページ」を参照してください。

Overview

注意

例

Tip

テキスト インデックスでのフィールドの重みの指定

単語の検索

フレーズで検索

否定を含むクエリ

注意

関連性でソート

テキストインデックスでのフィールドの重みの指定