MongoDB\ClientBulkWrite::insertOne()

Definición

MongoDB\ClientBulkWrite::insertOne()

Especifica una operación de inserción en el comando de escritura masiva. Este método devuelve la instancia MongoDB\ClientBulkWrite sobre la que se invoca.

function insertOne(
    array|object $document,
    mixed &$id = null
): self

Parámetros

$document : arreglo|objeto

El documento para insertar en la colección.

$id s: mezclado

Captura el valor del campo _id del documento para almacenarlo en una variable de salida opcional.

Errores/Excepciones

MongoDB\Exception\InvalidArgumentException por errores relacionados con el análisis de parámetros u opciones.

MongoDB\Driver\Exception\BulkWriteCommandException para errores relacionados con la operación de escritura. Puede inspeccionar el valor devuelto por getWriteErrors() para determinar la naturaleza del error.

MongoDB\Driver\Exception\RuntimeException para otros errores a nivel de extensión (por ejemplo, " errores de conexión).

Comportamiento

Si se lanza un MongoDB\Driver\Exception\BulkWriteCommandException, puedes llamar a getWriteErrors() e inspeccionar la información en el arreglo devuelto para determinar la naturaleza del error.

Por ejemplo, una operación de escritura puede haberse aplicado correctamente en el servidor principal pero fallar al satisfacer el nivel de confirmación de escritura (write concern). Alternativamente, una operación de guardar puede haber fallado completamente, por ejemplo, por violar la restricción de clave única.

Ver también

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