/ /

/ /

$setOnInsert (operador de actualización)

Definición

$setOnInsert

If an update operation with upsert: true results in an insert of a document, then $setOnInsert assigns the specified values to the fields in the document. If the update operation does not result in an insert, $setOnInsert does nothing.

Puedes especificar la opción upsert para:

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.

Tip

Volver

$set

$unset