Especifique los campos a devolver

Datos de muestra

Los ejemplos de esta guía utilizan el sample_restaurants.restaurants colección de la Conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulte Guía deinicio rápido.

Especifica los campos que deseas incluir

Utilice la siguiente sintaxis para especificar los campos que se incluirán en el resultado de una operación de lectura:

projection(fields(include("<field name>")))

Para usar una proyección, pasa un filtro de query al método find(). Luego, encadene el método projection() a la llamada al método find().

El siguiente ejemplo utiliza el método find() para recuperar documentos en los que el valor del campo name es "Emerald Pub". Luego utiliza una proyección para incluir únicamente los campos name, cuisine y borough de los documentos devueltos.

FindPublisher<Document> findProjectionPublisher = restaurants.find(
                eq("name", "Emerald Pub"))
        .projection(fields(include("name", "cuisine", "borough")));
Flux.from(findProjectionPublisher)
        .doOnNext(System.out::println)
        .blockLast();

{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'}
{'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}

Cuando usas una proyección para especificar los campos que deseas incluir en el documento de retorno, el campo "_id" también se incluye por defecto. Todos los demás campos quedan implícitamente excluidos. Debe excluir explícitamente el campo _id para omitirlo de los documentos devueltos.

Excluir el campo _id

Puedes excluir el campo _id de los documentos devueltos utilizando el método excludeId().

El siguiente ejemplo realiza la misma query que en el ejemplo anterior, pero también excluye el campo _id en los documentos devueltos:

FindPublisher<Document> findProjectionPublisher = restaurants.find(
                eq("name", "Emerald Pub"))
        .projection(fields(include("name", "cuisine", "borough"), excludeId()));
Flux.from(findProjectionPublisher)
        .doOnNext(System.out::println)
        .blockLast();

{'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub'}
{'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub'}

Especificar campos a excluir

Utiliza la siguiente sintaxis para especificar los campos que deben excluirse del resultado de una operación de lectura:

projection(fields(exclude("<field name>")))

Para usar una proyección, pasa un filtro de query al método find(). Luego, encadene el método projection() a la llamada al método find().

El siguiente ejemplo utiliza el método find() para encontrar todos los restaurantes en los que el valor del campo name es "Emerald Pub". Luego utiliza una proyección para excluir los campos grades y address de los documentos devueltos.

FindPublisher<Document> findProjectionPublisher = restaurants.find(
                eq("name", "Emerald Pub"))
        .projection(fields(exclude("grades", "address")));
Flux.from(findProjectionPublisher)
        .doOnNext(System.out::println)
        .blockLast();

{'_id': ObjectId('...'), 'borough': 'Manhattan', 'cuisine': 'American', 'name': 'Emerald Pub', 'restaurant_id': '40367329'}
{'_id': ObjectId('...'), 'borough': 'Queens', 'cuisine': 'American', 'name': 'Emerald Pub', 'restaurant_id': '40668598'}

Cuando se utiliza una proyección para especificar qué campos excluir, cualquier campo no especificado se incluye implícitamente en el documento de retorno.

Error de inclusión y exclusión

El controlador devuelve lo siguiente si intenta incluir y excluir campos en una sola proyección:

OperationFailure: ... Cannot Do Exclusion on Field <field> in Inclusion Projection

Para solucionar este error, asegúrate de que tu proyección especifique solo campos a incluir o solo campos a excluir.

Documentación de la API

Para obtener más información sobre cualquiera de los métodos o tipos discutidos en esta guía, consultar la siguiente documentación de la API:

• find()

• FindPublisher