/ /

Referencia de query

Opciones de rendimiento

Opciones de rendimiento

Devolver los campos de origen almacenados

Si ha configurado la opción storedSource en la definición de índice para una colección, MongoDB Search almacena los campos especificados en mongot. Puedes usar la opción booleana returnStoredSource en tus MongoDB Search queries para recuperar solo esos campos, en lugar de extraer documentos completos de la colección.

By default, MongoDB Search performs full document lookup implicitly on the backend database after MongoDB Search matches documents for the query. This lookup could significantly degrade performance for subsequent aggregation pipeline stages that fetch all matched dataset from $search stage (such as $sort, $group) or filter a large part of it (such as $match, $skip). If you configured the storedSource option, you can use the returnStoredSource option to retrieve only parts of the documents directly stored on MongoDB Search and avoid full document lookup on the database. This allows you to perform most database-side filtering operations on documents with a minimum number of fields. You can then retrieve all the fields from the documents at a later stage in the pipeline using $lookup.

Nota

returnStoredSource solo está disponible en tus clústeres que ejecutan MongoDB 7.0 y versiones posteriores.
For sharded collections, $lookup is only available on clusters running MongoDB 5.1 and later.

Sintaxis

returnStoredSource tiene la siguiente sintaxis en tus consultas:

{
  $search: {
    "<operator>": {
      <operator-specification>
    },
    "returnStoredSource": true | false // optional, defaults to "false"
  }
}

Para obtener más información sobre la sintaxis de query, consulta $search.

Comportamiento

La opción booleana returnStoredSource especifica si MongoDB Search debe realizar una búsqueda completa de documentos en la base de datos o devolver los campos almacenados directamente desde MongoDB Search. Puede utilizar la opción returnStoredSource sólo si la definición del índice incluye la configuración para el almacenamiento de campos en MongoDB Search. Para obtener más información sobre cómo almacenar campos en MongoDB Search, consulta Referencia del índice y Define Stored Source Fields in Your MongoDB Search Index.

Puedes establecer uno de los siguientes valores para la opción returnStoredSource:

true - para devolver solo los campos de origen almacenados directamente desde MongoDB Search
false - realizar una búsqueda implícita de documento completo en la base de datos backend (por defecto)

Si ejecuta consultas de búsqueda de MongoDB Search con la opción booleana returnStoredSource establecida en true:

MongoDB Search devuelve un documento vacío si este no incluye los campos configurados para el almacenamiento.
MongoDB Search devuelve errores si la definición del índice no incluye la configuración de Fuente almacenada.
MongoDB Search podría devolver datos obsoletos debido a un atraso de la replicación.
MongoDB Search podría devolver datos duplicados en clústeres particionados.

If you perform a high volume and rate of data insert and update operations for your collection on the backend database, MongoDB Search might return stale data because the data stored on mongot might not be current due to a replication lag. You can view the approximate number of milliseconds that MongoDB Search is behind in replicating changes from the oplog of mongod in the Atlas UI. To learn more, see Review MongoDB Search Metrics.

Si hay documentos huérfanos durante la migración de fragmentos, MongoDB Search podría devolver documentos duplicados en las consultas a clústeres fragmentados.

Uso de muestra

Si tu etapa $search descarta muchos de los resultados y necesitas realizar una búsqueda implícita de documentos en tu base de datos, te recomendamos usar la opción returnStoredSource. Puedes almacenar los campos necesarios para ordenar o filtrar y usar la opción returnStoredSource para realizar las siguientes acciones:

Operaciones intermedias en documentos parciales devueltos por MongoDB Search
$lookup al final del pipeline si se necesitan documentos completos.

Importante

Para mayor eficiencia, configura solo un número mínimo de campos para su almacenamiento en MongoDB Search. Utiliza esta opción si tus documentos son lo suficientemente grandes como para causar problemas durante la búsqueda.

Ejemplos

Los ejemplos de esta sección utilizan la colección sample_mflix.movies. Los ejemplos muestran cómo realizar un ordenamiento o emparejamiento en los documentos que MongoDB Search devuelve después de la etapa $search y luego buscar documentos en la base de datos.

Crea el índice usando la siguiente definición de índice. La definición de índice para la colección especifica los siguientes campos:
- Campo de índice title
- Guarde los campos year y title
{ "mappings": { "fields": { "title": { "type": "string" } } }, "storedSource": { "include": [ "year", "title" ] } }

Ejecuta la siguiente query en la colección:

db.movies.aggregate([
  {
    // search and output documents
    $search: {
      "text": {
        "query": "baseball",
        "path": "title"
      },
      "returnStoredSource": true // return stored fields only
    }
  },
  // fetch all matched dataset from $search stage and sort it
  {
    $sort: {"year": 1, "title": 1}
  },
  // discard everything except top 10 results
  {
    $limit: 10
  },
  // perform full document lookup for top 10 documents only
  {
    $lookup: {
      from: "movies", localField: "_id", foreignField: "_id", as: "document"
    }
  }
])

La query devuelve los siguientes documentos:

1 [
2   {
3     _id: ObjectId("573a1399f29313caabced370"),
4     title: 'Mr. Baseball',
5     year: 1992,
6     document: [
7       { ... } // full document returned by $lookup
8     ]
9   },
10   {
11     _id: ObjectId("573a1399f29313caabcee1aa"),
12     title: 'Baseball',
13     year: 1994,
14     document: [
15       { ... } // full document returned by $lookup
16     ]
17   }
18 ]

Crea el índice usando la siguiente definición de índice. La definición de índice para la colección especifica los siguientes campos:
- Campo de índice title
- Guarde los campos imdb.rating y imdb.votes
{ "mappings": { "fields": { "title": { "type": "string" } } }, "storedSource": { "include": [ "imdb.rating", "imdb.votes" ] } }

Ejecuta la siguiente query en la colección:

db.movies.aggregate([
  {
    // search and output documents
    $search: {
      "text": {
        "query": "baseball",
        "path": "title"
      },
      "returnStoredSource": true // return stored fields only
    }
  },
  // filter dataset from $search stage using $match
  {
    $match: {$or: [ { "imdb.rating": { $gt: 8.2 } }, { "imdb.votes": { $gte: 4500 } } ]}
  },
  // perform full document lookup for matched documents only
  {
    $lookup: {
      from: "movies", localField: "_id", foreignField: "_id", as: "document"
    }
  }
])

La query devuelve los siguientes documentos:

1 [
2   {
3     _id: ObjectId("573a1399f29313caabcee1aa"),
4     imdb: { rating: 9.1, votes: 2460 },
5     document: [
6       { ... } // full document returned by $lookup
7     ]
8   },
9   {
10     _id: ObjectId("573a1399f29313caabced370"),
11     imdb: { rating: 5.8, votes: 7617 },
12     document: [
13       { ... } // full document returned by $lookup
14     ]
15   }
16 ]

Volver

simultáneo

Entorno de prueba de búsqueda

1	[
2	{
3	_id: ObjectId("573a1399f29313caabced370"),
4	title: 'Mr. Baseball',
5	year: 1992,
6	document: [
7	{ ... } // full document returned by $lookup
8	]
9	},
10	{
11	_id: ObjectId("573a1399f29313caabcee1aa"),
12	title: 'Baseball',
13	year: 1994,
14	document: [
15	{ ... } // full document returned by $lookup
16	]
17	}
18	]

1	[
2	{
3	_id: ObjectId("573a1399f29313caabcee1aa"),
4	imdb: { rating: 9.1, votes: 2460 },
5	document: [
6	{ ... } // full document returned by $lookup
7	]
8	},
9	{
10	_id: ObjectId("573a1399f29313caabced370"),
11	imdb: { rating: 5.8, votes: 7617 },
12	document: [
13	{ ... } // full document returned by $lookup
14	]
15	}
16	]