Método MongoDB updateOne() – db.Collection.updateOne()

En MongoDB, el método updateOne() actualiza un primer documento coincidente dentro de la colección según la consulta dada. Cuando actualiza su documento, el valor del campo _id permanece sin cambios. Este método actualiza un documento a la vez y también puede agregar nuevos campos en el documento dado. Toma tres parámetros, el primero es el criterio de selección para actualizar el documento, el segundo son los nuevos datos a actualizar, y los restantes son opcionales.

• Este método puede aceptar un documento que solo contenga expresiones de operador de actualización.
• Este método también puede aceptar canalización de agregación.
• En este método, si el valor de upsert se establece en verdadero para la colección de fragmentos, debe incluir la clave de fragmento completa en los criterios de filtro/selección. O si el valor de upsert no se establece en verdadero, debe incluir una coincidencia exacta en el campo _id.
• La operación de actualización fallará si esta operación cambia el tamaño del documento.
• También puede utilizar este método dentro de transacciones de varios documentos.

Sintaxis:

db.Collection_name.updateOne(

{Criterios_de_selección}, {$establecer:{Actualizar_datos}}, 

{

    upsert: <booleano>,

    escribirPreocupación: <documento>,

    intercalación: <documento>,

    arrayFilters: [<filtrodocumento1>, … ],

    pista: <documento|string>        

})

Parámetros:

• El primer parámetro es el valor Más antiguo en forma de Documentos. Los documentos son una estructura creada a partir de pares de archivos y valores, similares a los objetos JSON.
• El segundo parámetro debe contener una palabra clave $set para actualizar el siguiente valor de documento específico.
• El tercer parámetro es opcional.

Parámetros opcionales:

• upsert: el valor predeterminado de este parámetro es falso. Cuando es cierto, creará un nuevo documento en la colección cuando ningún documento coincida con la condición dada en el método de actualización.
• writeConcern: solo se usa cuando no desea usar la preocupación de escritura predeterminada. El tipo de este parámetro es un documento.
• colación: Especifica el uso de la colación para las operaciones. Permite a los usuarios especificar las reglas específicas del idioma para la comparación de strings, como reglas para mayúsculas y minúsculas y acentos. El tipo de este parámetro es un documento.
• arrayFilters: es una array de documentos de filtro que indica qué elementos de la array modificar para una operación de actualización en un campo de array. El tipo de este parámetro es una array.
• sugerencia: es un documento o campo que especifica el índice que se utilizará para admitir el filtro. Puede tomar un documento de especificación de índice o la string de nombre de índice y si especifica un índice que no existe, dará un error.

Devolver:

Este método devuelve un documento que contiene los siguientes campos:

• nMatched: este campo contiene el número de documentos coincidentes.
• contiene
• contiene
• reconocido: el valor de este campo es verdadero si el problema de escritura estaba habilitado o falso si el problema de escritura estaba deshabilitado.

Ejemplos:

En los siguientes ejemplos, estamos trabajando con:

Base de datos: gfg

Colección: estudiante

Documento: Cuatro documentos contienen el nombre y la edad de los estudiantes .

Ejemplo 1: Actualizar la edad del estudiante cuyo nombre es Annu

db.student.updateOne({name: "Annu"}, {$set:{age:25}})

Aquí, el primer parámetro es el documento cuyo valor se va a cambiar {nombre: «Annu»} y el segundo parámetro se establece mediante la palabra clave para establecer (actualizar) el siguiente primer valor de clave coincidente con el valor de clave anterior, es decir, de 20 a 24

Ejemplo 2: actualice el nombre del primer documento coincidente cuyo nombre es Bhannu a Babita

db.student.updateOne({name:"Bhannu"},{$set:{name:"Babita"}})

Aquí, el primer parámetro es el documento cuyo valor se cambiará {nombre: «Bhannu»} y el segundo parámetro se establece como medio de palabra clave para establecer (actualizar) el siguiente primer valor de clave coincidente con el valor de clave anterior.

Nota: Aquí, el valor de la clave debe ser del mismo tipo de datos que se definió en la colección.

Ejemplo 3: Insertar un nuevo campo en el documento usando el método updateOne

db.student.updateOne({name: "Bhannu"}, {$set:{class: 3}})

Aquí, se agrega un nuevo campo, es decir, clase: 3 en el documento de un estudiante cuyo nombre es Bhannu.