Diferencia entre establecer con {merge: true} y actualizar

115

En Cloud Firestore hay tres operaciones de escritura:

1) agregar

2) establecer

3) actualización

En los documentos dice que el uso set(object, {merge: true})fusionará el objeto con uno existente.

Lo mismo sucede cuando usas update(object) Entonces, ¿cuál es la diferencia, si la hay? Parece extraño que Google duplique la lógica.

database firebase google-cloud-firestore

— ZuzEL
fuente

Respuestas:

263

La forma en que entendí la diferencia:

setsin mergesobrescribirá un documento o lo creará si aún no existe
setcon mergeactualizará los campos en el documento o lo creará si no existe
update actualizará los campos pero fallará si el documento no existe
create creará el documento pero fallará si el documento ya existe

También hay una diferencia en el tipo de datos que proporciona a sety update.

Porque setsiempre debe proporcionar datos en forma de documento:

set(
  {a: {b: {c: true}}},
  {merge: true}
)

Con updatetambién puede utilizar rutas de campo para actualizar valores anidados:

update({
  'a.b.c': true
})

— Scarygami
fuente

pero ¿dónde ha encontrado el createmétodo en la API?

— ZuzEL

cloud.google.com/nodejs/docs/reference/firestore/0.8.x/… para node.js. Parece que la API web no tiene ese método. No estaba seguro en qué plataforma estás :)

— Scarygami

Otra distinción que puede mencionar es que setopera sobre datos en forma de documento, donde updatetoma la ruta de campo y los pares de valores. Esto significa que puede realizar cambios en valores profundamente anidados updateque son más engorrosos set. Por ejemplo: set({a: {b: {c: true}}}, {merge: true})vs update('a.b.c', true).

— Gil Gilbert

Si quiero actualizar un valor en un documento, tiene sentido que quiera actualizar documentos que ya existen, así que creo que set + mergeall no es tan útil porque lo creará, el documento no existe

— John Balvin Arias

Si los datos que proporciona al comando set tienen un campo que es nulo, ¿establecerá el campo en nulo si ya está presente en la base de datos o lo dejará solo?

— user1023110

Otra diferencia (extendiendo la respuesta de Scarygami) entre "establecer con fusión" y "actualizar", es cuando se trabaja con valores anidados.

si tiene un documento estructurado así:

 {
   "friends": {
     "friend-uid-1": true,
     "friend-uid-2": true,
   }
 }

y quiero agregar {"friend-uid-3" : true}

usando esto:

db.collection('users').doc('random-id').set({ "friends": { "friend-uid-3": true } },{merge:true})

resultará en estos datos:

 {
   "friends": {
     "friend-uid-1": true,
     "friend-uid-2": true,
     "friend-uid-3": true
   }
 }

sin embargo updateusando esto:

db.collection('users').doc('random-id').update({ "friends": { "friend-uid-3": true } })

resultará en estos datos:

 `{
   "friends": {
     "friend-uid-3": true
   }
 }`

— Finlay Percy
fuente

¿Ha intentado probar esto usted mismo? Hay una sección en la documentación: "Para actualizar algunos campos de un documento sin sobrescribir todo el documento, use el método update () ..." enlace

— Finlay Percy

Me lo imaginé. Solo probé esto con una matriz antes. Donde quería agregar un objeto a la matriz, y todo se sobrescribió para esa matriz. No funciona con campos que contienen una matriz ... sí lo soporta.

— ravo10

Llegué a la misma conclusión después de las pruebas. Espero que agreguen una opción que tenga el mismo efecto { merge: true }que la función de actualización.

— Johnride

¡Gracias por esta respuesta! Los ejemplos, aunque simples, lo hicieron más claro que la respuesta aceptada, cuál era mejor para mi caso de uso.

— Naiveai

Para evitar sobrescribir datos en campos anidados (como en la respuesta anterior) al usar update, puede usar la notación de puntos . El comportamiento de sobrescritura de updatees diferente si usa o no la notación de puntos.

— Tedskovsky

Por documentos: https://firebase.google.com/docs/firestore/manage-data/add-data#update_fields_in_nested_objects

La notación de puntos le permite actualizar un solo campo anidado sin sobrescribir otro campo anidado. Si actualiza un campo anidado sin notación de puntos, sobrescribirá todo el campo del mapa.

Como se indicó anteriormente, esto reemplaza toda la estructura de amigos.

db.collection('users').doc('random-id').update({
    "friends": {
        "friend-uid-3": true
    }
})

Esto no lo hace.

db.collection('users').doc('random-id').update({
    "friends.friend-uid-3": true
})

— CodeManDan
fuente