使用文字搜尋

使用 Cloud Firestore 的文字搜尋功能，在集合中搜尋特定字串。

事前準備

開始使用文字搜尋功能前，請先完成下列步驟：

  1. 確認您有權存取現有的 MongoDB 相容作業資料庫，或建立資料庫並連線。

  2. 確認您有文字索引，或建立文字索引。

文字搜尋會在篩選器內使用 $text 運算子。 在 $search 引數中指定查詢字串。

執行下列指令，進行一般文字搜尋：

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

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

如果索引已分割，則可以在搜尋範圍內加入「and」等值篩選器，根據分割區進行篩選。舉例來說，如果您有 city 分割區，可以按照下列方式篩選文字搜尋結果：

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

您也可以根據分割區篩選匯總。例如：

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

分割區的值必須是字串。分區篩選器必須使用「and」與文字搜尋聯結。

設定文字搜尋語言

您可以使用 $language 引數設定文字搜尋語言。例如：

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

如未設定語言，搜尋時會使用文字索引的語言。

搜尋完全相符的字詞

如要搜尋完全相符的字詞，請將字詞設定為以雙引號括住的字詞序列。例如：

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

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

搜尋字詞組合

如要更精確地搜尋文字，請指定一連串的字詞。舉例來說，以下搜尋會傳回符合 best AND french AND ("bread" OR "is") 組合的檔案：

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

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

排除字詞

如要從文字搜尋中排除字詞，請在字詞前面加上連字號 (-)：

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

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

計算關聯性分數

使用 {$meta: "textScore"} 運算式計算文字搜尋比對到的文件相關分數。如要依分數遞減順序排序結果，請在排序運算式中使用 $meta。請參考下列範例，其中 SCORE_FIELD 是用於儲存分數值的欄位名稱：

  # 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"} } },
  ]);

您也可以在投影運算式中使用文字分數。例如：

  # 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"} } },
  ]);

為提升文字搜尋結果的關聯性，$text 運算子會根據指定語言擴增搜尋字串，納入符合脈絡的同義詞、詞幹形式、拼字修正字詞、變音符號變化等。

限制

  • $near 運算子和 $text 運算子無法在同一個文字搜尋中使用。
  • 每個 find 或 aggregation 搜尋最多只能使用一個 $text 運算子。
  • 在匯總中，具有 $text 的 $match 階段必須是第一個管道階段。
  • $text 只能巢狀內嵌在 $and 和 $or 中。
  • 如果 $text 位於 $or 內，非搜尋不連通項可能會使用現有的排序索引來最佳化搜尋。如果其他不連貫的項目未建立索引，搜尋作業就會依賴集合掃描。
  • $text 無法與提示搭配使用。
  • 使用文字搜尋的查詢無法依 $natural 排序。