MongoDB\Driver\BulkWrite::insert

(mongodb >=1.0.0)

MongoDB\Driver\BulkWrite::insert — Додати операцію вставки в порцію

Опис

public MongoDB\Driver\BulkWrite::insert(array|object $document): mixed

Добавляем операцию вставки вMongoDB\Driver\BulkWrite

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

document(array|object)

Документ для вставлення.

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

Повертає _idдобавленного документа. Если вdocument не було задано _id, буде повернутий MongoDB\BSON\ObjectIdзгенерований для вставки.

Помилки

• При помилці парсингу аргумент кидає винятокMongoDB\Driver\Exception\InvalidArgumentException

список змін

Версия	Опис
PECL mongodb 1.3.0	Завжди повертається _id для доданого документа. Раніше метод повертав значення тільки якщо MongoDB\BSON\ObjectId був створений.

Приклади

Приклад #1 Приклад використання MongoDB\Driver\BulkWrite::insert()****

Loading...
▶

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

object(MongoDB\BSON\ObjectId)#3 (1) {
  ["oid"]=>
  string(24) "54d51146bd21b91405401d92"
}
NULL
NULL

Дивіться також

• MongoDB\Driver\Manager::executeBulkWrite() - Виконує одну або кілька операцій запису
• MongoDB\Driver\WriteResult
• MongoDB\BSON\ObjectId
• MongoDB\BSON\Persistable