MongoDB\ClientBulkWrite::insertOne()

Definición

MongoDB\ClientBulkWrite::insertOne()

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

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

Parámetros

$document : matriz|objeto

El documento para insertar en la colección.

$id :mixto

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

Errores/Excepciones

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

MongoDB\Driver\Exception\BulkWriteCommandExceptionPara 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 en el nivel de extensión (por ejemplo, errores de conexión).

Comportamiento

Si se lanza una MongoDB\Driver\Exception\BulkWriteCommandException, puede llamar a getWriteErrors() e inspeccionar la información en la matriz devuelta para determinar la naturaleza del error.

Por ejemplo, es posible que una operación de escritura se haya aplicado correctamente al servidor principal, pero no haya solucionado el problema. Alternativamente, es posible que una operación de escritura haya fallado por completo, por ejemplo, por violar la restricción de clave única.

Ver también

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