MongoDB\BulkWriteResult::getUpsertedIds()

定义

MongoDB\BulkWriteResult::getUpsertedIds()

返回 ID 的映射（即 _id字段值），查询由批量写入中的所有更新和替换操作更新或插入的文档。

function getUpsertedIds(): array

Return Values

ID 映射（即 _id字段值），查询由批量写入中的所有更新和替换操作更新或插入的文档。

映射中每个ID的索引对应于批量操作中每个文档的位置。如果文档在更新或插入之前具有ID（即服务器未生成ID），则索引将包含其 _id字段值。任何服务器生成的ID都是MongoDB\BSON\ObjectId实例。

错误/异常

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

另请参阅

• MongoDB\Driver\WriteResult::getUpsertedIds()