MongoDB\Driver\Manager::executeQuery
(mongodb >=1.0.0)
MongoDB\Driver\Manager::executeQuery — Виконує запит до бази даних
Опис
final public MongoDB\Driver\Manager::executeQuery(string $namespace, MongoDB\Driver\Query $query, array|MongoDB\Driver\ReadPreference|null $options = null): MongoDB\Driver\Cursor
Вибирає сервер відповідно до опції "readPreference" та виконує запит на цьому сервері. За промовчанням буде використовуватися перевага читання з URI URI підключення MongoDB
Список параметрів
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 |
Приклади
Приклад #1 Приклад використання MongoDB\Driver\Manager::executeQuery()****
Результат виконання наведеного прикладу:
object(stdClass)#6 (1) {
["x"]=>
int(3)
}
object(stdClass)#7 (1) {
["x"]=>
int(2)
}
Приклад #2 Обмеження часу виконання запиту
Опция"maxTimeMS"классаMongoDB\Driver\Query може використовуватись для обмеження часу виконання запиту. Зауважте, що цей термін застосовується на стороні сервера і не враховує затримки мережі. Дивіться » Завершення виконання операцій у посібнику MongoDB для отримання додаткової інформації.
Якщо запит не завершиться через секунду після початку виконання на сервері, буде викинуто виняток MongoDB\Driver\Exception\ExecutionTimeoutException
Дивіться також
- MongoDB\Driver\Cursor
- MongoDB\Driver\Query
- MongoDB\Driver\ReadPreference
- MongoDB\Driver\Server::executeQuery() - Виконує запит до бази даних на сервері