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.

Update Documents

En MongoDB, una operación de actualización consiste en agregar, remover o modificar campos en uno o más documentos. Esta página proporciona ejemplos.

Puede actualizar documentos en MongoDB utilizando los siguientes métodos:


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


Los siguientes ejemplos usan la colección movies de la base de datos sample_mflix. Para aprender a cargar el conjunto de datos de muestra en tu implementación, consulta Cargar datos de muestra.

Para actualizar un documento, MongoDB proporciona operadores de actualización de campos, como $set, para modificar los valores de los campos.

Para utilizar los operadores de actualización, pasa a los métodos de actualización un documento de actualización con el formato:

{ <update operator>: { <field1>: <value1>, ... }, <update operator>: { <field2>: <value2>, ... }, ...}

Algunos operadores de actualización, como $set, crearán el campo si este no existe. Consultar la referencia del operador de actualización individual para más detalles.

En el siguiente ejemplo, se utiliza el método db.collection.updateOne() en la colección movies para actualizar el primer documento donde title es igual a "The Godfather":

db.movies.updateOne( { title: "The Godfather" }, { $set: { rated: "PG", "tomatoes.viewer.rating": 4.5 }, $currentDate: { lastupdated: true } })

La operación de actualización:

  • utiliza el operador $set para actualizar el valor del campo size.uom a "cm" y el valor del campo status a "P",

  • utiliza el operador $currentDate para actualizar el valor del campo lastModified a la fecha actual. Si el campo lastModified no existe, $currentDate creará el campo. Consulta $currentDate para obtener más detalles.

El siguiente ejemplo usa el método db.collection.updateMany() en la colección movies para actualizar todos los documentos donde num_mflix_comments es mayor que 100:

db.movies.updateMany( { "num_mflix_comments": { $gt: 100 } }, { $set: { popular: true }, $currentDate: { lastupdated: true } })

Para reemplazar todo el contenido de un documento excepto el campo _id, pasa un documento completamente nuevo como segundo argumento a db.collection.replaceOne().

Al reemplazar un documento, el documento de reemplazo debe consistir únicamente en pares de campo/valor. El documento de reemplazo no puede incluir expresiones de operadores de actualización.

El documento de reemplazo puede tener campos distintos a los del documento original. En el documento de reemplazo, puedes omitir el campo _id ya que el campo _id es inmutable. Sin embargo, si incluyes el campo _id, debe tener el mismo valor que el valor actual.

En el siguiente ejemplo, se reemplaza el primer documento de la colección movies donde title: "The Godfather":

db.movies.replaceOne( { title: "The Godfather" }, { title: "The Godfather", plot: "Updated plot summary", year: 1972, rated: "R", runtime: 175 })

Nota

Solo se puede actualizar un documento por vez en la interfaz de usuario de MongoDB Atlas. Para actualizar varios documentos o reemplazar un documento completo, se debe realizar la implementación de Atlas desde mongosh o un driver de MongoDB y seguir los ejemplos de esta página para el método de preferencia.

El ejemplo en esta sección utiliza el conjunto de datos de muestra de suministros. 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 actualizar un documento 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_supplies.

  3. Seleccione la colección sales.

3

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

Copia el siguiente documento de filtro de query en la barra de búsqueda Filter y haz clic en Apply:

{ saleDate: { $gte: { $date: "2016-01-01T00:00-00:00" }, $lte: { $date: "2016-01-02T00:00-00:00" } } }

Este filtro de query devuelve todos los documentos de la colección sample_supplies.sales donde saleDate está entre el 1 y el 2 de enero de 2016, hora UTC.

4

Para editar un documento que aparece en los resultados del query, pasa el ratón sobre el documento y haz clic en el icono del lápiz. En el editor de documentos, puedes:

  • Añade un nuevo campo.

  • Borrar un campo existente.

  • Edita el nombre, el valor o el tipo de un campo.

  • Revertir un cambio específico.

Para obtener instrucciones detalladas, consultar Crear, ver, actualizar y borrar documentos.

5

Para confirmar y guardar los cambios, haz clic en el botón Update.

Todas las operaciones de guardado en MongoDB son atómicas a nivel de un solo documento. Para obtener más información sobre MongoDB y la atomicidad, consulta Atomicidad y Transacciones.

Una vez establecido, no se podrá actualizar el valor del campo _id ni reemplazar un documento existente con un documento de reemplazo que tenga un valor diferente en el campo _id.

Utiliza el método updateMany() solo para operaciones idempotentes.

Para las operaciones de guardado, MongoDB conserva el orden de los campos del documento excepto en los siguientes casos:

  • El campo _id siempre es el primer campo del documento.

  • Las actualizaciones que incluyen renaming de los nombres de campo pueden resultar en el reordenamiento de los campos en el documento.

Si updateOne(), updateMany() o replaceOne() incluye upsert : true y ningún documento coincide con el filtro especificado, entonces la operación crea un nuevo documento y lo inserta. Si hay documentos que coinciden, la operación modifica o reemplaza dichos documentos.

Para obtener detalles sobre el nuevo documento creado, consulta las páginas de referencia individuales de los métodos.

Con los niveles de confirmación de escritura (write concern), se puede especificar el nivel de reconocimiento solicitado a MongoDB para las operaciones de escritura. Para obtener más detalles, consultar Nivel de confirmación de escritura.

Seleccionar el lenguaje
Califique esta página