MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeWriteCommand — Виконує команду бази даних, яка пише

Опис

final public MongoDB\Driver\Manager::executeWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

Виконує команду на основному сервері.

Цей метод застосовуватиме логіку, специфічну для команд, які пишуть (наприклад, » drop) та враховують версію сервера MongoDB. Опція "writeConcern" за умовчанням відповідатиме значенню з URI підключення MongoDB

Зауваження: Метод не призначений для виконання » insert » update, или» delete команд. Користувачам рекомендується використовувати MongoDB\Driver\Manager::executeBulkWrite() для цих команд.

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

db(string)

Ім'я бази даних, у якій запускається команда.

command MongoDB\Driver\Command) .

Команда для виконання.

options

options

Опция	Тип	Опис
session	MongoDB\Driver\Session
Сесія зв'язування з операцією.

| | writeConcern |MongoDB\Driver\WriteConcern

Гарантія запису для застосування до операції.

Увага

При использовании"session" та наявності незавершених транзакцій, ви не можете вказати "readConcern"or"writeConcern" option. Це призведе до викидання винятків MongoDB\Driver\Exception\InvalidArgumentException. Натомість ви повинні встановити ці дві опції при створенні транзакції за допомогою MongoDB\Driver\Session::startTransaction()

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

У разі успішного виконання повертає MongoDB\Driver\Cursor

Помилки

• Викидається виняток MongoDB\Driver\Exception\InvalidArgumentExceptionякщо опція "session"вказано з відповідною транзакцією у поєднанні з опцією"readConcern"или"writeConcern"
• Викидається MongoDB\Driver\Exception\InvalidArgumentExceptionякщо опція "session"вказано у поєднанні з непідтвердженою гарантією запису.
• При помилці парсингу аргумент кидає винятокMongoDB\Driver\Exception\InvalidArgumentException
• При невдалому з'єднанні з сервером (крім помилок аутентифікації) кидає винятокMongoDB\Driver\Exception\ConnectionException
• У разі невдалої аутентифікації кидає винятокMongoDB\Driver\Exception\AuthenticationException
• Викидає виняток MongoDB\Driver\Exception\RuntimeExceptionінших помилок (наприклад, неправильна команда).

список змін

Версия	Опис
PECL mongodb 1.4.4	Буде викинуто MongoDB\Driver\Exception\InvalidArgumentExceptionякщо опція "session" використовується у поєднанні з непідтвердженим записом.

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

• MongoDB\Driver\Command
• MongoDB\Driver\Cursor
• MongoDB\Driver\Manager::executeCommand() - Виконує команду бази даних
• MongoDB\Driver\Manager::executeReadCommand() - Виконує команду бази даних, яка читає
• MongoDB\Driver\Manager::executeReadWriteCommand() - Виконує команду бази даних, яка читає та пише
• MongoDB\Driver\Server::executeWriteCommand() - Виконує команду бази даних, що пише на сервері