Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Campos del proyecto a devolver del query


➤ Use el menú desplegable Seleccione su lenguaje en la parte superior derecha para establecer el lenguaje de los siguientes ejemplos.


➤ Use el menú desplegable Seleccionar su lenguaje en la parte superior derecha para establecer el lenguaje de los siguientes ejemplos o seleccione MongoDB Compass.


Por defecto, los query en MongoDB devuelven todos los campos de los documentos coincidentes. Para limitar la cantidad de datos que MongoDB envía a las aplicaciones, puede incluirse un documento de proyección para especificar o restringir los campos que se devolverán.

En esta página, se proporcionan ejemplos de operaciones de query con proyección mediante el método db.collection.find() en mongosh.

db.inventory.insertMany( [ { item: "journal", status: "A", size: { h: 14, w: 21, uom: "cm" }, instock: [ { warehouse: "A", qty: 5 } ] }, { item: "notebook", status: "A", size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "C", qty: 5 } ] }, { item: "paper", status: "D", size: { h: 8.5, w: 11, uom: "in" }, instock: [ { warehouse: "A", qty: 60 } ] }, { item: "planner", status: "D", size: { h: 22.85, w: 30, uom: "cm" }, instock: [ { warehouse: "A", qty: 40 } ] }, { item: "postcard", status: "A", size: { h: 10, w: 15.25, uom: "cm" }, instock: [ { warehouse: "B", qty: 15 }, { warehouse: "C", qty: 35 } ] }]);

Si no especificas un documento de proyección, el método db.collection.find() devuelve todos los campos de los documentos que coinciden.

El siguiente ejemplo devuelve todos los campos de todos los documentos en la colección inventory donde el status es igual a "A":

db.inventory.find( { status: "A" } )

La operación corresponde a la siguiente instrucción SQL:

SELECT * from inventory WHERE status = "A"

Una proyección puede incluir explícitamente varios campos estableciendo el <field> en 1 en el documento de proyección. La siguiente operación devuelve todos los documentos que coinciden con el query. En el conjunto de resultados, solo los campos item, status y, por defecto, _id se devuelven en los documentos coincidentes.

db.inventory.find( { status: "A" }, { item: 1, status: 1 } )

La operación corresponde a la siguiente instrucción SQL:

SELECT _id, item, status from inventory WHERE status = "A"

Puedes remover el campo _id de los resultados estableciéndolo en 0 en la proyección, como en el siguiente ejemplo:

db.inventory.find( { status: "A" }, { item: 1, status: 1, _id: 0 } )

La operación corresponde a la siguiente instrucción SQL:

SELECT item, status from inventory WHERE status = "A"

Nota

Con la excepción del campo _id, no es posible combinar instrucciones de inclusión y exclusión en documentos de proyección.

En lugar de listar los campos a devolver en el documento correspondiente, se puede usar una proyección para excluir campos específicos. El siguiente ejemplo devuelve todos los campos excepto los campos status y instock en los documentos coincidentes:

db.inventory.find( { status: "A" }, { status: 0, instock: 0 } )

Nota

Con la excepción del campo _id, no es posible combinar instrucciones de inclusión y exclusión en documentos de proyección.

Puedes devolver campos específicos en un documento incrustado. Utiliza la notación de puntos para referirte al campo incrustado y establecerlo en 1 en el documento de proyección.

El siguiente ejemplo devuelve:

  • El campo _id (devuelto por defecto),

  • El campo item,

  • El campo status,

  • El campo uom en el documento size.

El campo uom sigue incrustado en el documento size.

db.inventory.find( { status: "A" }, { item: 1, status: 1, "size.uom": 1 })

También puedes especificar campos incrustados utilizando la forma anidada. Por ejemplo, { item: 1, status: 1, size: { uom: 1 } }.

Puedes suprimir campos específicos en un documento incrustado. Utiliza la notación de puntos para referirte al campo incrustado en el documento de proyección y establecerlo en 0.

El siguiente ejemplo especifica una proyección para excluir el campo uom dentro del documento size. Todos los demás campos se devuelven en los documentos coincidentes:

db.inventory.find( { status: "A" }, { "size.uom": 0 })

También puedes especificar campos incrustados utilizando la forma anidada. Por ejemplo, { size: { uom: 0 } }.

Utiliza la notación de puntos para proyectar campos específicos dentro de documentos incrustados en un arreglo.

El siguiente ejemplo especifica una proyección para devolver:

  • El campo _id (devuelto por defecto),

  • El campo item,

  • El campo status,

  • El campo qty en los documentos incrustados en el arreglo instock.

db.inventory.find( { status: "A" }, { item: 1, status: 1, "instock.qty": 1 } )

Para los campos que contienen arreglos, MongoDB proporciona los siguientes operadores de proyección para manipular arreglos: $elemMatch, $slice y $.

En el siguiente ejemplo, se utiliza el operador de proyección $slice para devolver el último elemento del arreglo instock:

db.inventory.find( { status: "A" }, { item: 1, status: 1, instock: { $slice: -1 } } )

$elemMatch, $slice y $ son la única forma de proyectar elementos específicos para incluir en el arreglo devuelto. Por ejemplo, no puedes proyectar elementos específicos de un arreglo utilizando el índice del arreglo; p. ej. { "instock.0": 1 } proyección no proyectará el arreglo con el primer elemento.

Pueden especificarse expresiones de agregación en una proyección de query. Las expresiones de agregación le permiten proyectar nuevos campos y modificar los valores de los campos existentes.

Por ejemplo, la siguiente operación utiliza expresiones de agregación para sobrescribir el valor del campo status y proyectar nuevos campos area y reportNumber.

Nota

En el siguiente ejemplo, se utiliza la sintaxis de MongoDB Shell. Para ver ejemplos de driver de proyección con agregación, se debe consultar la documentación de driver.

db.inventory.find( { }, { _id: 0, item: 1, status: { $switch: { branches: [ { case: { $eq: [ "$status", "A" ] }, then: "Available" }, { case: { $eq: [ "$status", "D" ] }, then: "Discontinued" }, ], default: "No status found" } }, area: { $concat: [ { $toString: { $multiply: [ "$size.h", "$size.w" ] } }, " ", "$size.uom" ] }, reportNumber: { $literal: 1 } })
[ { item: 'journal', status: 'Available', area: '294 cm', reportNumber: 1 }, { item: 'planner', status: 'Discontinued', area: '685.5 cm', reportNumber: 1 }, { item: 'notebook', status: 'Available', area: '93.5 in', reportNumber: 1 }, { item: 'paper', status: 'Discontinued', area: '93.5 in', reportNumber: 1 }, { item: 'postcard', status: 'Available', area: '152.5 cm', reportNumber: 1 }]
  • Cuando se usa una etapa de agregación $project, normalmente debería ser la última etapa del pipeline y se utiliza para especificar qué campos devolver al cliente.

    Usar una etapa $project al principio o en medio de un pipeline para reducir el número de campos que se pasan a las etapas posteriores del pipeline es poco probable que mejore el rendimiento, ya que la base de datos realiza esta optimización automáticamente.

  • MongoDB aplica restricciones adicionales con respecto a las proyecciones. Consulta restricciones de proyección para obtener más detalles.