(mongodb >=1.0.0)
MongoDB\Driver\Manager::executeQuery — Execute a database query
$namespace, MongoDB\Driver\Query $query, ?array $options = null): MongoDB\Driver\Cursor
Selects a server according to the "readPreference" option
and executes the query on that server.
Default values for the "readPreference" option and Query's
"readConcern" option will be inferred from an active
transaction (indicated by the "session" option), followed
by the connection URI.
namespace (string)
A fully qualified namespace (e.g. "databaseName.collectionName").
query (MongoDB\Driver\Query)Die auszuführende Abfrage.
options
| Option | Type | Description |
|---|---|---|
| readPreference | MongoDB\Driver\ReadPreference |
Eine Lesepräferenz, die verwendet wird, um einen Server für die Operation auszuwählen. |
| session | MongoDB\Driver\Session |
Eine Session, die mit dem Vorgang verknüpft werden soll. |
Gibt bei Erfolg einen MongoDB\Driver\Cursor zurück.
| Version | Beschreibung |
|---|---|
| PECL mongodb 2.0.0 |
The options parameter no longer accepts a
MongoDB\Driver\ReadPreference instance.
|
| PECL mongodb 1.21.0 |
Passing a MongoDB\Driver\ReadPreference object as
options is deprecated and will be removed in 2.0.
|
| PECL mongodb 1.4.0 |
The third parameter is now an options array.
For backwards compatibility, this paramater will still accept a
MongoDB\Driver\ReadPreference object.
|
Beispiel #1 MongoDB\Driver\Manager::executeQuery() example
<?php
$manager = new MongoDB\Driver\Manager("mongodb://localhost:27017");
$bulk = new MongoDB\Driver\BulkWrite;
$bulk->insert(['x' => 1]);
$bulk->insert(['x' => 2]);
$bulk->insert(['x' => 3]);
$manager->executeBulkWrite('db.collection', $bulk);
$filter = ['x' => ['$gt' => 1]];
$options = [
'projection' => ['_id' => 0],
'sort' => ['x' => -1],
];
$query = new MongoDB\Driver\Query($filter, $options);
$cursor = $manager->executeQuery('db.collection', $query);
foreach ($cursor as $document) {
var_dump($document);
}
?>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
object(stdClass)#6 (1) {
["x"]=>
int(3)
}
object(stdClass)#7 (1) {
["x"]=>
int(2)
}
Beispiel #2 Limiting execution time for a query
The "maxTimeMS"
MongoDB\Driver\Query option may be used to limit the
execution time of a query. Note that this time limit is enforced on the
server side and does not take network latency into account. See
» Terminate Running Operations
in the MongoDB manual for more information.
<?php
$manager = new MongoDB\Driver\Manager('mongodb://localhost:27017');
$filter = ['x' => ['$gt' => 1]];
$options = [
'maxTimeMS' => 1000,
];
$query = new MongoDB\Driver\Query($filter, $options);
$cursor = $manager->executeQuery('db.collection', $query);
foreach ($cursor as $document) {
var_dump($document);
}
?>If the query fails to complete after one second of execution time on the server, a MongoDB\Driver\Exception\ExecutionTimeoutException will be thrown.