(mongodb >=1.0.0)
MongoDB\Driver\Server::executeBulkWrite — Ejecuta una o varias operaciones de escritura en este servidor
$namespace, MongoDB\Driver\BulkWrite $bulk, ?array $options = null): MongoDB\Driver\WriteResultEjecuta una o varias operaciones de escritura en este servidor.
Un objeto MongoDB\Driver\BulkWrite puede ser construido con una o varias operaciones de diferentes tipos (i.e. actualización, eliminación, e inserción). El driver intentará enviar las operaciones del mismo tipo al servidor en un mínimo de solicitudes posibles para optimizar los viajes de ida y vuelta.
El valor por omisión para la opción "writeConcern" será
deducido de una transacción activa (indicada por la opción
"session"), luego por el
URI de conexión.
namespace (string)
Un espacio de nombres completamente cualificado (p. ej. "nombreBaseDatos.nombreColección").
bulk (MongoDB\Driver\BulkWrite)La/s escritura/s a ejecutar.
options
| Option | Type | Description |
|---|---|---|
| session | MongoDB\Driver\Session |
Una sesión a asociar con la operación. |
| writeConcern | MongoDB\Driver\WriteConcern |
Un asunto de escritura a aplicar a la operación. |
Devuelve un MongoDB\Driver\WriteResult en caso de éxito.
bulk no contiene ninguna operación de escritura.bulk ya ha sido ejecutado. Los objetos MongoDB\Driver\BulkWrite no pueden ser ejecutados varias veces."session" se usa junto a un asunto de escritura no reconocido.
| Versión | Descripción |
|---|---|
| PECL mongodb 2.0.0 |
El parámetro options ya no acepta
instancias MongoDB\Driver\WriteConcern.
|
| PECL mongodb 1.21.0 |
Pasar un objeto MongoDB\Driver\WriteConcern como
options está obsoleto y será eliminado en la 2.0.
|
| PECL mongodb 1.4.4 |
MongoDB\Driver\Exception\InvalidArgumentException
será lanzado si la opción "session" es utilizada
conjuntamente con una preocupación de escritura no reconocida.
|
| PECL mongodb 1.4.0 |
El tercer parámetro es ahora un array
de options. Para la compatibilidad ascendente,
este parámetro siempre aceptará un objeto MongoDB\Driver\WriteConcern.
|
| PECL mongodb 1.3.0 |
MongoDBDriverExceptionInvalidArgumentException es
ahora lanzado si Bulk no contiene
operaciones de escritura. Anteriormente, una
MongoDB\Driver\Exception\BulkWriteException era lanzada.
|
Nota: Es responsabilidad del llamador asegurarse de que el servidor es capaz de ejecutar la operación de escritura. Por ejemplo, ejecutar un operación de escritura en un secundario (excluyendo su base de datos "local"), fallará.