MongoDB\ClientBulkWrite::withCollection()

Definição

MongoDB\ClientBulkWrite::withCollection()

Retorne uma instância atualizada do MongoDB\ClientBulkWrite da instância MongoDB\Collection fornecida. Esse método permite adicionar operações de gravação subsequentes em uma collection diferente daquela com a qual o ClientBulkWrite foi criado.

Este método não cria um novo BulkWriteCommand e não edita a instância ClientBulkWrite em vigor.

function withCollection(
    Collection $collection,
): self

Você não pode misturar instâncias do Collection associadas com objetos do Manager diferentes ao chamar este método em uma instância do ClientBulkWrite. Isso ocorre porque a biblioteca envia o BulkWriteCommand concluído para um único servidor.

Parâmetros

$collection : MongoDB\Collection

A instância Collection a ser definida como destino das operações de gravação adicionadas à instância ClientBulkWrite depois de chamar withCollection().

Return Values

Uma nova instância ClientBulkWrite com a mesma especificação BulkWriteCommand, mas um namespace de destino atualizado.

Erros/exceções

MongoDB\Exception\UnsupportedException se as opções forem usadas e não aceitas pelo servidor selecionado (p. ex., collation, readConcern, writeConcern).

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

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

Veja também

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