MongoDB\UpdateResult::getUpsertedId()

Definición

MongoDB\UpdateResult::getUpsertedId()

Devuelva el ID (es decir, _id valor de campo) del documento insertado o actualizado.

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 realizar la inserción y actualización (es decir, si el servidor no necesitaba generar un ID), aquí se almacenará el valor de su campo _id. Cualquier id generado por el servidor será una instancia de MongoDB\BSON\ObjectId.

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()