updateMany() (Atualizar Vários Documentos)

Última atualização: 2026-10-09

updateMany() (Atualizar Vários Documentos)

updateMany() atualiza todos os documentos que corresponderem a um filtro, ex.: `db.users.updateMany({ age: { $lt: 18 } }, { $set: { isTeen: true } })`. Diferente de updateOne(), que altera apenas a primeira correspondência, ele aplica a atualização a todos os documentos correspondentes — útil para mudanças em lote de status ou adição de campos em todo lugar. O resultado informa matchedCount (correspondências encontradas) e modifiedCount (documentos efetivamente alterados).

📝 Sintaxe

db.<collection>.updateMany(<filter>, <update>, { upsert: <bool> })

⚙️ Parâmetros

Retorno：UpdateResult: { acknowledged, matchedCount, modifiedCount, upsertedId }.

▶ Exemplo

Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):

// updateMany: marca todos com mais de 30 anos como senior
db.users.updateMany(
  { age: { $gt: 30 } },
  { $set: { isSenior: true } }
)

Saída：

{ acknowledged: true, matchedCount: 3, modifiedCount: 3, upsertedId: null }

📌 Notas

• Atualiza todas as correspondências; cuidado com o filtro vazio {} que atualiza a coleção inteira
• modifiedCount pode ser menor que matchedCount quando os valores não mudam
• Em coleções grandes, divida o trabalho em lotes e observe o desempenho

🏷️ Tags Relacionados

💡 Casos Relacionados

📚 Tutoriais Relacionados

❓ Perguntas Frequentes

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós