Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

$

El operador de $ proyección limita el contenido de un campo de matriz para que devuelva solo el primer elemento que coincida con la condición de consulta. Se utiliza para proyectar un único elemento de matriz coincidente.

Parámetros

Ejemplo (MongoDB Shell)

El siguiente ejemplo demuestra el uso del operador de $ proyección para devolver solo el elemento de matriz coincidente.

Cree documentos de muestra

db.students.insertMany([
  { _id: 1, name: "Alice", grades: [85, 92, 78, 95] },
  { _id: 2, name: "Bob", grades: [70, 88, 92, 65] },
  { _id: 3, name: "Charlie", grades: [95, 89, 91, 88] }
]);

Ejemplo de consulta

db.students.find(
  { grades: { $gte: 90 } },
  { name: 1, "grades.$": 1 }
);

Salida

{ "_id" : 1, "name" : "Alice", "grades" : [ 92 ] }
{ "_id" : 2, "name" : "Bob", "grades" : [ 92 ] }
{ "_id" : 3, "name" : "Charlie", "grades" : [ 95 ] }

En este ejemplo, solo se devuelve la primera calificación que sea mayor o igual a 90 para cada alumno.

Ejemplos de código

Para ver un ejemplo de código para usar el operador de $ proyección, elija la pestaña correspondiente al idioma que desee usar:

Node.js

const { MongoClient } = require('mongodb');

async function example() {
  const client = await MongoClient.connect('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false');
  const db = client.db('test');
  const collection = db.collection('students');

  const result = await collection.find(
    { grades: { $gte: 90 } },
    { projection: { name: 1, "grades.$": 1 } }
  ).toArray();

  console.log(JSON.stringify(result, null, 2));
  await client.close();
}

example();

Python

from pymongo import MongoClient

def example():
    client = MongoClient('mongodb://<username>:<password>@<cluster-endpoint>:27017/?tls=true&tlsCAFile=global-bundle.pem&replicaSet=rs0&readPreference=secondaryPreferred&retryWrites=false')
    db = client['test']
    collection = db['students']

    result = list(collection.find(
        {'grades': {'$gte': 90}},
        {'name': 1, 'grades.$': 1}
    ))

    print(result)
    client.close()

example()