MongoDB\Driver\Server::executeReadWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadWriteCommand — Выполняет команду базы данных, которая читает и пишет на сервере
Описание
$db
, MongoDB\Driver\Command $command
, array $options = array()
) : MongoDB\Driver\CursorВыполняет команду на сервере.
Этот метод будет применять логику, специфичную для команд, которые читают и пишут
(например, » aggregate)
и учитывают версию сервера MongoDB. Параметры "readConcern" и "writeConcern"
по умолчанию соответствуют соответствующим значениям из
URI подключения MongoDB.
Список параметров
-
db(string) -
Имя базы данных, в которой запускается комманда.
-
command(MongoDB\Driver\Command) -
Команда для выполнения.
-
options -
options Опция Тип Описание readConcern MongoDB\Driver\ReadConcern Гаранатия чтения для применения к операции.
Эта опция доступна в MongoDB 3.2+ и приведет к исключению во время выполнения, если указана для более старой версии сервера.
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\Server::executeCommand() - Выполнить команду базы данных на сервере
- MongoDB\Driver\Server::executeReadCommand() - Выполняет команду базы данных, которая читает на сервере
- MongoDB\Driver\Server::executeWriteCommand() - Выполняет команду базы данных, которая пишет на сервере
- MongoDB\Driver\Manager::executeReadWriteCommand() - Выполняет команду базы данных, которая читает и пишет