(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadWriteCommand — Выполняет команду базы данных, которая читает и пишет на сервере
$db
, MongoDB\Driver\Command $command
, ?array $options
= null
): MongoDB\Driver\CursorМетод выполняет команду на сервере.
Этот метод будет применять логику, специфичную для команд, которые читают и пишут
(например » aggregate).
Значения по умолчанию для параметров readConcern
writeConcern
метод получит из активной
транзакции (указывает параметр session
), за которой следует
URI-идентификатор соединения.
db
(string)Название базы данных, в которой запускается команда.
command
(MongoDB\Driver\Command)Команда для выполнения.
options
Опция | Тип | Описание |
---|---|---|
readConcern | MongoDB\Driver\ReadConcern |
Гарантия чтения для применения к операции. Эта опция доступна в MongoDB 3.2+ и приведёт к исключению во время выполнения, если указана для более старой версии сервера. |
session | MongoDB\Driver\Session |
Сессия для связывания с операцией. |
writeConcern | MongoDB\Driver\WriteConcern |
Гарантия записи для применения к операции. |
С парметром "session"
и при незавершённых
транзакциях нельзя указать параметр "readConcern"
или "writeConcern"
. Это выбросит
исключение MongoDB\Driver\Exception\InvalidArgumentException.
Вместо этого две этих опции устанавливают методом
MongoDB\Driver\Session::startTransaction(), когда создают транзакцию.
Метод возвращает курсор MongoDB\Driver\Cursor, если выполнился успешно.
"session"
указана с соответствующей транзакцией в сочетании с опцией "readConcern"
или "writeConcern"
."session"
указана в сочетании с неподтверждённой гарантией записи.
Версия | Описание |
---|---|
PECL mongodb 1.4.4 |
Метод выбрасывает исключение MongoDB\Driver\Exception\InvalidArgumentException,
если опция session используется
в сочетании с неподтверждённой записью.
|
Замечание: Ответственность вызывающего кода заключается в том, что сервер в состоянии выполнять операцию записи. Например, выполнение операции записи на вторичном узле (исключая «локальную» базу данных) завершится неудачей.