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, el valor del campo _id) del documento sobreinsertado. Si no se sobreinsertó ningún documento, se devolverá null.

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

Errores/Excepciones

MongoDB\Exception\BadMethodCallException si se llama a este método y la operación de escritura utilizó un problema de escritura no reconocido.

Ver también

• MongoDB\Driver\WriteResult::getUpsertedIds()