Textsuche verwenden

Mit den Textsuchfunktionen in Cloud Firestore können Sie in einer Sammlung nach bestimmten Strings suchen.

Hinweis

Bevor Sie Textsuchen verwenden, führen Sie folgende Schritte aus:

  1. Prüfen Sie, ob Sie Zugriff auf eine vorhandene MongoDB-kompatible Datenbank für Vorgänge haben , oder erstellen Sie eine Datenbank und stellen Sie eine Verbindung zu ihr her.

  2. Prüfen Sie, ob Sie einen Textindex haben, oder erstellen Sie einen Textindex.

Bei Textsuchen wird der Operator $text in einem Filter verwendet. Geben Sie den abgefragten String im Argument $search an.

Führen Sie den folgenden Befehl aus, um eine allgemeine Textsuche durchzuführen:

  # Find search
  db.cities.find({ $text: { $search: "french bread" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "french bread" } } }
  ]);

Wenn Ihr Index partitioniert ist, können Sie nach der Partition filtern, indem Sie sie in einen Gleichheitsfilter vom Typ „und“ in Ihre Suche einbeziehen. Wenn Sie beispielsweise eine city-Partition haben, können Sie eine Textsuche so filtern:

db.myCollection.find( { $and: [
  { $text: { $search: "french bread" } },
  { "city": "Paris" }
] } )

Sie können eine Aggregation auch nach einer Partition filtern. Beispiel:

db.myCollection.aggregate([
 { $match: { $text: { $search: "french bread" } } },
 { "city": "Paris" }
] );

Der Wert Ihrer Partition muss ein String sein. Ihr Partitionsfilter muss mit einem „und“ mit Ihrer Textsuche verknüpft werden.

Sprache für die Textsuche festlegen

Sie können die Sprache für die Textsuche mit dem Argument $language festlegen. Beispiel:

  db.cities.find({ $text: { $search: "french bread", $language: "en"} })

Wenn Sie keine Sprache festlegen, wird für die Suche die Sprache des Textindex verwendet.

Nach einem genauen Begriff suchen

Wenn Sie nach einem genauen Begriff suchen möchten, konfigurieren Sie den Begriff als eine Folge von Wörtern in doppelten Anführungszeichen. Beispiel:

  # Find search
  db.cities.find({ $text: { $search: "\"best french bread\"" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "\"best french bread\"" } } },
  ]);

Nach einer Begriffskombination suchen

Wenn Sie Ihre Textsuche präziser gestalten möchten, geben Sie eine Kette von Begriffen an. Die folgende Suche gibt beispielsweise Dokumente zurück, die der Kombination best AND french AND ("bread" OR "is")entsprechen:

  # Find search
  db.cities.find({ $text: { $search: "\"best\" \"french\" bread is" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "\"best\" \"french\" bread is" } } },
  ]);

Begriff ausschließen

Wenn Sie einen Begriff aus einer Textsuche ausschließen möchten, stellen Sie dem Begriff einen Bindestrich voran:

  # Find search
  db.cities.find({ $text: { $search: "best bread -french"} })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best bread -french" } } },
  ]);

Relevanzwert berechnen

Verwenden Sie den {$meta: "textScore"} Ausdruck, um den Relevanzwert der Dokumente zu berechnen, die von der Textsuche gefunden wurden. Wenn Sie die Ergebnisse in absteigender Reihenfolge nach dem Wert sortieren möchten, verwenden Sie $meta in einem Sortierausdruck. Beachten Sie die folgenden Beispiele, wobei SCORE_FIELD der Name des Felds ist, in dem der Wert gespeichert wird:

  # Find search
  db.cities
    .find({ $text: { $search: "best french bread" } })
    .sort({ SCORE_FIELD: { $meta: "textScore" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best french bread" } } },
    { $sort: { "SCORE_FIELD": { $meta: "textScore"} } },
  ]);

Sie können den Textwert auch in Projektionsausdrücken verwenden. Beispiel:

  # Find search
  db.cities
    .find({ $text: { $search: "best french bread" } })
    .project({ score: { $meta: "textScore" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best french bread" } } },
    { $project: { "scoreField": { $meta: "textScore"} } },
  ]);

Um die Relevanz der Ergebnisse der Textsuche zu verbessern, erweitert der Operator $text den Suchstring entsprechend der angegebenen Sprache, um Treffer für kontextbezogene Synonyme, abgeleitete Formen, rechtschreibkorrigierte Begriffe, diakritische Varianten und mehr einzubeziehen.

Beschränkungen

  • Die Operatoren $near und $text können nicht in derselben Textsuche verwendet werden.
  • Pro find- oder aggregation-Suche ist nur ein $text-Operator zulässig.
  • Bei Aggregationen muss die Phase $match mit $text die erste Pipelinephase sein.
  • $text kann nur in $and und $or verschachtelt werden.
  • Wenn $text in $or enthalten ist, können die nicht suchbezogenen Disjunkte vorhandene sortierte Indexe verwenden, um die Suche zu optimieren. Wenn die anderen Disjunkte nicht indexiert sind, wird für die Suche ein Sammlungs-Scan verwendet.
  • $text kann nicht mit Hinweisen verwendet werden.
  • Abfragen mit Textsuche können nicht nach $natural sortiert werden.