Menu Docs
Página inicial do Docs
/
Idiomas
/
PHP
/
Manual da Biblioteca PHP
/
Documentação da API
/
MongoDB\ClientBulkWrite

MongoDB\ClientBulkWrite::insertOne()

Novidades na versão 2.1.

Definição

MongoDB\ClientBulkWrite::insertOne()

Especifique uma operação de inserção no comando de escrita em massa. Este método retorna a instância MongoDB\ClientBulkWrite na qual é chamado.

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

Parâmetros

$document : array|object
O documento para inserir na coleção.
$id : misto
Captura o valor de campo _id do documento para armazenar em uma variável de saída opcional.

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ção Gravação em massa do cliente do Guia de operações de gravação em massa

Voltar

DeleteOne()

Próximo

replaceOne()

Nesta página