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.

Lea los documentos

En MongoDB, una operación de lectura consiste en consultar la base de datos. Esta página proporciona ejemplos.

Se pueden query documentos en MongoDB con los siguientes métodos:


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


Esta página proporciona ejemplos de operaciones de query utilizando el método db.collection.find() en mongosh.

Los ejemplos de esta página utilizan datos del conjunto de datos sample_mflix. Para obtener más información sobre cómo cargar este conjunto de datos en la implementación autogestionada de MongoDB, consultar Cargar el conjunto de datos de muestra. Si realizó alguna modificación en las bases de datos de muestra, es posible que deba descartar y volver a crear las bases de datos para ejecutar los ejemplos de esta página.

Para seleccionar todos los documentos de la colección, pasa un documento vacío como parámetro de filtro de query al método de búsqueda. El parámetro de filtro de query determina los criterios de selección:

db.movies.find( {} )

Esta operación utiliza un query predicate vacío de {}, que corresponde a la siguiente instrucción SQL:

SELECT * FROM movies

Para obtener más información, consulta find().

Para especificar condiciones de igualdad, utiliza expresiones <field>:<value> en el documento de filtro de query:

{ <field1>: <value1>, ... }

El siguiente ejemplo selecciona todos los documentos de la colección sample_mflix.movies donde rated es igual a "PG-13":

db.movies.find( { rated: "PG-13" } )

Esta operación utiliza un predicado de query de { rated: "PG-13" }, que corresponde a la siguiente instrucción SQL:

SELECT * FROM movies WHERE rated = "PG-13"

Un documento de filtro de query puedes utilizar los operadores de la query para especificar condiciones de la siguiente forma:

{ <field1>: { <operator1>: <value1> }, ... }

El siguiente ejemplo recupera todos los documentos de la colección sample_mflix.movies donde rated sea igual a "G" o "PG-13":

db.movies.find( { rated: { $in: [ "G", "PG-13" ] } } )

Nota

Aunque puedas utilizar el operador $or para esta query, utiliza el operador $in en lugar de $or cuando realizas comprobaciones de igualdad en el mismo campo.

La operación utiliza un predicado de query de { rated: { $in: [ "G", "PG-13" ] } }, que corresponde a la siguiente instrucción SQL:

SELECT * FROM movies WHERE rated in ("G", "PG-13")

Para obtener la lista completa de operadores del query de MongoDB, consulte Predicados de query.

Una query compuesta puede especificar condiciones para más de un campo en los documentos de la colección. Implícitamente, una conjunción lógica AND conecta las cláusulas de una query compuesta de modo que la query selecciona los documentos de la colección que cumplen todas las condiciones.

El siguiente ejemplo recupera todos los documentos en la colección sample_mflix.movies donde rated es igual a "G" y runtime es menor que ($lt) 90:

db.movies.find( { rated: "G", runtime: { $lt: 90 } } )

La operación utiliza un predicado de query de { rated: "G", runtime: { $lt: 90 } }, que corresponde a la siguiente instrucción SQL:

SELECT * FROM movies WHERE rated = "G" AND runtime < 90

Consulte operadores de comparación para otros operadores de comparación de MongoDB.

Usa el operador $or para especificar una query compuesta que una cada cláusula con una conjunción lógica OR. La query selecciona los documentos que coinciden con al menos una condición.

El siguiente ejemplo recupera todos los documentos de la colección sample_mflix.movies donde rated es igual a "G" o runtime es menor que ($lt) 90:

db.movies.find( { $or: [ { rated: "G" }, { runtime: { $lt: 90 } } ] } )

La operación utiliza un predicado de query de { $or: [ { rated: 'G' }, { runtime: { $lt: 90 } } ] }, que corresponde a la siguiente instrucción SQL:

SELECT * FROM movies WHERE rated = "G" OR runtime < 90

En el siguiente ejemplo, el documento de query compuesta selecciona todos los documentos en la colección sample_mflix.movies donde rated es igual a "G" y o runtime es menor que ($lt) 90 o title comienza con el carácter T:

db.movies.find( { rated: "G", $or: [ { runtime: { $lt: 90 } }, { title: /^T/ } ]} )

La operación utiliza un predicado de query de:

{ rated: 'G', $or: [ { runtime: { $lt: 90 } }, { title: { $regex: '^T' } } ]}

que corresponde a la siguiente instrucción SQL:

SELECT * FROM movies WHERE rated = "G"AND ( runtime < 90 OR title LIKE "T%")

Nota

MongoDB admite query con expresión regular $regex para realizar coincidencias de patrón de string.

La sintaxis de las expresiones regulares difiere entre mongosh y los drivers. mongosh utiliza literales de expresiones regulares de JavaScript (por ejemplo, { title: /^T/ }). Los drivers utilizan el operador $regex equivalente (por ejemplo, { title: { $regex: '^T' } }).

En este ejemplo se utiliza el conjunto de datos de películas de muestra. Para cargar el conjunto de datos de muestra en tu implementación de MongoDB Atlas, consulta Cargar datos de muestra.

Para proyectar campos para una query en MongoDB Atlas, siga estos pasos:

1
  1. Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.

  2. Si aún no se muestra, seleccione su proyecto en el menú Projects de la barra de navegación.

  3. En la barra lateral, haz clic en Clusters en la sección Database.

    La página de clústeres se muestra.

2
  1. Para el clúster que contiene los datos de muestra, haz clic en Browse Collections.

  2. En el panel de navegación izquierdo, seleccione la base de datos sample_mflix.

  3. Seleccione la colección movies.

3

Especifique el documento de filtro de query en el campo Filter. Un documento de filtro de query utiliza operadores del query para especificar las condiciones de búsqueda.

Copie el siguiente documento de filtro de query en la barra de búsqueda Filter:

{ year: 1924 }
4

La query devuelve todos los documentos de la colección sample_mflix.movies donde el campo year coincide con 1924.

Para más ejemplos de consultas, vea:

El método db.collection.find() devuelve un cursor a los documentos coincidentes.

A medida que un cursor devuelve documentos, otras operaciones pueden ejecutarse en segundo plano y afectar los resultados, dependiendo del nivel de consistencia de lectura. Para más detalles, consulte Aislamiento de lectura, coherencia y actualidad.

Para las lecturas en sets de réplicas y particiones de sets de réplicas, el nivel de consistencia de lectura permite a los clientes elegir un nivel de aislamiento para sus lecturas. Para obtener más información, consulte nivel de consistencia de lectura.

Cuando ejecutas una operación de búsqueda con un driver de MongoDB o mongosh, MongoDB devuelve un cursor que gestiona los resultados de la query. Los resultados de la query no se devuelven como un arreglo de documentos.

Para aprender a iterar a través de documentos en un cursor, consulta la documentación de tu driver. Si utilizas mongosh, consulta Itera un cursor en mongosh.

También puedes leer documentos de una colección con:

Nota

El método db.collection.findOne() realiza la misma operación que db.collection.find() con un límite de 1.