Modificar documentos

Abrir tutorial interativo

Visão geral

Você pode modificar documentos em uma collection MongoDB usando as operações de atualização e substituição. As operações de atualização modificam os campos e valores de um documento, mantendo outros campos e valores inalterados. Substituir operações substitui todos os campos e valores em um documento existente por campos e valores especificados, mantendo o valor do campo _id inalterado.

O driver do Node.js fornece os seguintes métodos para alterar documentos:

• updateOne()

• updateMany()

• replaceOne()

Atualize documentos

Para executar uma atualização em um ou mais documentos, crie um documento de atualização que especifique o operador de atualização (o tipo de atualização a ser executada) e os campos e valores que descrevem a alteração. Atualize os documentos usando o seguinte formato:

{
   <update operator>: {
      <field> : {
         ...
      },
      <field> : {
      }
   },
   <update operator>: {
      ...
   }
}

O nível superior de um documento de atualização contém um ou mais dos seguintes operadores de atualização:

• $set: substitui o valor de um campo por um campo especificado

• $inc: aumenta ou diminui os valores do campo

• $rename: renomeia campos

• $unset: remove campos

• $mul: multiplica um valor de campo por um número especificado

Consulte o manual do MongoDB Server para obter uma lista completa de operadores de atualização e seu uso.

Os operadores de atualização se aplicam apenas aos campos associados a eles em seu documento de atualização.

{
   _id: 465,
   item: "Hand-thrown ceramic plate",
   price: 32.50,
   quantity: 7,
}

const filter = { _id: 465 };
// update the value of the 'quantity' field to 5
const updateDocument = {
   $set: {
      quantity: 5,
   },
};
const result = await collection.updateOne(filter, updateDocument);

{
   _id: 465,
   item: "Hand-thrown ceramic plate",
   price: 32.50,
   quantity: 5,
}

Substituir um documento

Para executar uma operação de substituição, crie um documento de substituição que consista nos campos e valores que você gostaria de usar em sua operação de substituição. Os documentos de substituição usam o seguinte formato:

{
   <field>: {
      <value>
   },
   <field>: {
      ...
   }
}

Documentos de substituição são os documentos que você deseja substituir os documentos existentes que correspondem aos filtros de consulta.

{
   _id: 501,
   item: "3-wick beeswax candle",
   price: 18.99,
   quantity: 10,
}

const filter = { _id: 501 };
// replace the matched document with the replacement document
const replacementDocument = {
   item: "Vintage silver flatware set",
   price: 79.15,
   quantity: 1,
};
const result = await collection.replaceOne(filter, replacementDocument);

{
   _id: 501,
   item: "Vintage silver flatware set",
   price: 79.15,
   quantity: 1,
}