$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, la siguiente string $search devuelve documentos que incluyen la string exacta "ssl certificate":

"\"ssl certificate\" authority key"

Negaciones

Prefijar una palabra con un guion-menos (-) niega una palabra:

• La palabra negada excluye los documentos que la contienen del conjunto de resultados.

• Cuando se pasa un string que solo contiene palabras negadas, $text no coincide con ningún documento.

• Una palabra con guion, como pre-market, no es una negación. Si se utiliza en una palabra con guion, el operador $text considera el guion-menos (-) como un delimitador. Para negar la palabra market en esta instancia, incluye un espacio entre pre y -market, es decir, pre -market.

El operador $text agrega todas las negaciones a la operación con el operador lógico AND.

Palabras irrelevantes

El operador $text ignora las palabras de parada específicas del idioma, como the y and en inglés.

Palabras lematizadas

Cuando no utilizas la distinción entre mayúsculas y minúsculas y la distinción de diacríticas, el operador $text busca coincidencias con la palabra lematizada completa. Si un campo de documento contiene la palabra blueberry, la operación $text con un término $search de blue no coincide. Sin embargo, blueberry o blueberries coinciden.

$caseSensitive Opción

Para dar soporte a la distinción entre mayúsculas y minúsculas donde el índice text distinga entre mayúsculas y minúsculas, especifica $caseSensitive: true.

Proceso de sensibilidad a los casos

Si $caseSensitive: true y el índice text no distingue entre mayúsculas y minúsculas, el operador $text:

• Primero realiza queries del índice text para coincidencias que no distinguen entre mayúsculas y minúsculas ni diacríticas.

• Luego, para devolver solo los documentos que coinciden con las mayúsculas y minúsculas de los términos especificados, la operación $text incluye una etapa adicional para filtrar los documentos que no coinciden con las mayúsculas y minúsculas especificadas.

Si $caseSensitive: true y si la raíz del sufijo contiene letras mayúsculas, el operador $text coincide exactamente con la palabra.

La especificación de $caseSensitive: true puede afectar el rendimiento.

$diacriticSensitive Opción

Para admitir la distinción de diacríticas con el índice text, especifica $diacriticSensitive: true.

Los queries de texto respecto a versiones anteriores del índice de text distinguen diacríticas inherentemente y esto no se pueden anular. Por lo tanto, la opción $diacriticSensitive para el operador $text no tiene efecto con versiones anteriores del índice text.

Proceso de sensibilidad a los diacríticos

Para usar la distinción de diacríticas ($diacriticSensitive: true) con un índice text de versión 3, el operador $text:

• Primero realiza queries en el índice text, que no distingue entre diacríticas.

• Luego, para devolver solo los documentos que coinciden con los caracteres marcados con diacríticas de los términos especificados, la operación $text incluye una etapa adicional para filtrar los documentos que no coinciden.

La especificación de $diacriticSensitive: true puede afectar el rendimiento.

Si usas $diacriticSensitive: true con una versión anterior del índice text, el operador $text consulta el índice text, que distingue diacríticas.

Si $diacriticSensitive: true y si la raíz del sufijo contiene el signo o los signos diacríticos, el operador $text busca coincidencias con la palabra exacta.

Distinción entre mayúsculas y minúsculas con un término

El siguiente ejemplo realiza un query que distingue entre mayúsculas y minúsculas para el término Coffee:

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

La operación coincide solo con el siguiente documento:

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

Distinción entre mayúsculas y minúsculas con una string exacta

El siguiente ejemplo realiza un query que distingue entre mayúsculas y minúsculas para la string de varias palabras Café Con Leche:

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

La operación coincide solo con el siguiente documento:

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

Distinción entre mayúsculas y minúsculas con un término negado

Un término negado es un término precedido por un signo menos -. Si niegas un término, el operador $text excluirá los documentos que contengan esos términos de los resultados. También puedes especificar la distinción entre mayúsculas y minúsculas para términos negados.

El siguiente ejemplo realiza un query distingue entre mayúsculas y minúsculas para documentos que contienen la palabra Coffee pero no contienen el término en minúscula shop, o más precisamente la versión derivada de las palabras:

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

La operación coincide con el siguiente documento:

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

Distinción de diacríticas con un término

El siguiente ejemplo realiza un query de texto que distingue diacríticas en el término CAFÉ, o más precisamente la versión lematizada de la palabra:

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

La operación solo coincide con el siguiente documento:

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

Sensibilidad a los diacríticos con término negado

La opción $diacriticSensitive también se aplica a los términos negados. Un término negado es un término que está precedido por un signo menos -. Si niegas un término, el operador $text excluirá los documentos que contengan esos términos de los resultados.

El siguiente ejemplo realiza un query de texto que distingue diacríticas para documentos que contienen el término leches pero no el término cafés, o más precisamente la versión lematizada de las palabras:

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

La operación coincide con el siguiente documento:

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

Devuelva la puntuación de relevancia

En el siguiente ejemplo, se realiza un query de texto para el término cake y utiliza el operador $meta en el documento de proyección 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 adicional score que contiene la puntuación de relevancia del documento:

{ "_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 el método limit() en conjunto con un sort() para devolver los n documentos más coincidentes.

El siguiente ejemplo realiza un query del término coffee y ordena los resultados por calificación descendente, limitando los resultados a los dos documentos que más coinciden:

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

$text con expresiones de query y clasificación adicionales

El siguiente ejemplo coincide con documentos donde author es igual a "xyz" y el campo indexado subject contiene los términos coffee o bake. La operación también especifica un orden de clasificación de date ascendente y, luego, una puntuación de relevancia descendente:

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