Cómo usar la búsqueda por texto

Usa las funciones de búsqueda de texto en Cloud Firestore para buscar cadenas específicas dentro de una colección.

Antes de comenzar

Antes de comenzar a usar las búsquedas de texto, haz lo siguiente:

  1. Asegúrate de tener acceso a una base de datos de operaciones compatible con MongoDB existente o crea una base de datos y conéctate a ella.

  2. Asegúrate de tener un índice de texto o crea uno.

Las búsquedas de texto usan el operador $text dentro de un filtro. Especifica la cadena consultada en el argumento $search.

Ejecuta el siguiente comando para realizar una búsqueda de texto general:

  # Find search
  db.cities.find({ $text: { $search: "french bread" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "french bread" } } }
  ]);

Si tu índice está particionado, puedes filtrar según la partición incluyendo la partición en un filtro de igualdad "and" dentro de tu búsqueda. Por ejemplo, si tuvieras una partición city, podrías filtrar una búsqueda de texto de la siguiente manera:

db.myCollection.find( { $and: [
  { $text: { $search: "french bread" } },
  { "city": "Paris" }
] } )

También puedes filtrar una agregación según una partición. Por ejemplo:

db.myCollection.aggregate([
 { $match: { $text: { $search: "french bread" } } },
 { "city": "Paris" }
] );

El valor de tu partición debe ser una cadena. Tu filtro de partición debe unirse a tu búsqueda de texto con un "and".

Configura el idioma de la búsqueda de texto

Puedes configurar el idioma de la búsqueda de texto con el argumento $language. Por ejemplo:

  db.cities.find({ $text: { $search: "french bread", $language: "en"} })

Si no configuras un idioma, la búsqueda usará el idioma del índice de texto.

Busca un término exacto

Para buscar un término exacto, configura el término como una secuencia de palabras encerradas entre comillas dobles. Por ejemplo:

  # Find search
  db.cities.find({ $text: { $search: "\"best french bread\"" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "\"best french bread\"" } } },
  ]);

Busca una combinación de términos

Para que tu búsqueda de texto sea más precisa, especifica una cadena de términos. Por ejemplo, la siguiente búsqueda muestra documentos que coinciden con la combinación best AND french AND ("bread" OR "is"):

  # Find search
  db.cities.find({ $text: { $search: "\"best\" \"french\" bread is" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "\"best\" \"french\" bread is" } } },
  ]);

Excluye un término

Para excluir un término de una búsqueda de texto, agrega un guion (-) antes del término:

  # Find search
  db.cities.find({ $text: { $search: "best bread -french"} })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best bread -french" } } },
  ]);

Calcula la puntuación de relevancia

Usa la expresión {$meta: "textScore"} para calcular la puntuación de relevancia de los documentos que coinciden con la búsqueda de texto. Para ordenar los resultados en orden descendente de puntuación, usa $meta en una expresión de orden. Considera los siguientes ejemplos, en los que SCORE_FIELD es el nombre del campo que se usa para almacenar el valor de la puntuación:

  # Find search
  db.cities
    .find({ $text: { $search: "best french bread" } })
    .sort({ SCORE_FIELD: { $meta: "textScore" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best french bread" } } },
    { $sort: { "SCORE_FIELD": { $meta: "textScore"} } },
  ]);

También puedes usar la puntuación de texto en expresiones de proyección. Por ejemplo:

  # Find search
  db.cities
    .find({ $text: { $search: "best french bread" } })
    .project({ score: { $meta: "textScore" } })

  # Aggregation search
  db.cities.aggregate([
    { $match: { $text: { $search: "best french bread" } } },
    { $project: { "scoreField": { $meta: "textScore"} } },
  ]);

Para mejorar la relevancia de los resultados de la búsqueda de texto, el operador $text aumenta la cadena de búsqueda según el idioma especificado para incluir coincidencias de sinónimos sensibles al contexto, formas derivadas, términos corregidos ortográficamente, variaciones de signos diacríticos y mucho más.

Limitaciones

  • Los operadores $near y $text no se pueden usar en la misma búsqueda de texto.
  • Se permite un solo operador $text por búsqueda find o aggregation.
  • En las agregaciones, la etapa $match con $text debe ser la primera etapa de la canalización.
  • $text solo se puede anidar dentro de $and y $or.
  • Si $text está dentro de $or, las disyunciones que no son de búsqueda pueden usar índices ordenados existentes para optimizar la búsqueda. Si las otras disyunciones no están indexadas, la búsqueda se basa en un análisis de la colección.
  • $text no se puede usar con sugerencias.
  • Las consultas con búsqueda de texto no se pueden ordenar por $natural.