MongoDB\ClientBulkWrite::conColección()

Definición

MongoDB\ClientBulkWrite::withCollection()

Devuelve una instancia actualizada de MongoDB\ClientBulkWrite de la instancia proporcionada. Este método permite agregar operaciones de escritura posteriores en una colección distinta a aquella con la MongoDB\Collection que ClientBulkWrite se creó.

Este método no crea un nuevo Comando de escritura masivay no edita la ClientBulkWrite instancia en su lugar.

function withCollection(
    Collection $collection,
): self

No se pueden combinar instancias Collection asociadas a diferentes objetos Manager al llamar a este método en una instancia ClientBulkWrite. Esto se debe a que la biblioteca envía el BulkWriteCommand completo a un solo servidor.

Parámetros

$collection : MongoDB\Collection

La instancia Collection que se establecerá como destino para las operaciones de escritura se agregará a la instancia ClientBulkWrite después de llamar a withCollection().

Return Values

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

Errores/Excepciones

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

MongoDB\Exception\InvalidArgumentException para 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).

Ver también

• Sección deescritura masiva del cliente de la guía de operaciones de escritura masiva