/ /

Opciones de rendimiento

Docs Home

/ /

Referencia de query

Opciones de rendimiento

Opciones de rendimiento

Devolver los campos de origen almacenados

Si ha configurado la OpciónstoredSource en la definición de índice para una colección, MongoDB Search almacena los campos especificados en mongotPuede utilizar la opción booleana returnStoredSource en sus consultas de búsqueda de MongoDB para recuperar solo esos campos, en lugar de buscar documentos completos de la colección.

De forma predeterminada, MongoDB Search realiza una búsqueda completa de documentos de forma implícita en la base de datos backend después de que MongoDB Search encuentra documentos para la query. Esta búsqueda podría degradar significativamente el rendimiento de las etapas del pipeline de agregación que extraen todos los datos coincidentes de la etapa $search (como por ejemplo $sort$group,) o filtrar una gran parte (como,). Si configuró $match $skipla storedSource opción, puede usar la returnStoredSource opción para recuperar solo partes de los documentos almacenados directamente en MongoDB Search y evitar la búsqueda completa de documentos en la base de datos. Esto le permite realizar la mayoría de las operaciones de filtrado de la base de datos en documentos con un número mínimo de campos. Posteriormente, puede recuperar todos los campos de los documentos $lookup mediante.

Nota

returnStoredSource solo está disponible en tus clústeres que ejecutan MongoDB 7.0 y versiones posteriores.
Para las colecciones fragmentadas, solo está disponible en clústeres que ejecutan$lookup MongoDB 5.1 y versiones posteriores.

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 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.
La búsqueda de MongoDB devuelve errores si la definición del índice no incluye la configuración de la fuente almacenada.
Es posible que la búsqueda de MongoDB devuelva datos obsoletos debido a un retraso en la replicación.
MongoDB Search podría devolver datos duplicados en clústeres particionados.

Si realiza un gran volumen y una alta frecuencia de operaciones de inserción y actualización de datos en su colección en la base de datos de backend, MongoDB Search podría devolver datos obsoletos porque los datos almacenados en mongot podrían no estar actualizados debido a un retardo de replicación. Puedes ver el número aproximado de milisegundos que MongoDB Search lleva de retraso en la replicación de los cambios desde el oplog de mongod en la Interfaz de Usuario de Atlas. Para obtener más información, consulta Revisar métricas de MongoDB Search.

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 sobre documentos parciales devueltos por MongoDB Search
$lookup al final del pipeline si se necesitan documentos completos.

Importante

Para mayor eficiencia, configure solo un número mínimo de campos para el almacenamiento en MongoDB Search. Use esta opción si sus 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
- Almacenar los campos year y title
```
{
  "mappings": {
    "fields": {
      "title": {
        "type": "string"
      }
    }
  },
  "storedSource": {
    "include": [
      "year",
      "title"
    ]
  }
}
```

Ejecute la siguiente consulta contra 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
- Almacenar los campos imdb.rating y imdb.votes
```
{
  "mappings": {
    "fields": {
      "title": {
        "type": "string"
      }
    }
  },
  "storedSource": {
    "include": [
      "imdb.rating",
      "imdb.votes"
    ]
  }
}
```

Ejecute la siguiente consulta contra 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	]