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