Atualizar um documento
Você pode atualizar um único documento usando o arquivo collection.updateOne() método. O método updateOne() aceita um documento de filtro e um documento de atualização. Se a query corresponder aos documentos na coleção, o método aplicará as atualizações do documento de atualização aos campos e valores deles. O documento de atualização contém operadores de atualização que instruem o método sobre as alterações a serem feitas nas correspondências.
Você pode especificar opções de consulta adicionais utilizando o objeto options passado como o segundo parâmetro do método updateOne(). Defina a opção upsert como true para criar um novo documento se nenhum documento corresponder ao filtro. Para obter informações adicionais, consulte a documentação da API do updateOne().
updateOne() linha uma exceção se ocorrer um erro durante a execução. Se você especificar um valor em seu documento de atualização para o campo imutável _id, o método lançará uma exceção. Se o documento de atualização contiver um valor que viole regras de índice exclusivas, o método lançará uma exceção de duplicate
key error.
Observação
Se seu aplicativo exigir o documento após a atualização, avalie usar o método collection.findOneAndUpdate(), que tem uma interface semelhante a updateOne(), mas também retorna o documento original ou atualizado.
Exemplo
O exemplo a seguir usa o operador de atualização $set, que especifica valores de atualização para campos do documento. Para obter mais informações sobre operadores de atualização, consulte a documentação de referência do operador de atualização do MongoDB.
Observação
Você pode utilizar este exemplo para se conectar a uma instância do MongoDB e interagir com um banco de dados que contém dados de amostra. Para saber mais sobre como se conectar à sua instância do MongoDB e carregar um conjunto de dados de amostra, consulte o Guia de exemplos de uso.
Se você executar o exemplo acima, verá a seguinte saída:
1 document(s) matched the filter, updated 1 document(s)