MongoDB\UpdateResult::getUpsertedId()

本页内容

定义

MongoDB\UpdateResult::getUpsertedId()

返回插入文档的ID（即_id字段值）。

function getUpsertedId(): mixed|null

插入文档的ID（即_id字段值）。如果没有插入文档，则返回null。

如果文档在插入之前已有ID（即服务器不需要生成ID），这将包含其_id字段值。任何由服务器生成的ID都将是一个MongoDB\BSON\ObjectId实例。

MongoDB\Exception\BadMethodCallException 如果此方法被调用，并且写入操作使用了未确认的写入关注点。

getUpsertedCount()

isAcknowledged()