Collection::add

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

Collection::add — Додає документ до колекції

Опис

public mysql_xdevapi\Collection::add(mixed $document): mysql_xdevapi\CollectionAdd

Запускає додавання цього документа (документів) до колекції, підтримуються кілька варіантів методу. Можливі варіанти:

1. Додавання одного документа у вигляді рядка JSON.

2. Додавання одного документа у вигляді масиву, наприклад:[ 'field' => 'value', 'field2' => 'value2' ... ]

3. В ту саму операцію можна додати, як документ, так і кілька документів.

Список параметрів

document

Один або кілька документів може бути або JSON, або масив полів з відповідними значеннями. Масив не може бути порожнім.

Сервер MySQL автоматично генерує унікальні значення _id для кожного документа (рекомендується), хоча його також можна додати вручну. Це значення має бути унікальним, інакше операцію додавання не буде виконано.

Значення, що повертаються

Об'єкт CollectionAdd. Використовуйте execute() для повернення Result, який можна використовувати для запиту кількості порушених елементів, кількості попереджень, згенерованих операцією, або для отримання списку згенерованих ідентифікаторів для доданих документів.

Приклади

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

Loading...
▶

Висновок наведеного прикладу буде схожим на:

Array
(
    [0] => 00005b6b53610000000000000056
    [1] => 00005b6b53610000000000000057
)

Примітки

Зауваження :

MySQL Server 8.0 або вище генерує унікальний _id, як показано у прикладі. Поле _id слід визначити вручну, якщо використовується MySQL Server 5.7.