MongoDB\ClientBulkWrite::withCollection()

Definición

MongoDB\ClientBulkWrite::withCollection()

Devolver una instancia actualizada de MongoDB\ClientBulkWrite de la instancia MongoDB\Collection proporcionada. Este método le permite agregar operaciones de guardar posteriores en una colección diferente de aquella con la que se creó el ClientBulkWrite.

Este método no compila un nuevo BulkWriteCommand y no edita la instancia ClientBulkWrite in situ.

function withCollection(
    Collection $collection,
): self

No puedes mezclar instancias de Collection asociadas con diferentes objetos de Manager al invocar este método en una instancia de ClientBulkWrite. Esto se debe a que la librería envía el BulkWriteCommand completado a un único servidor.

Parámetros

$collection : MongoDB\Collection

La instancia Collection para establecer como objetivo de las operaciones de guardado agregadas a la instancia ClientBulkWrite después de llamar a withCollection().

Return Values

Una nueva instancia ClientBulkWrite con la misma especificación BulkWriteCommand, pero con un espacio de nombres de destino actualizado.

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

Ver también

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