Menu Docs

Página inicial do Docs → Desenvolver aplicações → Manual do MongoDB

Bulk.find.updateOne()

Nesta página

  • Descrição
  • Comportamento
  • Exemplo

Dica

A partir da versão 3.2, o MongoDB também fornece o método db.collection.bulkWrite() para executar operações de gravação em massa.

Descrição

Bulk.find.updateOne(<update>)

Adiciona uma única operação de atualização de documento a uma lista de operações em massa.

Use o método Bulk.find() para especificar a condição que determina qual documento atualizar. O método Bulk.find.updateOne() limita a atualização a um único documento. Para atualizar vários documentos, consulte Bulk.find.update().

Bulk.find.updateOne() aceita o seguinte parâmetro:

Parâmetro
Tipo
Descrição
atualizar
documento ou pipeline

As modificações a serem aplicadas. Podem ser uma dos seguintes:

Um documento de substituição

Contém apenas pares de campos e valores.

Consulte também Bulk.find.replaceOne().

Atualizar documento
Contém somente atualizar expressões do operador.

Aggregation pipeline

Começando no MongoDB 4.2

Contém apenas os seguintes estágios de agregação:

Para obter mais informações sobre o parâmetro de modificação de atualização, consulte a página de referência db.collection.updateOne().

A soma do documento <query> associado do Bulk.find() e do documento de atualização deve ser menor ou igual ao tamanho máximo do documento BSON.

Comportamento

Se o documento <update> contiver apenas expressões de operador de atualização , como em:

{
  $set: { status: "D" },
  $inc: { points: 2 }
}

Em seguida, Bulk.find.updateOne() atualiza apenas os campos correspondentes, status e points, no documento.

Exemplo

O exemplo a seguir inicializa um Bulk() construtor de operações para a items coleção e adiciona várias updateOne() operações à lista de operações.

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( { status: "D" } ).updateOne( { $set: { status: "I", points: "0" } } );
bulk.execute();

Atualização com aggregation pipeline

A partir da versão 4.2, os métodos de atualização podem aceitar um pipeline de agregação. Por exemplo, os seguintes usos:

  • o estágio $set, que pode fornecer um comportamento semelhante à expressão do operador de atualização $set,

  • A variável de agregação NOW, que produz a data/hora atual e pode fornecer comportamento semelhante a uma expressão de operador de atualização$currentDate. Para acessar variáveis de agregação, prefixe a variável com cifrões duplos $$ e coloque entre aspas.

var bulk = db.items.initializeUnorderedBulkOp();
bulk.find( {  status: "P" } ).updateOne(
   [
      { $set: { points: 0, lastModified: "$$NOW" } }
   ]
);
bulk.execute();

Dica

Veja também:

← Bulk.find.replaceOne()
Bulk.find.update() →

Nesta página