MongoDB\ClientBulkWrite::insertOne()

定义

MongoDB\ClientBulkWrite::insertOne()

在批量写入命令中指定插入操作。此方法返回调用该方法的 MongoDB\ClientBulkWrite 实例。

function insertOne(
    array|object $document,
    mixed &$id = null
): self

参数

$document : array|object

要插入到集合中的文档。

$id ：混合

捕获文档的 _id字段值以存储在可选输出变量中。

错误/异常

MongoDB\Exception\InvalidArgumentException 用于与参数或选项解析相关的错误。

MongoDB\ 驱动程序\Exception\BulkWriteCommandException 以了解与写入操作相关的错误。您可以检查 getWriteErrors() 返回的值，以确定错误的性质。

MongoDB\ 驱动程序\Exception\RuntimeException 对于扩展级别的其他错误（例如连接错误）。

行为

如果引发MongoDB\ 驱动程序\Exception\BulkWriteCommandException，您可以调用getWriteErrors()并检查返回大量中的信息，以确定错误的性质。

示例，写入操作可能已成功应用于主节点 (primary node in the replica set)服务器，但未能满足写关注（write concern）。或者，写入操作可能彻底失败，示例由于违反了唯一键约束。

另请参阅

• 批量写入操作指南的客户端批量写入部分