$text

Frases

Para corresponder em uma frase, em oposição a termos individuais, coloque a frase entre aspas duplas (\"), como em:

"\"ssl certificate\""

Se a string $search de uma operação $text incluir uma frase e termos individuais, a pesquisa de texto corresponderá somente aos documentos que incluem a frase.

Por exemplo, passou uma string $search:

"\"ssl certificate\" authority key"

O operador $text pesquisar a frase "ssl certificate".

Negações

Prefixar uma palavra com um hífen/sinal de menos (-) nega uma palavra:

• A palavra negada exclui documentos que contêm a palavra negada do conjunto de resultados.

• Quando for passada uma string de pesquisa que contém apenas palavras negadas, a pesquisa de texto não corresponderá a nenhum documento.

• Uma palavra hifenizada, como pre-market, não é uma negação. Se usado em uma palavra hifenizada, o operador $text trata o hífen/sinal de menos (-) como delimitador. Para negar a palavra market nesta instância, inclua um espaço entre pre e -market, ou seja, pre -market.

O operador $text adiciona todas as negações à query com o operador AND lógico.

Palavras vazias

O operador $text ignora palavras vazias específicas do idioma, como the e and em inglês.

Palavras derivadas

Para pesquisas de texto sem distinção entre maiúsculas e minúsculas e diacríticos, o operador $text corresponde à palavra derivada completa. Portanto, se um campo do documento contiver a palavra blueberry, uma pesquisa sobre o termo blue não corresponderá. No entanto, blueberry ou blueberries será compatível.

$caseSensitive Opção

Para oferecer suporte à pesquisa sensível a maiúsculas e minúsculas em que o índice text não diferencia maiúsculas de minúsculas, especifique $caseSensitive: true.

Processo de pesquisa sensível a maiúsculas e minúsculas

Ao realizar uma pesquisa sensível a maiúsculas e minúsculas ($caseSensitive: true) em que o índice text não diferencia maiúsculas de minúsculas, o operador $text :

• Primeiro, pesquisa o índice text em busca de correspondências sem diferenciação de maiúsculas e minúsculas e diacríticos.

• Em seguida, para retornar apenas os documentos que correspondem às maiúsculas e minúsculas dos termos da pesquisa, a operação de query $text inclui um estágio adicional para filtrar os documentos que não correspondem às maiúsculas e minúsculas especificadas.

Para pesquisas sensíveis a maiúsculas e minúsculas (ou seja, $caseSensitive: true), se a base do sufixo contiver letras maiúsculas, o operador $text corresponderá à palavra exata.

Especificar $caseSensitive: true pode afetar o desempenho.

$diacriticSensitive Opção

Para suportar pesquisa de texto sensível a diacríticos no índice text, especifique $diacriticSensitive: true.

As pesquisas de texto em versões anteriores do índice text são inerentemente sensíveis a diacríticos e não podem ser insensíveis a diacríticos. Dessa forma, a opção $diacriticSensitive para o operador $text não tem efeito com versões anteriores do índice text .

Processo de pesquisa sensível a diacríticos

Para executar uma pesquisa de texto sensível a diacríticos ($diacriticSensitive: true) em relação a um índice 3 text versão, o operador $text :

• Primeiro pesquisa o índice text, que não faz distinção entre diacríticos.

• Em seguida, para retornar apenas os documentos que correspondem aos caracteres com diacríticos dos termos da pesquisa, a operação de query $text inclui um estágio adicional para filtrar os documentos que não correspondem.

Especificar $diacriticSensitive: true pode afetar o desempenho.

Para executar uma pesquisa sensível a diacríticos em relação a uma versão anterior do índice text , o operador $text pesquisa o índice text , que é sensível a diacríticos.

Para pesquisas sensíveis a diacríticos, se a base do sufixo contiver diacríticos, o operador $text corresponderá à palavra exata.

Pesquisa sensível a maiúsculas e minúsculas de um termo

A query a seguir executa uma pesquisa que diferencia maiúsculas de minúsculas para o termo Coffee:

db.articles.find( { $text: { $search: "Coffee", $caseSensitive: true } } )

A pesquisa corresponde apenas ao documento:

{ "_id" : 2, "subject" : "Coffee Shopping", "author" : "efg", "views" : 5 }

Pesquisa sensível a maiúsculas e minúsculas de uma frase

A seguinte query executa uma pesquisa sensível a maiúsculas e minúsculas para a frase Café Con Leche:

db.articles.find( {
   $text: { $search: "\"Café Con Leche\"", $caseSensitive: true }
} )

A pesquisa corresponde apenas ao documento:

{ "_id" : 5, "subject" : "Café Con Leche", "author" : "abc", "views" : 200 }

Sensibilidade a maiúsculas e minúsculas com termo negado

Um termo negado é um termo prefixado por um sinal de menos -. Se você negar um termo, o operador $text excluirá os documentos que contêm esses termos dos resultados. Você também pode especificar a sensibilidade a maiúsculas e minúsculas para termos negados.

O exemplo a seguir executa uma pesquisa com distinção entre maiúsculas e minúsculas para documentos que contêm a palavra Coffee, mas não contêm o termo em minúsculas shop ou, mais precisamente, a versão derivada das palavras:

db.articles.find( { $text: { $search: "Coffee -shop", $caseSensitive: true } } )

A query corresponde ao seguinte documento:

{ "_id" : 2, "subject" : "Coffee Shopping", "author" : "efg" }

Pesquisa sensível a diacríticos de um termo

A seguinte query executa uma pesquisa de texto sensível a diacríticos no termo CAFÉ ou, mais precisamente, na versão derivada da palavra:

db.articles.find( { $text: { $search: "CAFÉ", $diacriticSensitive: true } } )

A query corresponde apenas ao seguinte documento:

{ "_id" : 5, "subject" : "Café Con Leche", "author" : "abc" }

Sensibilidade a diacríticos com termo negado

A opção $diacriticSensitive também se aplica a termos negados. Um termo negado é um termo prefixado por um sinal de menos -. Se você negar um termo, o operador $text excluirá os documentos que contêm esses termos dos resultados.

A query a seguir executa uma pesquisa de texto sensível a diacríticos para o documento que contém o termo leches, mas não o termo cafés, ou, mais precisamente, a versão derivada das palavras:

db.articles.find(
  { $text: { $search: "leches -cafés", $diacriticSensitive: true } }
)

A query corresponde ao seguinte documento:

{ "_id" : 8, "subject" : "Cafe con Leche", "author" : "xyz" }

Retornar a pontuação da pesquisa de texto

A query a seguir executa uma pesquisa de texto para o termo cake e usa o operador $meta no documento de projeção para acrescentar a pontuação de relevância a cada documento correspondente:

db.articles.find(
   { $text: { $search: "cake" } },
   { score: { $meta: "textScore" } }
)

O documento retornado inclui um campo adicional score que contém a pontuação de relevância do documento:

{ "_id" : 3, "subject" : "Baking a cake", "author" : "abc", "views" : 90, "score" : 0.75 }

Ordenar por pontuação de pesquisa de texto

• Você pode especificar a expressão { $meta: "textScore" } no sort() sem também especificar a expressão na projeção. Por exemplo:

  db.articles.find(
     { $text: { $search: "cake" } }
  ).sort( { score: { $meta: "textScore" } } )

  Como resultado, você pode ordenar os documentos resultantes por sua relevância de pesquisa sem projetar textScore.

• Se você incluir a expressão { $meta: "textScore" } na projeção e no sort(), a projeção e a ordenação dos documentos poderão ter nomes de campo diferentes para a expressão.

  Por exemplo, na seguinte operação, a projeção utiliza um campo denominado score para a expressão e sort() utiliza o campo denominado ignoredName.

  db.articles.find(
     { $text: { $search: "cake" } } ,
     { score: { $meta: "textScore" } }
  ).sort( { ignoredName: { $meta: "textScore" } } )

• No MongoDB 4.2, para ordenar pela pontuação de texto, inclua a mesma expressão $meta em ambos o documento de projeção e a expressão de ordenação. A seguinte query pesquisa o termo coffee e ordena os resultados pela pontuação decrescente:

  db.articles.find(
     { $text: { $search: "coffee" } },
     { score: { $meta: "textScore" } }
  ).sort( { score: { $meta: "textScore" } } )

  A query retorna os documentos correspondentes ordenados pela pontuação decrescente.

Retornar os 2 principais documentos correspondentes

Use o método limit() em conjunto com um sort() para retornar os principais documentos n correspondentes.

A query a seguir pesquisa o termo coffee e ordena os resultados pela pontuação decrescente, limitando os resultados aos dois principais documentos correspondentes:

db.articles.find(
   { $text: { $search: "coffee" } },
   { score: { $meta: "textScore" } }
).sort( { score: { $meta: "textScore" } } ).limit(2)

Pesquisa de texto com query adicional e expressões de ordenação

A seguinte query pesquisa documentos onde author é igual a "xyz" e o campo indexado subject contém os termos coffee ou bake. A operação também especifica uma ordem de classificação de date crescente e, em seguida, pontuação decrescente da pesquisa de texto:

db.articles.find(
   { author: "xyz", $text: { $search: "coffee bake" } },
   { score: { $meta: "textScore" } }
).sort( { date: 1, score: { $meta: "textScore" } } )