(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 calificado (ej. "databaseName.collectionName"
)
bulk
(MongoDB\Driver\BulkWrite)Escritura(s) a ejecutar.
options
Option | Type | Description |
---|---|---|
session | MongoDB\Driver\Session |
Una sesión a asociar a la operación. |
writeConcern | MongoDB\Driver\WriteConcern |
Una preocupación de escritura a aplicar a la operación. |
Retorna 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 utiliza junto con una preocupación de escritura no reconocida.
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 llamante asegurarse de que el servidor sea capaz de ejecutar la operación de escritura. Por ejemplo, la ejecución de una operación de escritura en un secundario (excluyendo su base de datos "local") fallará.