Wyszukiwanie tekstowe

Korzystaj z funkcji wyszukiwania tekstu w Cloud Firestore, aby wyszukiwać określone ciągi znaków w kolekcji.

Zanim zaczniesz

Zanim zaczniesz korzystać z wyszukiwania tekstowego, wykonaj te czynności:

  1. Upewnij się, że masz dostęp do istniejącej bazy danych operacji zgodnej z MongoDB lub utwórz bazę danych i połącz się z nią.

  2. Sprawdź, czy masz indeks tekstowy, lub utwórz indeks tekstowy.

Wyszukiwanie tekstu wykorzystuje operator $text w filtrze. Określ ciąg znaków, którego dotyczy zapytanie, w argumencie $search.

Aby przeprowadzić ogólne wyszukiwanie tekstu, uruchom to polecenie:

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

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

Jeśli indeks jest podzielony na partycje, możesz filtrować według partycji, uwzględniając ją w filtrze równości „i” w wyszukiwaniu. Jeśli na przykład masz partycję city, możesz filtrować wyszukiwanie tekstowe w ten sposób:

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

Możesz też filtrować agregację na podstawie partycji. Przykład:

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

Wartość partycji musi być ciągiem znaków. Filtr partycji musi być połączony z wyszukiwaniem tekstowym za pomocą operatora „and”.

Ustawianie języka wyszukiwania tekstowego

Język wyszukiwania tekstowego możesz ustawić za pomocą argumentu $language. Przykład:

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

Jeśli nie ustawisz języka, wyszukiwanie będzie używać języka indeksu tekstowego.

Wyszukiwanie dokładnego terminu

Aby wyszukać dokładne słowo, skonfiguruj je jako ciąg słów ujęty w cudzysłów. Przykład:

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

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

Wyszukiwanie kombinacji haseł

Aby wyszukiwanie tekstu było bardziej precyzyjne, określ ciąg wyrazów. Na przykład to wyszukiwanie zwraca dokumenty pasujące do kombinacji najlepszy ORAZ francuski ORAZ („chleb” LUB „jest”):

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

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

Wykluczanie hasła

Aby wykluczyć termin z wyszukiwania tekstowego, dodaj przed nim myślnik (-):

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

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

Obliczanie wyniku trafności

Użyj wyrażenia {$meta: "textScore"}, aby obliczyć wynik trafności dokumentów pasujących do wyszukiwania tekstowego. Aby posortować wyniki w kolejności malejącej według wyniku, użyj w wyrażeniu sortowania symbolu $meta. Oto przykłady, w których SCORE_FIELD to nazwa pola używanego do przechowywania wartości wyniku:

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

W wyrażeniach projekcji możesz też używać wyniku tekstowego. Przykład:

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

Aby zwiększyć trafność wyników wyszukiwania tekstowego, operator $text rozszerza ciąg wyszukiwania zgodnie z określonym językiem, aby uwzględniać dopasowania do synonimów uwzględniających kontekst, form podstawowych, terminów z poprawioną pisownią, odmian diakrytycznych i innych.

Ograniczenia

  • Operatorów $near i $text nie można używać w tym samym wyszukiwaniu tekstowym.
  • W przypadku wyszukiwania find lub aggregation dozwolony jest tylko 1 operator $text.
  • W agregacjach etap $match z $text musi być pierwszym etapem potoku.
  • Element $text może być zagnieżdżony tylko w elementach $and i $or.
  • Jeśli $text znajduje się w $or, rozłączne warunki wyszukiwania mogą używać istniejących indeksów uporządkowanych do optymalizacji wyszukiwania. Jeśli pozostałe składniki alternatywy nie są indeksowane, wyszukiwanie opiera się na skanowaniu kolekcji.
  • $text nie można używać ze wskazówkami.
  • W przypadku zapytań z wyszukiwaniem tekstowym nie można sortować wyników według $natural.