MongoDB\Driver\Server::executeReadCommand

(mongodb >=1.4.0)

MongoDB\Driver\Server::executeReadCommand — ExĂ©cute une commande de base de donnĂ©es qui lit sur ce serveur

Description

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

Exécute la commande sur ce serveur, indépendamment de l'option "readPreference".

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

Note: L'option readPreference ne contrĂŽle pas le serveur vers lequel le pilote Ă©met l'opĂ©ration; il sera toujours exĂ©cutĂ© sur cet objet serveur. Au lieu de cela, il peut ĂȘtre utilisĂ© lors de l'Ă©mission de l'opĂ©ration Ă  un secondaire (Ă  partir d'une connexion de jeu de rĂ©pliques, pas autonome) ou le nƓud Mongos pour s'assurer que le pilote dĂ©finit le protocole de fil en consĂ©quence ou ajoute la prĂ©fĂ©rence de lecture Ă  l'opĂ©ration, respectivement.

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

Found A Problem?

Learn How To Improve This Page ‱ Submit a Pull Request ‱ Report a Bug
add a note

User Contributed Notes

There are no user contributed notes for this page.