$setOnInsert (operador de atualização)

Definição

$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.

Você pode especificar a opção upsert para:

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

Para especificar um <field> em um documento incorporado ou em uma array, use a notação de ponto.

Comportamento

A partir do MongoDB 5.0, os operadores de atualização processam campos de documento com nomes baseados em cadeia de caracteres em ordem lexicográfica. Os campos com nomes numéricos são processados em ordem numérica. Consulte Atualizar Comportamento de Operadores para detalhes.

Starting in MongoDB 5.0, mongod no longer raises an error when you use an update operator like $setOnInsert with an empty operand expression ( { } ). An empty update results in no changes and no oplog entry is created (meaning that the operation is a no-op).

Exemplo

A collection products não contém documentos.

Insira um novo documento utilizando o parâmetro upsert: verdadeiro db.collection.updateOne().

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

MongoDB uses <query> to create a new document with _id: 1. $setOnInsert updates the document as specified.

A collection products contém o documento recém-inserido:

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

Quando o parâmetro upsert é true db.collection.updateOne():

cria um novo documento
aplica a operação $set
applies the $setOnInsert operation

Se db.collection.updateOne() corresponder a um documento existente, o MongoDB aplicará somente a operação $set.

Dica

Voltar

$set

$unset