MongoDB\UpdateResult::getUpsertedId()

Definición

MongoDB\UpdateResult::getUpsertedId()

Devuelve el ID (es decir, el valor del campo _id) del documento insertado.

function getUpsertedId(): mixed|null

Return Values

El ID (es decir, Valor de campo _id) del documento actualizado. Si no se actualizó ningún documento, se devolverá null.

Si el documento tenía un ID antes de la inserción o actualización (es decir, si el servidor no necesitaba generar un ID), esto contendrá el valor de su campo _id. Cualquier ID generado por el servidor será un MongoDB\BSON\ObjectId instancia.

Errores/Excepciones

MongoDB\Exception\BadMethodCallException si este método se llama y la operación de guardar usó un nivel de confirmación de escritura (write concern)no reconocida.

Ver también

• MongoDB\Driver\WriteResult::getUpsertedIds()