Join us Sept 17 at .local NYC! Use code WEB50 to save 50% on tickets. Learn more >
MongoDB Event
Docs Menu
Docs Home
/ / /
PHP ライブラリ マニュアル
/ / /

MongoDB\UpdateResult::getUpsertedId()

MongoDB\UpdateResult::getUpsertedId()

ID( アップサートされたドキュメントの_idフィールド値)をスキャンします。

function getUpsertedId(): mixed|null

ID(つまり アップサートされたドキュメントの_idフィールド値)をスキャンします。 アップサートされたドキュメントがない場合は、 nullが返されます。

アップサートを行う前にドキュメントにIDが存在した場合(つまり、サーバーがIDを生成する必要がなかった場合)、その_id フィールド値がこれに含まれます。サーバーが生成したID はいずれも MongoDB\ BSON\ObjectId インスタンスになります。

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

戻る

getUpsertedCount()

項目一覧