$text (implementaciones autogestionadas)

Cadenas exactas

Para que coincida exactamente con una cadena de varias palabras en lugar de términos individuales, encierre la cadena entre comillas dobles de escape (\"): como en:

"\"ssl certificate\""

Si la string $search de una operación $text incluye una string de varias palabras y términos individuales, $text solo coincide con los documentos que incluyan la string de varias palabras.

Por ejemplo, esta cadena $search devuelve documentos con la cadena exacta "ssl certificate":

"\"ssl certificate\" authority key"

Negaciones

Anteponga un guión menos (-) a una palabra para negarla:

• Las palabras negadas excluyen del conjunto de resultados los documentos que contienen la palabra negada.

• Una cadena con solo palabras negadas no coincide con ningún documento.

• Las palabras con guion, como pre-market, no son negaciones. MongoDB trata el guion como delimitador. Para negar market, use pre -market.

MongoDB aplica todas las negaciones a la operación con AND lógico.

Palabras irrelevantes

MongoDB ignora las palabras vacías específicas del idioma, como the y and en inglés.

Palabras lematizadas

Sin distinción entre$text mayúsculas y minúsculas, coincide con la palabra completa. Si un campo de documento blueberry contiene, un $search término de blue no coincide. Sin embargo, blueberry o blueberries sí coinciden.

Habilitar la distinción entre mayúsculas y minúsculas

Especifique $caseSensitive: true para habilitar la distinción entre mayúsculas y minúsculas cuando el índice de texto no distinga entre mayúsculas y minúsculas.

Proceso de sensibilidad a los casos

Cuando $caseSensitive: true y el índice de texto no distingue entre mayúsculas y minúsculas, $text:

• Consulta el índice de texto en busca de coincidencias que no distingan entre mayúsculas y minúsculas y diacríticos.

• Filtra los resultados para devolver sólo los documentos que coincidan con el caso especificado.

Cuando $caseSensitive: true y el sufijo contiene letras mayúsculas, $text coincide con la palabra exacta.

Habilitar $caseSensitive: true puede disminuir el rendimiento.

Habilitación de la sensibilidad diacrítica

Especifique $diacriticSensitive: true para habilitar la sensibilidad a diacríticos con índices de texto de la versión 3.

Las versiones anteriores del índice de texto siempre son sensibles a los signos diacríticos, por lo que $diacriticSensitive no tiene efecto.

Proceso de sensibilidad a los diacríticos

Con índices de texto de la versión 3 y $diacriticSensitive: true, $text:

• Consulta el índice de texto insensible a los signos diacríticos.

• Filtra los resultados para devolver sólo los documentos que coincidan con los signos diacríticos en los términos especificados.

Habilitar $diacriticSensitive: true puede disminuir el rendimiento.

Con versiones de índice de texto anteriores, $diacriticSensitive: true consulta el índice de texto que ya es sensible a los diacríticos.

Cuando $diacriticSensitive: true y la raíz del sufijo contiene marcas diacríticas, $text coincide con la palabra exacta.

Búsqueda de términos que distingue entre mayúsculas y minúsculas

Este ejemplo realiza una consulta que distingue entre mayúsculas y minúsculas para Coffee:

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

Esto coincide solo con:

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

Búsqueda de cadena exacta que distingue entre mayúsculas y minúsculas

Este ejemplo realiza una consulta que distingue entre mayúsculas y minúsculas para una cadena de varias palabras exacta:

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

Esto coincide solo con:

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

Búsqueda de términos negados que distingue entre mayúsculas y minúsculas

Puede utilizar la distinción entre mayúsculas y minúsculas con términos negados (términos con el prefijo -).

Este ejemplo realiza una consulta que distingue entre mayúsculas y minúsculas para documentos que contienen Coffee pero no shop (versiones derivadas):

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

Esto coincide:

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

Búsqueda de términos sensibles a diacríticos

Este ejemplo realiza una consulta sensible a los diacríticos para CAFÉ (versión derivada):

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

Esto coincide solo con:

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

Búsqueda de términos negados sensibles a diacríticos

Puede utilizar la sensibilidad diacrítica con términos negados (términos con el prefijo -).

Este ejemplo realiza una consulta que distingue entre diacríticos para documentos que contienen leches pero no cafés (versiones derivadas):

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

Esto coincide:

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

Devuelva la puntuación de relevancia

Este ejemplo query por cake y utiliza $meta para añadir la puntuación de relevancia a cada documento coincidente:

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

El documento devuelto incluye un campo score con la puntuación de relevancia:

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

Ordenar por puntuación de relevancia

• Puedes especificar la expresión { $meta: "textScore" } en sort() sin especificar también la expresión en la proyección. Por ejemplo:

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

  Como resultado, se pueden ordenar los documentos resultantes por su relevancia sin proyectar el textScore.

• Si incluyes la expresión { $meta: "textScore" } tanto en la proyección como en el sort(), los documentos de proyección y orden pueden tener nombres de campo diferentes para la expresión.

  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" } } )

Devolver los 2 documentos coincidentes principales

Utilice limit() con para devolver los principales documentos sort() coincidentes.

Este ejemplo consulta coffee, ordena por puntuación descendente y limita los resultados a los dos documentos superiores:

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

Combine $text con otras operaciones de consulta y ordenación

Este ejemplo busca documentos donde author es "xyz" y subject contiene coffee o bake. Se ordena por puntuación de relevancia ascendente date y descendente:

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