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