$setOnInsert (operador de actualización)

Definición

$setOnInsert

Si se realiza una operación de actualización con upsert: true genera una inserción de un documento y, a continuación, asigna los valores especificados a los campos del $setOnInsert $setOnInsert documento. Si la operación de actualización no genera una inserción, no realiza ninguna acción.

Puedes especificar la opción upsert para:

• db.collection.updateOne()

• db.collection.updateMany()

• db.collection.findOneAndUpdate()

db.collection.updateOne(
   <query>,
   { $setOnInsert: { <field1>: <value1>, ... } },
   { upsert: true }
)

Para especificar un <field> en un documento incrustado o en un arreglo, utiliza notación de puntos.

Comportamiento

A partir de MongoDB 5.0, los operadores de actualización procesan los campos de documentos con nombres basados en cadenas en orden lexicográfico. Los campos con nombres numéricos se procesan en orden numérico. Consulta Comportamiento del operador de actualización para obtener más información.

A partir de MongoDB 5.0, mongod ya no genera un error cuando utiliza un operador de actualización como $setOnInsert con una expresión de operando vacía ( { } ). Una actualización vacía no produce cambios y no genera ninguna entrada en el oplog (lo que significa que la operación es una “no-op").

Ejemplo

La colección products no contiene documentos.

Insertar un nuevo documento utilizando db.collection.updateOne() el parámetro inserción: true.

db.products.updateOne(
  { _id: 1 },
  {
     $set: { item: "apple" },
     $setOnInsert: { defaultQty: 100 }
  },
  { upsert: true }
)

MongoDB usa <query> para crear un nuevo documento con _id: 1. $setOnInsert actualiza el documento según lo especificado.

La colección products contiene el documento recién insertado:

{ "_id" : 1, "item" : "apple", "defaultQty" : 100 }

Cuando el parámetro inserción es true db.collection.updateOne():

• crea un nuevo documento

• aplica la operación $set

• aplica la operación $setOnInsert

Si db.collection.updateOne() coincide con un documento existente, MongoDB solo aplica la operación $set.