$text (Sistemas autogerenciados)

Strings exatas

Para corresponder a uma string exata de várias palavras em vez de 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, esta string $search retorna documentos com a string exata "ssl certificate":

"\"ssl certificate\" authority key"

Negações

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

• As palavras negadas excluem documentos que contêm a palavra negada do conjunto de resultados.

• Uma string com apenas palavras negadas não corresponde a nenhum documento.

• Palavras hifenizadas como pre-market não são negações. O MongoDB trata o hífen como um delimitador. Para negar market, use pre -market.

O MongoDB aplica todas as negações à operação com AND lógico.

Palavras vazias

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

Palavras derivadas

Com insensibilidade a$text maiúsculas e minúsculas e diacríticos, corresponde à palavra derivada completa. Se um campo de documento blueberry contiver, um $search termo de blue não corresponderá. No entanto, blueberry ou blueberries correspondem.

Habilitando a sensibilidade a maiúsculas e minúsculas

Especifique $caseSensitive: true para ativar a sensibilidade a maiúsculas e minúsculas quando o índice de texto não for sensível a maiúsculas e minúsculas.

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

Quando $caseSensitive: true e o índice de texto não diferencia maiúsculas de minúsculas, $text:

• Executa queries no índice de texto para correspondências insensíveis a maiúsculas e minúsculas e insensíveis a diacríticos.

• Filtra os resultados para retornar apenas documentos que correspondam ao caso especificado.

Quando $caseSensitive: true e a base do sufixo contêm letras maiúsculas, $text corresponde à palavra exata.

Habilitar o $caseSensitive: true pode reduzir o desempenho.

Habilitando a sensibilidade a diacríticos

Especifique $diacriticSensitive: true para habilitar a sensibilidade a diacríticos com índices de texto versão 3.

As versões anteriores do índice de texto são sempre sensíveis a diacríticos, portanto, $diacriticSensitive não tem efeito.

Processo de diferenciação de diacríticos

Com índices de texto da versão 3 e $diacriticSensitive: true, $text:

• Consulta o índice de texto insensível a diacríticos.

• Filtra os resultados para retornar somente documentos que correspondam às marcas diacríticas nos termos especificados.

Habilitar o $diacriticSensitive: true pode reduzir o desempenho.

Com versões anteriores do índice de texto, o $diacriticSensitive: true executa queries do índice de texto já sensível a diacríticos.

Quando $diacriticSensitive: true e a base do sufixo contêm sinais diacríticas, $text corresponde à palavra exata.

Pesquisa de termos com distinção entre maiúsculas e minúsculas

Este exemplo executa uma query que diferencia maiúsculas de minúsculas para Coffee:

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

Corresponde apenas a:

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

Pesquisa de string exata sensível a maiúsculas e minúsculas

Este exemplo executa uma query com distinção entre maiúsculas e minúsculas para uma string exata com várias palavras:

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

Corresponde apenas a:

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

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

Você pode usar a sensibilidade a maiúsculas e minúsculas com termos negados (termos prefixados com -).

Este exemplo executa uma query que diferencia maiúsculas de minúsculas para documentos que contêm Coffee, mas não shop (versões derivadas):

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

Isso corresponde a:

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

Pesquisa de termos sensíveis a diacríticos

Este exemplo executa uma query sensível a diacríticos para CAFÉ (versão derivada):

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

Corresponde apenas a:

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

Pesquisa de termo negado sensível a diacríticos

Você pode usar a sensibilidade a diacríticos com termos negados (termos prefixados com -).

Este exemplo executa uma query sensível a diacríticos para documentos que contêm leches, mas não cafés (versões derivadas):

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

Isso corresponde a:

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

Retornar à Pontuação de Relevância

Este exemplo faz query para cake e usa para acrescentar a pontuação de relevância a cada documento $meta correspondente:

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

O documento retornado inclui um campo score com a pontuação de relevância:

{ "_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 limit() com para retornar os principais documentos sort() correspondentes.

Este exemplo consulta coffee, classifica por pontuação decrescente e limita os resultados aos dois principais documentos:

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

Combinar $text com outras operações de query e classificação

Este exemplo corresponde a documentos em que author é "xyz" e subject contém coffee ou bake. Ela classifica 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" } } )