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.

Consultar un arreglo

Puedes consultar arreglos en MongoDB utilizando 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.


En esta página, se proporcionan ejemplos de operaciones de query en campos de arreglo mediante 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 especificar la condición de igualdad en un arreglo, utiliza el documento de query { <field>: <value> } donde <value> es el arreglo exacto que debe coincidir, incluido el orden de los elementos.

El siguiente ejemplo consulta todos los documentos donde genres es un arreglo con exactamente dos elementos, "Action" y "Comedy", en el orden especificado:

db.movies.find( { genres: ["Action", "Comedy"] } )

Para encontrar un arreglo que contenga tanto "Action" como "Comedy", independientemente del orden u otros elementos en el arreglo, utiliza el operador $all :

db.movies.find( { genres: { $all: ["Action", "Comedy"] } } )

Para realizar un query si el campo de arreglo contiene al menos un elemento con el valor especificado, usa el filtro { <field>: <value> } donde <value> es el valor del elemento.

El siguiente ejemplo consulta todos los documentos donde el arreglo genres contiene la cadena "Short" como uno de sus elementos:

db.movies.find( { genres: "Short" } )

Para especificar condiciones sobre los elementos en el campo de arreglo, utiliza operadores del query en el documento de filtro de query:

{ <array field>: { <operator1>: <value1>, ... } }

El siguiente **ejemplo** **query** todos los **documentos** donde el **arreglo** cast contiene al menos un elemento que coincida con la **expresión** regular ^A:

db.movies.find( { cast: { $regex: "^A" } } )

Cuando especifica condiciones compuestas en elementos de un arreglo, puede consultar documentos donde:

  • Un solo elemento del arreglo cumple todas las condiciones especificadas

  • Diferentes elementos de arreglo en conjunto cumplen todas las condiciones, y cada elemento satisface una o varias condiciones

El siguiente ejemplo hace un query en documentos en los que el arreglo cast contiene elementos que, en cierta combinación, cumplen las condiciones de la query. Un elemento puede satisfacer la condición $regex: "^A" y otro elemento puede satisfacer la condición $ne: "Adam Sandler", o un solo elemento puede satisfacer ambas:

db.movies.find( { cast: { $regex: "^A", $ne: "Adam Sandler" } })

Usa el operador $elemMatch para especificar múltiples criterios en los elementos de un arreglo, de modo que al menos un elemento del arreglo cumpla todos los criterios especificados.

El siguiente ejemplo consulta documentos en los que el arreglo cast contiene al menos un elemento que coincide con la expresión regular ^A y no es igual a "Adam Sandler":

db.movies.find( { cast: { $elemMatch: { $regex: "^A", $ne: "Adam Sandler" } } })

Utiliza la notación de puntos para especificar condiciones de query para un elemento en un índice o posición particular del arreglo. El arreglo utiliza indexación basada en cero.

Nota

Cuando realices queries utilizando la notación de puntos, el campo y el subcampo anidado deben estar entre comillas.

El siguiente ejemplo query todos los documentos donde el primer elemento del arreglo cast es igual a "Tom Hanks":

db.movies.find( { "cast.0": "Tom Hanks" } )

Utiliza el $size operador para consultar arreglos por cantidad de elementos.

El siguiente ejemplo selecciona los documentos donde genres tiene 3 elementos:

db.movies.find( { genres: { $size: 3 } } )

El ejemplo en esta sección utiliza el conjunto de datos de películas de muestra. Para aprender a cargar el conjunto de datos de muestra en la implementación de MongoDB Atlas, se debe consultar Cargar datos de muestra.

Para consultar un arreglo en MongoDB Atlas, sigue 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

Para consultar un documento que contiene un arreglo, especifique un documento de filtro de query. Un operadores del query utiliza un documento de filtro de query para especificar las condiciones de búsqueda. Utilice los siguientes documentos de ejemplo para query los campos de arreglo en la colección sample_mflix.movies.

Para aplicar un filtro de query, copiar un documento de ejemplo en la barra de búsqueda Filter y hacer clic en Apply.

Para especificar una condición de igualdad en un arreglo, usa el documento de consulta { <field>: <value> }, donde <value> es el arreglo exacto que se debe coincidir, incluido el orden de los elementos. El siguiente ejemplo encuentra documentos donde genres contiene el arreglo ["Action", "Comedy"] en el orden especificado:

{ genres: ["Action", "Comedy"] }

Para encontrar un arreglo que contenga tanto Action como Comedy, independientemente del orden u otros elementos en el arreglo, utiliza el operador $all :

{ genres: { $all: ["Action", "Comedy"] } }

Para obtener ejemplos adicionales de queries, consulte: