У Cloud Firestore є три операції запису:
1) додати
2) встановити
3) оновлення
У документах сказано, що використання set(object, {merge: true})об'єднає об'єкт із існуючим.
Те ж саме відбувається при використанні. update(object)
Яка різниця, якщо така є? Дивно здається, що Google буде дублювати логіку.
Відповіді:
Те, як я зрозумів різницю:
setбез mergeбуде перезаписати документ або створити його, якщо він ще не існує
setз mergeоновить поля в документі або створить його, якщо його не існує
update оновить поля, але вийде з ладу, якщо документа не існує
create створить документ, але не вдасться, якщо документ вже існує
Існує також різниця у типі даних, які ви надаєте setта update.
Для setвас завжди повинні надавати дані документа в формі:
set(
{a: {b: {c: true}}},
{merge: true}
)
З updateвами також можна використовувати шляхи поля для оновлення вкладених значень:
update({
'a.b.c': true
})
setдіє на документах у формі документа, де updateприймаються пара поля шляху та значення. Це означає, що ви можете внести зміни до глибоко вкладених значень, updateякі є більш громіздкими set. Наприклад: set({a: {b: {c: true}}}, {merge: true})проти update('a.b.c', true).
Інша відмінність (розширення відповіді Скарігамі) між "встановити злиттям" та "оновити", полягає в роботі з вкладеними значеннями.
якщо у вас такий документ структурований:
{
"friends": {
"friend-uid-1": true,
"friend-uid-2": true,
}
}
і хочете додати {"friend-uid-3" : true}
використовуючи це:
db.collection('users').doc('random-id').set({
"friends": {
"friend-uid-3": true
}
},{merge:true})
це призведе до цих даних:
{
"friends": {
"friend-uid-1": true,
"friend-uid-2": true,
"friend-uid-3": true
}
}
проте updateвикористовуючи це:
db.collection('users').doc('random-id').update({
"friends": {
"friend-uid-3": true
}
})
це призведе до цих даних:
`{
"friends": {
"friend-uid-3": true
}
}`
{ merge: true }для функції оновлення.
update, ви можете використовувати позначення крапок . Поведінка перезапису updateвідрізняється, якщо ви робите / не використовуєте позначення крапок.
За документами: https://firebase.google.com/docs/firestore/manage-data/add-data#update_fields_in_nested_objects
Нотація точок дозволяє оновити одне вкладене поле без перезаписання іншого вкладеного поля. Якщо ви оновите вкладене поле без позначок крапки, ви перезаместите все поле карти.
Як було сказано вище, це замінює всю структуру друзів.
db.collection('users').doc('random-id').update({
"friends": {
"friend-uid-3": true
}
})
Це не так.
db.collection('users').doc('random-id').update({
"friends.friend-uid-3": true
})
createметод в API?