MongoDB\ClientBulkWrite::insertOne()

Definição

MongoDB\ClientBulkWrite::insertOne()

Specify an insert operation in the bulk write command. This method returns the MongoDB\ClientBulkWrite instance on which it's called.

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

Parâmetros

$document : array|object

O documento para inserir na coleção.

$id : misto

Captures the document's _id field value to store in an optional output variable.

Erros/exceções

MongoDB\Exception\InvalidArgumentException para erros relacionados à análise de parâmetros ou opções.

MongoDB\Driver\Exception\BulkWriteCommandException para erros relacionados à operação de gravação. Você pode inspecionar o valor retornado por getWriteErrors() para determinar a natureza do erro.

MongoDB\Driver\Exception\RuntimeException para outros erros no nível da extensão (por exemplo erros de conexão).

Comportamento

Se uma MongoDB\Driver\Exception\BulkWriteCommandException for lançada, você poderá chamar getWriteErrors() e inspecionar as informações na array retornada para determinar a natureza do erro.

Por exemplo, uma operação de gravação pode ter sido aplicada com êxito ao servidor primário , mas não atendeu ao preocupação de gravação. Como alternativa, uma operação de gravação pode ter falhado completamente, por exemplo , por violar a restrição de chave exclusiva.

Veja também

• SeçãoGravação em massa do cliente do Guia de operações de gravação em massa