MongoDB\Driver\Server::executeWriteCommand
(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — Execute a database command that writes on this server
Descrierea
$db
, MongoDB\Driver\Command $command
, array $options = array()
) : MongoDB\Driver\CursorExecutes the command on this server.
This method will apply logic that is specific to commands that write (e.g.
» drop) and
take the MongoDB server version into account. The
"writeConcern" option will default to the corresponding
value from the MongoDB
Connection URI.
Notă: This method is not intended to be used to execute » insert, » update, or » delete commands. Users are encouraged to use MongoDB\Driver\Server::executeBulkWrite() for those commands.
Parametri
-
db(string) -
Denumirea bazei de date asupra căreia va fi executată comanda.
-
command(MongoDB\Driver\Command) -
Comanda spre a fi executată.
-
options -
options Option Type Description session MongoDB\Driver\Session O sesiune pentru a fi asociată cu operațiunea.
writeConcern MongoDB\Driver\WriteConcern O preocupare de înscriere pentru a fi aplicată operațiunii.
AvertizareDacă utilizați un
"session"care are o tranzacție în desfășurare, nu puteți specifica opțiunile"readConcern"sau"writeConcern". Aceasta va rezulta în emiterea unei excepții MongoDB\Driver\Exception\InvalidArgumentException. În loc, trebuie să stabiliți aceste două opțiuni când creați tranzacția cu MongoDB\Driver\Session::startTransaction().
Valorile întoarse
Întoarce MongoDB\Driver\Cursor în caz de succes.
Erori/Excepții
-
Emite MongoDB\Driver\Exception\InvalidArgumentException
dacă opțiunea
"session"este utilizată cu o tranzacție asociată, în combinație cu o opțiune"readConcern"sau"writeConcern". -
Emite MongoDB\Driver\Exception\InvalidArgumentException
dacă opțiunea
"session"este utilizată în combinație cu o preocupare de înscriere neconfirmată. - 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 command).
Istoricul schimbărilor
| Versiune | Descriere |
|---|---|
| PECL mongodb 1.4.4 |
MongoDB\Driver\Exception\InvalidArgumentException
will be thrown if the "session" option is used in
combination with an unacknowledged write concern.
|
Note
Notă: Este resposabilitatea apelantului să se asigure că serverul e capabil să efectueze operațiunea de înscriere. Spre exemplu, executarea unei operațiuni de înscriere pe un secundar (în afară de baza sa de date "locală") va eșua.
A se vedea și
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Server::executeCommand() - Execute a database command on this server
- MongoDB\Driver\Server::executeReadCommand() - Execute a database command that reads on this server
- MongoDB\Driver\Server::executeReadWriteCommand() - Execute a database command that reads and writes on this server
- MongoDB\Driver\Manager::executeWriteCommand() - Execute a database command that writes
add a note
