MongoDB\Cliente::bulkWrite()

Definición

MongoDB\Client::bulkWrite()

Ejecuta varias operaciones de guardado en varios espacios de nombres.

function bulkWrite(
    BulkWriteCommand|ClientBulkWrite $bulk,
    array $options = []
): MongoDB\BulkWriteCommandResult

Parámetros

$bulk : MongoDB\ClientBulkWrite or

BulkWriteCommand

Tip

Preferir la API ClientBulkWrite

Recomendamos utilizar la clase builder ClientBulkWrite y los métodos para especificar operaciones de escritura en un comando de escritura en bloque en lugar de utilizar la clase BulkWriteCommand. ClientBulkWrite proporciona una API fluida con métodos similares a los métodos CRUD de la clase MongoDB\Collection.

Representa el comando ensamblado de guardar masiva o el generador. MongoDB\Client::bulkWrite() admite operaciones de deleteMany(), deleteOne(), insertOne(), replaceOne(), updateMany() y updateOne().

$options : arreglo

Un arreglo que especifica las opciones deseadas.

Nombre	Tipo	Descripción
sesión	MongoDB\Driver\Session	Sesión de cliente para asociar con la operación.
writeConcern	MongoDB\Driver\WriteConcern	nivel de confirmación de escritura (write concern) a usar en la operación. Por defecto, se aplica el nivel de confirmación de escritura (write concern) de la colección. No es posible especificar un nivel de confirmación de escritura (write concern) para operaciones individuales como parte de una transacción. En su lugar, configura la opción writeConcern al iniciar la transacción.

Return Values

Un objeto MongoDB\BulkWriteCommandResult.

Errores/Excepciones

MongoDB\Exception\UnsupportedException si se usan opciones que no sean compatibles con el servidor seleccionado (p. ej. collation, readConcern, writeConcern).

MongoDB\Exception\InvalidArgumentException por errores relacionados con el análisis de parámetros u opciones.

MongoDB\Driver\Exception\RuntimeException para otros errores a nivel de extensión (por ejemplo, " errores de conexión).

MongoDB\Driver\Exception\BulkWriteCommandException para errores relacionados con la operación de escritura. Puede inspeccionar el valor devuelto por getWriteErrors() para determinar la naturaleza del error.

Comportamiento

Si se lanza un MongoDB\Driver\Exception\BulkWriteCommandException, puedes llamar a getWriteErrors() e inspeccionar la información en el arreglo devuelto para determinar la naturaleza del error.

Por ejemplo, una operación de escritura puede haberse aplicado correctamente en el servidor principal pero fallar al satisfacer el nivel de confirmación de escritura (write concern). Alternativamente, una operación de guardar puede haber fallado completamente, por ejemplo, por violar la restricción de clave única.

En el caso de una escritura por lotes, el resultado puede indicar múltiples operaciones de guardado exitosas y/o errores. Si la opción ordered está true, es posible que algunas operaciones hayan tenido éxito antes de que se encontrara el primer error y se lanzara la excepción. Si la opción ordered es false, es posible que se hayan encontrado múltiples errores.

Ver también

• Sección de escritura en lote de clientes de la guía de operaciones de escritura en lote

• Operaciones CRUD

• MongoDB\Collection::deleteMany()

• MongoDB\Collection::deleteOne()

• MongoDB\Collection::insertMany()

• MongoDB\Collection::insertOne()

• MongoDB\Collection::replaceOne()

• MongoDB\Collection::updateMany()

• MongoDB\Collection::updateOne()