温习了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/

总结