MongoDB\ClientBulkWrite::createWithCollection()

Definición

MongoDB\ClientBulkWrite::createWithCollection()

Cree una instancia del MongoDB\ClientBulkWrite constructor a partir de la instancia provista de MongoDB\Collection. Puedes añadir operaciones de guardar al 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 destino para operaciones de escritura masiva.

$options : arreglo

Una matriz 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 generador de perfiles de base de datos, la salidacurrentOp y los 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 es compatible con versiones de servidor anteriores a 5.0 y, si se utiliza, generará una excepción en el momento de ejecución.
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 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).

Ver también

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