温习了MongoDB的插入操作,主要使用PHP语言实践。
目的
- 理解官方shell和PHP SDK操作的差异
- 以MySQL的思维理解MongoDB的shell,感觉差异还是很大的
- 理解有多少种插入操作,以及差异点
- 重点理解异常操作,如何看官方文档
mongoDB shell
insertMany()、insert()、insertOne()三个方法大体上是差不多的,insertMany()相当于批处理,insertOne()是插入当个,这两个函数返回的对象没有明确指示,insert()相当于批处理,如果插入的是单个文档,返回的是WriteResult对象,如果是多个文档返回BulkWriteResult对象(真正的批量操作)。
如果产生异常,则会返回writeConcernErrors和writeErrors两种错误,有两个细节。
如果是批量插入,ordered是true,则遇到一个错误,后面就不返回了,反之则会继续运行,不过最终都会抛出异常。
其次遇到异常就不会返回_ids,这一点觉得特别让人难以理解,若何知晓插入了那些ID?
再次强调,对于MongoDB来说,只能保证单个文档插入是原子性的。另外MongoDB插入的文档不存在,则会自动插件文档。
db.collection.insertMany( [ <document 1> , <document 2>, ... ], { writeConcern: <document>, ordered: <boolean> } )
PHP SDK
各个语言SDK和官方SHELL是差不多的,看的时候可以对照着看。
对于insertMany函数来说,如果处理正常返回的是MongoDB\InsertManyResult对象,它实际上是MongoDB\Driver\WriteResult 扩展的包装。
如果遇到异常,可以通过 MongoDB\Driver\Exception\WriteException::getWriteResult 扩展方法获取,它返回的实际上也是MongoDB\Driver\WriteResult对象。该对象的getWriteConcernError、getWriteErrors函数可以获取具体的错误信息,从而决定程序如何处理。
对于异常来说,还有其他错误类型,比如MongoDB\Exception\InvalidArgumentException、MongoDB\Driver\Exception\RuntimeException。
最后通过一个例子来说明:
$obj = $collection->insertMany( [ [ '_id' => "5f03014f73efc304f72dc6e2", 'email' => 'admin@example.com', ], [ 'username' => 'test', 'email' => 'test@example.com', ] ],[ "ordered"=>false] ); $obj->getInsertedCount(); $obj->getInsertedId(); } catch (\MongoDB\Exception\InvalidArgumentExceptio $e) { } catch (\Exception $e) { $obj = $e->getWriteResult(); $data_1 = $obj->getWriteErrors(); $data_2 = $obj->getInsertedCount(); $data_3 = $obj->getUpsertedIds(); }
整体上和官方文档描述没有太大的差异。
参考:
- https://www.php.net/mongodb-driver-writeexception.getwriteresult
- https://www.php.net/class.mongodb-driver-writeresult
- https://docs.mongodb.com/manual/reference/method/db.collection.insertMany/
- https://docs.mongodb.com/php-library/v1.4/reference/method/MongoDBCollection-insertMany/
总结
更新日志
- 群星《歌手2024 第4期》[FLAC/分轨][563.76MB]
- RiffKitten-ChaosParade(2024)[24-44,1]FLAC
- RuneKlakegg-Nattevandrer(2024)[24-96]\FLAC
- 赖冰霞.2006-金嗓典藏辑2IN1(南方金点系列)2CD【南方】【WAV+CUE】
- 群星.1988-国语金曲尽精英VOL.2【瑞成】【WAV+CUE】
- 张宇.1999-雨一直下【EMI百代】【WAV+CUE】
- 袁娅维.2021-月亮失眠了(DELUXE)【华纳】【FLAC分轨】
- AlanBroadbent-JazzFunk(2024)[24-44,1]
- 梅艳芳《绝代芳华》开盘母带[低速原抓WAV+CUE]
- ABC唱片-《外国精逊母带直刻神奇黑胶[APE+CUE].
- 群星《天赐的声音第五季 第6期》[320K/MP3][101.43MB]
- 群星《天赐的声音第五季 第6期》[FLAC/分轨][526.16MB]
- 群星《说唱梦工厂 第2期》[320K/MP3][96.37MB]
- 杨宗宪.1994-留你留袂着【有容唱片】【WAV+CUE】
- 李翊君.2005-勇敢的爱【创意唱片】【WAV+CUE】