定義
Return Values
ID(つまり アップサートされたドキュメントの_id
フィールド値)をスキャンします。 アップサートされたドキュメントがない場合は、 null
が返されます。
アップサートを行う前にドキュメントにIDが存在した場合(つまり、サーバーがIDを生成する必要がなかった場合)、その_id
フィールド値がこれに含まれます。サーバーが生成したID はいずれも MongoDB\ BSON\ObjectId インスタンスになります。
エラーと例外
このメソッドが呼び出され、書込み操作で未確認の書込み保証が使用された場合はMongoDB\Exception\BadMethodCallException
。