$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, $text corresponderá apenas aos documentos que incluem a frase.

Por exemplo, passou uma string $search:

"\"ssl certificate\" authority key"

O operador $text retorna documentos que incluem 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 passou uma string que contém apenas palavras negadas, $text não corresponde 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 à operação 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

Quando você usa a insensibilidade a maiúsculas e minúsculas e a insensibilidade a diacríticos, o operador $text corresponde à palavra derivada completa. Se um campo do documento contiver a palavra blueberry, uma operação $text com um termo $search de blue não corresponderá. No entanto, blueberry ou blueberries correspondem.

$caseSensitive Opção

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

Processo de sensibilidade a maiúsculas e minúsculas

Se $caseSensitive: true e o índice text não forem sensíveis a maiúsculas e minúsculas, o operador $text :

• Primeiro, consulta o índice text para correspondências sem distinção entre 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 especificados, a operação $text inclui um estágio adicional para filtrar os documentos que não correspondem às maiúsculas e minúsculas especificadas.

Se $caseSensitive: true e 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 a sensibilidade a diacríticos com o índice text , especifique $diacriticSensitive: true.

As queries de texto em relação a 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 sensibilidade a diacríticos

Para usar a sensibilidade diacrítica ($diacriticSensitive: true) com um índice 3 text versão, o operador $text :

• Primeiro consulta 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 especificados, a operação $text inclui um estágio adicional para filtrar os documentos que não correspondem.

Especificar $diacriticSensitive: true pode afetar o desempenho.

Se você usar $diacriticSensitive: true com uma versão anterior do índice text , o operador $text consultará o índice text , que é sensível a diacríticos.

Se $diacriticSensitive: true e se a base do sufixo contiver diacríticos, o operador $text corresponderá à palavra exata.

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

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

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

A operação corresponde apenas ao seguinte documento:

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

Sensibilidade a maiúsculas e minúsculas com uma frase

O exemplo a seguir executa uma query que diferencia maiúsculas de minúsculas para a frase Café Con Leche:

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

A operação corresponde apenas ao seguinte 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 diferenciação de maiúsculas e minúsculas para termos negados.

O exemplo a seguir executa uma query 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 operação corresponde ao seguinte documento:

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

Sensibilidade a diacríticos com um termo

O exemplo a seguir executa uma query 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 operação 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.

O exemplo a seguir executa uma query de texto sensível a diacríticos para documentos 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 operação corresponde ao seguinte documento:

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

Retornar a pontuação de relevância

O exemplo a seguir executa uma query 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 }

Classificar por pontuação de relevância

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

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

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

• Se você incluir a expressão { $meta: "textScore" } na projeção e sort(), os documentos de projeção e classificação 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" } } )

Retornar os 2 principais documentos correspondentes

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

O exemplo a seguir faz query para o termo coffee e classifica 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)

$text com query adicional e expressões de classificação

O exemplo a seguir corresponde a documentos em que 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 de relevância decrescente:

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