MongoDB\Driver\Server::executeQuery
(mongodb >=1.0.0)
MongoDB\Driver\Server::executeQuery — Виконує запит до бази даних на сервері
Опис
final public MongoDB\Driver\Server::executeQuery(string $namespace, MongoDB\Driver\Query $query, array|MongoDB\Driver\ReadPreference|null $options = null): MongoDB\Driver\Cursor
Виконує запит на сервері.
Зауваження: Опция
"readPreference"не керує сервером, якому драйвер виконує операцію; він завжди виконуватиметься на цьому об'єкті сервера. Натомість його можна використовувати при видачі операції на вторинному сервері (зі з'єднання з реплікою, а не автономному) або вузол mongos, щоб гарантувати, що драйвер відповідно встановлює дротовий протокол або додає переваги читання до операції відповідно.
Список параметрів
namespace(string)
Повністю певне ім'я (тобто . "databaseName.collectionName"
query MongoDB\Driver\Query) .
Запит на виконання.
options
options
| Опция | Тип | Опис |
|---|---|---|
| readPreference | MongoDB\Driver\ReadPreference | |
| Перевага читання, що використовується для вибору сервера для виконання операції. |
| | session |MongoDB\Driver\Session
Сесія зв'язування з операцією.
Значення, що повертаються
У разі успішного виконання повертає MongoDB\Driver\Cursor
Помилки
- При помилці парсингу аргумент кидає винятокMongoDB\Driver\Exception\InvalidArgumentException
- При невдалому з'єднанні з сервером (крім помилок аутентифікації) кидає винятокMongoDB\Driver\Exception\ConnectionException
- У разі невдалої аутентифікації кидає винятокMongoDB\Driver\Exception\AuthenticationException
- Видає винятокMongoDB\Driver\Exception\RuntimeExceptionінші помилки (наприклад, неприпустимі оператори запитів).
список змін
| Версия | Опис |
|---|---|
| PECL mongodb 1.4.0 | Третій параметр тепер є масивом options. . Для зворотної сумісності цей параметр, як і раніше, прийматиме об'єкт MongoDB\Driver\ReadPreference |
Дивіться також
- MongoDB\Driver\Cursor
- MongoDB\Driver\Query
- MongoDB\Driver\ReadPreference
- MongoDB\Driver\Manager::executeQuery() - Виконує запит до бази даних