MongoDB\Driver\Manager::executeWriteCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeWriteCommand — ExĂ©cute une commande de base de donnĂ©es qui Ă©crit

Description

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

Exécute la commande sur le serveur primaire.

Cette méthode appliquera une logique spécifique aux commandes qui écrivent (par exemple » drop). Les valeurs par défaut de l'option "writeConcern" seront déduites à partir d'une transaction active (indiquée par l'option "session"), suivie de l'URI de connexion.

Note: Cette mĂ©thode n'est pas destinĂ©e Ă  ĂȘtre utilisĂ©e pour exĂ©cuter » insert, » update, ou » delete. Il est recommandĂ© aux utilisateurs d'utiliser MongoDB\Driver\Manager::executeBulkWrite() pour ces opĂ©rations.

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
session MongoDB\Driver\Session Une session à associer à l'opération.
writeConcern MongoDB\Driver\WriteConcern Une préoccupation d'écriture à appliquer à 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

  • Lance une exception MongoDB\Driver\Exception\InvalidArgumentException si l'option "session" est utilisĂ©e avec une transaction associĂ©e en combinaison avec une option "readConcern" ou "writeConcern".
  • Lance une exception MongoDB\Driver\Exception\InvalidArgumentException si l'option "session" est utilisĂ©e conjointement avec une prĂ©occupation d'Ă©criture non reconnu.
  • 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).

Historique

Version Description
PECL mongodb 1.4.4 Une MongoDB\Driver\Exception\InvalidArgumentException sera lancée si l'option "session" est utilisée en combinaison avec un "writeConcern" non reconnu.

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.