Docs Menu
Docs Home
/ /

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

項目一覧