MongoDB\BulkWriteResult::getUpsertedIds()

定义

MongoDB\BulkWriteResult::getUpsertedIds()

返回一个映射，包含通过批量写入中的所有更新和替换操作插入的文档的ID（即 _id 字段值）。

function getUpsertedIds(): array

返回值

包含通过批量写入中的所有更新和替换操作插入的文档的ID（即 _id 字段值）的映射。

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

错误/异常

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

参见

• MongoDB\Driver\WriteResult::getUpsertedIds()