MongoDB\ClientBulkWrite::createWithCollection()

Definición

MongoDB\ClientBulkWrite::createWithCollection()

Cree una instancia del MongoDB\ClientBulkWrite constructor a partir de la instancia proporcionada de MongoDB\Collection. Puede agregar operaciones de escritura a la ClientBulkWrite para crear un nuevo BulkWriteCommand que la librería envía al servidor.

function createWithCollection(
    Collection $collection,
    array $options = []
): self

Parámetros

$collection : MongoDB\Collection

La instancia Collection que se establecerá como objetivo para operaciones de guardar masiva.

$options : arreglo

Un arreglo que especifica las opciones deseadas.

Nombre	Tipo	Descripción
bypassDocumentValidation	booleano	Si true: la operación de guardar ignora la validación a nivel de documento. El valor es por defecto false.
comment	mixto	Permite a los usuarios especificar un comentario arbitrario para ayudar a rastrear la operación a través del perfilador de bases de datos, la salida actualOp() y registros.
permitir	arreglo|objeto	Mapa de nombres de parámetros y valores. Los valores deben ser expresiones constantes o cerradas que no hagan referencia a los campos del documento. Posteriormente, se puede acceder a los parámetros como variables en el contexto de una expresión de agregación (por ejemplo, $$var). Esto no está soportado para versiones del servidor anteriores a la 5.0 y resultará en una excepción en el momento de la ejecución si se usa.
ordenado	booleano	Si true: Cuando una sola guardar falla, la operación se detiene sin realizar los guardados restantes y genera una excepción. If false: Cuando un solo guardado falla, la operación continúa con los guardados restantes, si los hay, y lanza una excepción. El valor es por defecto true.
verboseResults	booleano	Especifica si se deben devolver resultados detallados. El valor es por defecto false.

Return Values

Una nueva instancia ClientBulkWrite con una especificación BulkWriteCommand vacía.

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