Docs Menu
Docs Home
/ /

MongoDB\BulkWriteResult::getUpsertedIds()

MongoDB\BulkWriteResult::getUpsertedIds()

ID のマップ(つまり _idフィールド値)は、一括書き込みのすべての更新操作と置換操作によってアップサートされたドキュメントの 。

function getUpsertedIds(): array

ID のマップ(つまり _idフィールド値)は、一括書き込みのすべての更新操作と置換操作によってアップサートされたドキュメントの 。

マップ内の各IDのインデックスは、 一括操作内の各ドキュメントの位置に対応します。アップサートを行う前にドキュメントにIDが存在した場合(つまり、サーバーがIDを生成しなかった場合)、インデックスにはその _idフィールド値が含まれます。サーバーが生成したID はいずれも MongoDB\BSON\ObjectIdインスタンスになります。

このメソッドが呼び出され、書込み操作で未確認の書込み保証が使用された場合はMongoDB\Exception\BadMethodCallException

戻る

getUpsertedCount()

項目一覧