Execute a database query on this server

Descrierea

final public MongoDB\Driver\Server::executeQuery ( string $namespace , MongoDB\Driver\Query $query [, array $options = array() ] ) : MongoDB\Driver\Cursor

Executes the query on this server.

Notă: The "readPreference" option does not control the server to which the driver issues the operation; it will always be executed on this server object. Instead, it may be used when issuing the operation to a secondary (from a replica set connection, not standalone) or mongos node to ensure that the driver sets the wire protocol accordingly or adds the read preference to the operation, respectively.

Parametri

namespace (string)

Un spațiu de nume complet calificat (de ex. "databaseName.collectionName").

query (MongoDB\Driver\Query)

MongoDB\Driver\Query spre a fi executată.

options

**options**
Option	Type	Description
readPreference	MongoDB\Driver\ReadPreference	A read preference to use for selecting a server for the operation.
session	MongoDB\Driver\Session	A session to associate with the operation.

Valorile întoarse

Întoarce MongoDB\Driver\Cursor în caz de succes.

Erori/Excepții

Emite MongoDB\Driver\Exception\InvalidArgumentException în cazul erorilor la interpretarea argumentelor.
Emite MongoDB\Driver\Exception\ConnectionException dacă conexiunea către server eșuează (din alte motive decât autentificarea).
Emite MongoDB\Driver\Exception\AuthenticationException dacă este necesară autentificare și aceasta eșuează.
Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid query operators).

Istoricul schimbărilor

Versiune	Descriere
1.4.0	The third parameter is now an `options` array. For backwards compatibility, this paramater will still accept a MongoDB\Driver\ReadPreference object.

A se vedea și

MongoDB\Driver\Cursor
MongoDB\Driver\Query
MongoDB\Driver\ReadPreference
MongoDB\Driver\Manager::executeQuery() - Execute a database query