$text (implementaciones autogestionadas)

Cadenas exactas

Para coincidir con una string exacta de varias palabras en lugar de términos individuales, escribe la string entre comillas dobles con 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 $search string devuelve documentos con la string exacta "ssl certificate":

"\"ssl certificate\" authority key"

Negaciones

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

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

• Una string que contiene únicamente palabras negativas no coincide con ningún documento.

• Las palabras con guion como pre-market no son negaciones. MongoDB trata el guion como un delimitador. Para negar market, utiliza 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 lenguaje, como the y and en inglés.

Palabras lematizadas

Con insensibilidad a mayúsculas, minúsculas y diacríticos, $text coincide con toda la palabra reducida. Si un campo de documento contiene blueberry, un término $search de blue no coincide. Sin embargo, blueberry o blueberries sí coinciden.

Activación de la sensibilidad a 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:

• Realiza consultas en el índice de texto para obtener coincidencias sin distinción entre mayúsculas y minúsculas ni de diacríticos.

• Filtra los resultados para devolver únicamente 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.

Activar la sensibilidad a los diacríticos

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 distinguen entre signos diacríticos, por lo que $diacriticSensitive no tiene efecto.

Proceso de sensibilidad a los diacríticos

Con los í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 que devuelvan solamente documentos coincidentes con los signos diacríticos en los términos especificados.

Habilitar $diacriticSensitive: true puede disminuir el rendimiento.

Con las versiones anteriores del índice de texto, $diacriticSensitive: true consulta el índice de texto que ya es sensible a los signos 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 mayúsculas y minúsculas

Este ejemplo realiza una query que distingue 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 String exacta respetando mayúsculas y minúsculas.

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

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 sensible a mayúsculas y minúsculas

Se puede utilizar la sensibilidad a mayúsculas y minúsculas con términos negados (términos precedidos con -).

Este ejemplo realiza una query que distingue entre mayúsculas y minúsculas para documentos que contienen Coffee pero no shop (versiones con raíz):

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

Esto coincide con:

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

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

Este ejemplo realiza una query sensible a diacríticos para CAFÉ (versión reducida):

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

Puedes utilizar la sensibilidad a los diacríticos con términos negados (términos precedidos por -).

Este ejemplo realiza una query que distingue diacríticos para documentos que contienen leches pero no cafés (versiones con derivación):

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

Esto coincide con:

{ "_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

Utiliza limit() con sort() para devolver los documentos coincidentes más relevantes.

Este ejemplo query para coffee, ordena por puntuación descendente y limita los resultados a los dos documentos principales:

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

Combina $text con otras operaciones de query y ordenamiento

Este ejemplo coincide con los documentos donde author es "xyz" y subject contiene coffee o bake. Ordena por date ascendente, luego por puntuación de relevancia descendente:

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