Exécute une commande de base de données qui lit

# MongoDB\Driver\Manager::executeReadCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeReadCommand — Exécute une commande de base de données qui lit

### Description

final public function MongoDB\Driver\Manager::executeReadCommand(string `$db`, MongoDB\Driver\Command `$command`, ?array `$options` = `null`): MongoDB\Driver\Cursor

Sélectionne un serveur en fonction de l'option `"readPreference"` et exécute la commande sur ce serveur.

Cette méthode appliquera une logique spécifique aux commandes qui lisent (par exemple » distinct). Les valeurs par défaut des options `"readPreference"` et `"readConcern"` seront déduites à partir d'une transaction active (indiquée par l'option `"session"`), suivie de l' URI de connexion.

### Liste de paramètres

`db` (string)
  Le nom de la base de données sur laquelle la commande sera exécutée.
`command` (MongoDB\Driver\Command)
  La commande à exécuter.
`options`

  options
  Option | Type | Description
  --- | --- | ---
  readConcern | MongoDB\Driver\ReadConcern | Une préoccupation de lecture à appliquer à l'opération. Cette option est disponible dans MongoDB 3.2+ et se traduira par une exception au moment de l'exécution si elle est spécifiée pour une version plus ancienne du serveur.
  readPreference | MongoDB\Driver\ReadPreference | Une préférence de lecture à utiliser pour sélectionner un serveur pour l'opération.
  session | MongoDB\Driver\Session | Une session à associer à l'opération.

  Avertissement

  Si vous utilisez une `"session"` qui a une transaction en cours, vous ne pouvez pas spécifier l'option `"readConcern"` ou `"writeConcern"`. Tenter de faire ceci lancera une exception MongoDB\Driver\Exception\InvalidArgumentException. À la place vous devriez définir ces options quand vous créez la transaction avec MongoDB\Driver\Session::startTransaction().

### Valeurs de retour

Retourne un MongoDB\Driver\Cursor en cas de succès.

### Erreurs / Exceptions

- Throws MongoDB\Driver\Exception\InvalidArgumentException if the `"session"` option is used with an associated transaction in combination with a `"readConcern"` or `"writeConcern"` option.
- 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 MongoDB\Driver\Exception\RuntimeException sur d'autres erreurs (par exemple: commande invalide).

### Voir aussi

- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Manager::executeCommand() - Exécute une commande de base de données
- MongoDB\Driver\Manager::executeReadWriteCommand() - Exécute une commande de base de données qui lit et écrit
- MongoDB\Driver\Manager::executeWriteCommand() - Exécute une commande de base de données qui écrit
- MongoDB\Driver\Server::executeReadCommand() - Exécute une commande de base de données qui lit sur ce serveur

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open