MongoDB\Driver\Manager::executeReadCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeReadCommandВыполняет команду базы данных, которая читает

Описание

finalpublicMongoDB\Driver\Manager::executeReadCommand(string$db, MongoDB\Driver\Command$command, ?array$options = null): MongoDB\Driver\Cursor

Выбирает сервер в соответствии с опцией "readPreference" и выполняет команду на сервере. По умолчанию будет использоваться предпочтение чтения из URI подключения MongoDB.

Этот метод будет применять логику, специфичную для команд, которые читают (например, » count) и учитывают версию сервера MongoDB. Опция "readConcern" будет по умолчанию соответствовать соответствующему значению из URI подключения MongoDB.

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

db (string)

Имя базы данных, в которой запускается команда.

command (MongoDB\Driver\Command)

Команда для выполнения.

options

options
ОпцияТипОписание
readConcernMongoDB\Driver\ReadConcern

Гарантия чтения для применения к операции.

Эта опция доступна в MongoDB 3.2+ и приведёт к исключению во время выполнения, если указана для более старой версии сервера.

readPreferenceMongoDB\Driver\ReadPreference

Предпочтение чтения, используемая для выбора сервера для выполнения операции.

sessionMongoDB\Driver\Session

Сессия для связывания с операцией.

Внимание

При использовании "session" и наличии незавершённых транзакций, вы не можете указать "readConcern" or "writeConcern" option. Это приведёт к выбрасыванию исключения MongoDB\Driver\Exception\InvalidArgumentException. Вместо этого вы должны установить эти две опции при создании транзакции с помощью MongoDB\Driver\Session::startTransaction().

Возвращаемые значения

В случае успешного выполнения возвращает MongoDB\Driver\Cursor.

Ошибки

Смотрите также

To Top