MongoDB\Driver\Server::executeQuery

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeQuery — Exécute une requête de base de données sur ce serveur

Description

final public MongoDB\Driver\Cursor MongoDB\Driver\Server::executeQuery ( string $namespace , MongoDB\Driver\Query $query [, MongoDB\Driver\ReadPreference $readPreference ] )

Exécute la requête query sur ce serveur.

Note:
Le paramètre readPreference ne contrôle pas le serveur sur lequel le driver va envoyer la requête ; la requête sera toujours exécutée sur l'objet serveur. A la place, il peut être utilisé lors de l'envoi de la commande sur un secondaire (depuis un jeu de connexion de réplication, et non en serveur unique), ou un noeud mongo pour s'assurer que le driver définisse le protocole wire adéquat ou ajoute les préférences en lecture au document de requête, respectivement.

Liste de paramètres

namespace: Un espace de noms totalement qualifié (databaseName.collectionName)
query (MongoDB\Driver\Query): The MongoDB\Driver\Query to execute.
readPreference: Optionnellement, une MongoDB\Driver\ReadPreference vers laquelle la commande sera routée. Si rien n'est fourni, ce sera les préférences de lecture définies par l' URI de connexion MongoDB.

Valeurs de retour

Returns MongoDB\Driver\Cursor on success.

Erreurs / Exceptions

Lance une exception MongoDB\Driver\AuthenticationException si une identification est nécessaire mais qu'elle échoue
Lance une exception MongoDB\Driver\ConnectionException si la connexion au serveur échoue pour une autre raison qu'en raison d'un problème d'identification
Lance une exception MongoDB\Driver\Exception\RuntimeException si une erreur survient (i.e. opérateurs de requête invalide).

Voir aussi

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