(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadCommand — Execute a database command that reads on this server
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
Executes the command on this server, irrespective of the
"readPreference" option.
This method will apply logic that is specific to commands that read (e.g.
» distinct).
Default values for the "readPreference" and
"readConcern" options will be inferred from an active
transaction (indicated by the "session" option), followed
by the connection URI.
Зауваження: Параметр
"readPreference"впливає не на сервер, котрому драйвер дає команду, а тільки на об'єкт сервера. Натомість, під час надсилання драйвером команди, цей параметр може забезпечувати відповідний мережевий протокол для другорядного вузла з набору реплік, а також встановлювати вимоги щодо читання для mongo-вузла.
db (string)Назва бази даних, в якій буде виконано команду.
command (MongoDB\Driver\Command)Команда, яку потрібно виконати.
options
| Option | Type | Description |
|---|---|---|
| readConcern | MongoDB\Driver\ReadConcern |
Вимога щодо зчитування. Цей параметр доступний в MongoDB 3.2+, тож його застосування у старіших версіях викине виключення під час виконання. |
| readPreference | MongoDB\Driver\ReadPreference |
Параметр читання для вибору сервера для операції. |
| session | MongoDB\Driver\Session |
Сеанс, по'язаний з операцією. |
Для сеансу ("session") транзакції, яка триває, не
можна задати параметр "readConcern" або
"writeConcern". Це призведе до викидання виключення
MongoDB\Driver\Exception\InvalidArgumentException.
Ці два параметри потрібно задавати під час створення транзакції методом
MongoDB\Driver\Session::startTransaction().
У разі успіху повертає примірника MongoDB\Driver\Cursor.
"session" використано разом з параметром
"readConcern" або "writeConcern",
викидається
MongoDB\Driver\Exception\InvalidArgumentException.