MongoDB\Cliente::bulkWrite()

Definición

MongoDB\Client::bulkWrite()

Realizar múltiples operaciones de escritura en múltiples 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 o generador de escritura masiva ensamblado. MongoDB\Client::bulkWrite() admite deleteMany() deleteOne()insertOne()replaceOne()updateMany()operaciones,,,,updateOne() y.

$options : arreglo

Una matriz que especifica las opciones deseadas.

Nombre	Tipo	Descripción
sesión	MongoDB\Driver\Session	Sesión de cliente para asociar a 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 una preocupación de escritura para operaciones individuales como parte de una transacción. En su lugar, configure la writeConcern opción al iniciar la transacción.

Return Values

Un MongoDB\BulkWriteCommandResult objeto.

Errores/Excepciones

MongoDB\Exception\UnsupportedException si se utilizan opciones que no son compatibles con el servidor seleccionado (porcollation readConcernwriteConcernejemplo,,,).

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

MongoDB\Driver\Exception\RuntimeException para otros errores en el 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 una MongoDB\Driver\Exception\BulkWriteCommandException, puede llamar a getWriteErrors() e inspeccionar la información en la matriz devuelta para determinar la naturaleza del error.

Por ejemplo, es posible que una operación de escritura se haya aplicado correctamente al servidor principal, pero no haya solucionado el problema. Alternativamente, es posible que una operación de escritura haya fallado por completo, por ejemplo, por violar la restricción de clave única.

En el caso de una escritura masiva, el resultado podría indicar múltiples operaciones de escritura exitosas o errores. Si la opción ordered es true, es posible que algunas operaciones se hayan realizado correctamente 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()