$text (Sistemas autogerenciados)

Strings exatas

Para corresponder em uma string exata de várias palavras, em oposição a termos individuais, coloque a string entre aspas duplas (\"), como em:

"\"ssl certificate\""

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

Por exemplo, a seguinte string $search retorna documentos que contêm a string exata "ssl certificate":

"\"ssl certificate\" authority key"

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 é passada uma string que contém somente palavras negadas, o $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ê não diferencia maiúsculas e minúsculas e também diacríticos, o operador $text corresponde à palavra radical completa. Se um campo de documento contiver a palavra blueberry, uma operação $text com um termo $search de blue não terá correspondência. No entanto, blueberry ou blueberries terão correspondência.

$caseSensitive Opção

Para dar suporte à diferenciação de maiúsculas e minúsculas onde o índice text não faz essa diferenciação, especifique $caseSensitive: true.

Processo com diferenciação entre maiúsculas e minúsculas

Se $caseSensitive: true e o índice text não diferenciarem maiúsculas de minúsculas, o operador $text:

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

• Em seguida, para obter apenas os documentos que correspondem ao padrão de 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 ao padrão especificado.

Se $caseSensitive: true e se a base do sufixo contiver letras maiúsculas, o operador $text encontrará correspondência para a palavra exata.

Especificar $caseSensitive: true pode afetar o desempenho.

$diacriticSensitive Opção

Para permitir diferenciar diacríticos com o índice text, especifique $diacriticSensitive: true.

As queries de texto em versões anteriores do índice text já diferenciam diacríticos de forma inerente e não é possível alterar isso. Dessa forma, a opção $diacriticSensitive para o operador $text não tem efeito com versões anteriores do índice text.

Processo de diferenciação de diacríticos

Para usar a diferenciação de diacríticos ($diacriticSensitive: true) com um índice text de versão 3, 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 têm correspondência.

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 diferencia diacríticos.

Se $diacriticSensitive: true e se o radical do sufixo contiver a marca ou marcas diacríticas, o operador $text encontrará correspondência para a 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 string exata

O exemplo a seguir executa uma query que diferencia maiúsculas de minúsculas para a string de várias palavras exata 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 faz a correspondência do seguinte documento:

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

Diferenciação de diacríticos com um termo

O exemplo a seguir executa uma query de texto que diferencia 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 com distinção de 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 faz a correspondência do seguinte documento:

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

Retornar à 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 anexar 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 ordenar os documentos resultantes por sua relevância sem projetar o 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.

  For example, in the following operation, the projection uses a field named score for the expression and the sort() uses the field named 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 uma query do termo coffee e ordena os resultados pela pontuação decrescente, limitando os resultados aos dois principais documentos com correspondência:

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

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

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

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