Collection::addOrReplaceOne

(No version information available, might only be in Git)

Collection::addOrReplaceOne — Додає або замінює документ колекції

public mysql_xdevapi\Collection::addOrReplaceOne(string $id, string $doc): mysql_xdevapi\Result

Додає новий документ або замінює існуючий.

Ось кілька сценаріїв для цього методу:

Якщо ні ідентифікатор, ні якесь унікальне значення ключа не конфліктують з будь-яким документом у колекції, цей документ додається.
Якщо ідентифікатор не відповідає жодному документу, але одне або кілька унікальних значень ключів конфліктують із документом у колекції, видається помилка.
Якщо ідентифікатор відповідає існуючому документу та унікальні ключі не визначені для колекції, документ замінюється.
Якщо ідентифікатор відповідає існуючому документу, або всі унікальні ключі в документі заміни відповідають цьому документу або не конфліктують з іншими документами в колекції, документ замінюється.
Якщо ідентифікатор відповідає існуючому документу, а один або кілька унікальних ключів відповідають документу, який відрізняється від колекції, видається помилка.

id

Ідентифікатор фільтру. Якщо ідентифікатор або інше поле з унікальним індексом вже існує в колекції, він оновить відповідний документ.

За замовчуванням цей ідентифікатор автоматично генерується MySQL Server при додаванні запису і згадується як поле з ім'ям '_id'.

doc

Це документ для додавання або заміни, що є рядком JSON.

Об'єкт Result.

Приклад #1 Приклад використання mysql_xdevapi\Collection::addOrReplaceOne()****

Loading...