MongoDB\Driver\Server::executeBulkWrite
(mongodb >=1.0.0)
MongoDB\Driver\Server::executeBulkWrite — Execute one or more write operations on this server
Descrierea
$namespace
, MongoDB\Driver\BulkWrite $bulk
[, array $options = array()
] ) : MongoDB\Driver\WriteResultExecutes one or more write operations on this server.
A MongoDB\Driver\BulkWrite can be constructed with one or more write operations of varying types (e.g. updates, deletes, and inserts). The driver will attempt to send operations of the same type to the server in as few requests as possible to optimize round trips.
Parametri
-
namespace(string) -
Un spațiu de nume complet calificat (de ex.
"databaseName.collectionName"). -
bulk(MongoDB\Driver\BulkWrite) -
Înscrierea sau înscrierile spre a fi executate.
-
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.
Valorile întoarse
Întoarce MongoDB\Driver\WriteResult în caz de succes.
Erori/Excepții
- Throws MongoDB\Driver\Exception\InvalidArgumentException if
bulkdoes not contain any write operations. - Throws MongoDB\Driver\Exception\InvalidArgumentException if
bulkhas already been executed. MongoDB\Driver\BulkWrite objects may not be executed multiple times. -
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ă.
- Emite MongoDB\Driver\Exception\BulkWriteException la orice eșec de înscriere (de ex. eroare de înscriere, eșec la aplicarea unui "write concern")
- Throws MongoDB\Driver\Exception\RuntimeException on other errors.
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.
|
| PECL mongodb 1.4.0 |
The third parameter is now an options array.
For backwards compatibility, this paramater will still accept a
MongoDB\Driver\WriteConcern object.
|
| PECL mongodb 1.3.0 |
MongoDB\Driver\Exception\InvalidArgumentException
is now thrown if bulk does not contain any write
operations. Previously, a
MongoDB\Driver\Exception\BulkWriteException was
thrown.
|
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\BulkWrite
- MongoDB\Driver\WriteResult
- MongoDB\Driver\WriteConcern
- MongoDB\Driver\Manager::executeBulkWrite() - Execute one or more write operations
add a note
