MongoDB\Driver\Server::executeBulkWriteCommand

(mongodb >=2.1.0)

MongoDB\Driver\Server::executeBulkWriteCommand — Ejecuta operaciones de escritura en este servidor utilizando el comando bulkWrite

Descripción

final public MongoDB\Driver\Server::executeBulkWriteCommand(MongoDB\Driver\BulkWriteCommand $bulk, ?array $options = null): MongoDB\Driver\BulkWriteCommandResult

Ejecuta una o varias operaciones de escritura en el servidor primario utilizando el comando » bulkWrite introducido en MongoDB 8.0.

Una MongoDB\Driver\BulkWriteCommand puede ser construida con una o varias operaciones de escritura de tipos variados (por ejemplo, inserciones, actualizaciones y eliminaciones). Cada operación de escritura puede apuntar a una colección diferente.

El valor por omisión para la opción "writeConcern" será deducido de una transacción activa (indicada por la opción "session"), seguida de la URI de conexión.

Parámetros

bulk (MongoDB\Driver\BulkWriteCommand)

Escritura(s) a ejecutar.

options

options

Opción Tipo Descripción

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.

**options**
Opción	Tipo	Descripción
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.

Valores devueltos

Retorna un MongoDB\Driver\BulkWriteCommandResult en caso de éxito.

Errores/Excepciones

Lanza una MongoDB\Driver\Exception\InvalidArgumentException si bulk no contiene operaciones de escritura válidas.
Lanza una MongoDB\Driver\Exception\InvalidArgumentException si bulk ya ha sido ejecutada. Los objetos MongoDB\Driver\BulkWriteCommand no pueden ser ejecutados múltiples veces.
Lanza una excepción MongoDB\Driver\Exception\InvalidArgumentException si la opción "session" se utiliza junto con una preocupación de escritura no reconocida.
Lanza una excepción MongoDB\Driver\InvalidArgumentException en caso de error durante el análisis de un argumento.
Lanza una excepción MongoDB\Driver\ConnectionException si la conexión al servidor falla por una razón distinta a un problema de identificación
Lanza una excepción MongoDB\Driver\AuthenticationException si se requiere una identificación pero falla
Lanza una excepción MongoDB\Driver\Exception\BulkWriteCommandException en caso de error de escritura (por ejemplo, fallo de comando, error de escritura o preocupación de escritura)
Lanza MongoDB\Driver\Exception\RuntimeException en caso de otro error.

Ver también

MongoDB\Driver\BulkWriteCommand
MongoDB\Driver\BulkWriteCommandResult
MongoDB\Driver\WriteConcern
MongoDB\Driver\Manager::executeBulkWriteCommand() - Ejecuta operaciones de escritura utilizando el comando bulkWrite