PHP 8.5.0 Alpha 2 available for testing

MongoDB\Driver\Server::executeBulkWrite

(mongodb >=1.0.0)

MongoDB\Driver\Server::executeBulkWriteEjecuta una o varias operaciones de escritura en este servidor

Descripción

final public MongoDB\Driver\Server::executeBulkWrite(string $namespace, MongoDB\Driver\BulkWrite $bulk, ?array $options = null): MongoDB\Driver\WriteResult

Ejecuta 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.

Parámetros

namespace (string)

Un espacio de nombres completamente calificado (ej. "databaseName.collectionName")

bulk (MongoDB\Driver\BulkWrite)

Escritura(s) a ejecutar.

options

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.

Valores devueltos

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

Errores/Excepciones

Historial de cambios

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.

Notas

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á.

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top