7. Actualizar documentos

Ahora aprenderás a modificar documentos existentes usando operadores de actualización.

Actualizar un documento

Para actualizar un solo documento usa updateOne:

db.listings.updateOne(
    { name: "Mi apartamento en Barcelona" },
    { $set: { price: "$80.00" } }
)

El primer parámetro es el filtro (qué documentos actualizar). El segundo es la actualización (qué cambiar).

Importante: siempre usa operadores como $set, $inc, etc. Si no lo haces, reemplazarás todo el documento.

Actualizar múltiples documentos

Para actualizar todos los documentos que coinciden con un filtro usa updateMany:

// Añade un campo a todos los listados de EXTRAMURS
db.listings.updateMany(
    { neighbourhood_group_cleansed: "EXTRAMURS" },
    { $set: { zona: "norte" } }
)

Reemplazar un documento

Para reemplazar completamente un documento usa replaceOne:

db.listings.replaceOne(
    { name: "Mi apartamento en Barcelona" },
    {
        name: "Mi apartamento renovado",
        neighbourhood_group_cleansed: "EIXAMPLE",
        room_type: "Entire home/apt",
        accommodates: 6,
        price: "$120.00"
    }
)

Esto elimina todos los campos antiguos y los reemplaza con los nuevos. Úsalo con cuidado.

Operadores de actualización

Los operadores más comunes:

$set: establece el valor de un campo

db.unicorns.updateOne(
    { name: 'Aurora' },
    { $set: { weight: 470 } }
)

$unset: elimina un campo del documento

db.unicorns.updateOne(
    { name: 'Aurora' },
    { $unset: { vampires: "" } }
)

$inc: incrementa (o decrementa) un valor numérico

// Incrementa vampiros en 2
db.unicorns.updateOne(
    { name: 'Aurora' },
    { $inc: { vampires: 2 } }
)

// Decrementa vampiros en 5
db.unicorns.updateOne(
    { name: 'Horny' },
    { $inc: { vampires: -5 } }
)

$min: actualiza solo si el nuevo valor es menor

db.scores.updateOne(
    { _id: 1 },
    { $min: { lowScore: 150 } }
)

$max: actualiza solo si el nuevo valor es mayor

db.scores.updateOne(
    { _id: 1 },
    { $max: { highScore: 1000 } }
)

$rename: renombra un campo

db.users.updateOne(
    { name: 'Ana' },
    { $rename: { 'name': 'fullName' } }
)

Operadores para arrays

$push: añade un elemento al final de un array

db.unicorns.updateOne(
    { name: 'Aurora' },
    { $push: { loves: 'sugar' } }
)

$pull: elimina todas las ocurrencias de un valor del array

db.unicorns.updateOne(
    { name: 'Aurora' },
    { $pull: { loves: 'carrot' } }
)

$addToSet: añade un elemento solo si no existe (sin duplicados)

db.unicorns.updateOne(
    { name: 'Aurora' },
    { $addToSet: { loves: 'apple' } }
)

Upsert

Un upsert actualiza un documento si existe, o lo inserta si no existe. Es muy útil para contadores o registros de eventos.

db.hits.updateOne(
    { page: 'unicorns' },
    { $inc: { hits: 1 } },
    { upsert: true }
)

La primera vez, como no existe el documento, lo crea con hits: 1. Las siguientes veces, incrementa el contador.

Actualizar múltiples documentos

Por defecto, updateOne solo actualiza el primer documento que encuentra. Para actualizar todos los que coinciden, usa updateMany:

// Vacuna a TODOS los unicornios
db.unicorns.updateMany(
    {},
    { $set: { vaccinated: true } }
)

Soluciones