Różnica między ustawieniem z {merge: true} a aktualizacją

W Cloud Firestore są trzy operacje zapisu:

1) dodaj

2) zestaw

3) aktualizacja

W dokumentach jest napisane, że używanie set(object, {merge: true}) spowoduje scalenie obiektu z istniejącym.

To samo dzieje się, gdy używasz update(object) Więc jaka jest różnica, jeśli w ogóle? Wydaje się dziwne, że Google powiela logikę.

Sposób, w jaki zrozumiałem różnicę:

• setbez mergespowoduje nadpisanie dokumentu lub utworzenie go, jeśli jeszcze nie istnieje

• setwith mergezaktualizuje pola w dokumencie lub utworzy go, jeśli nie istnieje

• update zaktualizuje pola, ale zakończy się niepowodzeniem, jeśli dokument nie istnieje

• create utworzy dokument, ale zakończy się niepowodzeniem, jeśli dokument już istnieje

Istnieje również różnica w rodzaju danych, które udostępniasz setiupdate .

Na setzawsze trzeba dostarczyć dane dokumentu w kształcie:

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

Za pomocą updatemożesz również użyć ścieżek pól do aktualizacji zagnieżdżonych wartości:

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

Inna różnica (rozszerzenie odpowiedzi Scarygamiego) między "ustaw z scalaniem" i "aktualizacją" dotyczy pracy z zagnieżdżonymi wartościami.

jeśli masz dokument o takiej strukturze:

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

i chcesz dodać {"friend-uid-3" : true}

używając tego:

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

spowoduje, że dane te:

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

jednak updateużywając tego:

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

spowoduje, że dane te:

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

Na dokumenty: https://firebase.google.com/docs/firestore/manage-data/add-data#update_fields_in_nested_objects

Notacja z kropką umożliwia aktualizację pojedynczego pola zagnieżdżonego bez nadpisywania innego pola zagnieżdżonego. Jeśli zaktualizujesz zagnieżdżone pole bez notacji kropkowej, nadpiszesz całe pole mapy.

Jak wspomniano powyżej, zastępuje to całą strukturę znajomych.

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

Tak nie jest.

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