(mongodb >=1.0.0)
MongoDB\Driver\Server::executeBulkWrite — Executa uma ou mais operações de gravação neste servidor
$namespace, MongoDB\Driver\BulkWrite $bulk, ?array $options = null): MongoDB\Driver\WriteResultExecuta uma ou mais operações de gravação neste servidor.
Um MongoDB\Driver\BulkWrite pode ser construído com uma ou mais operações de gravação de vários tipos (por exemplo, atualizações, exclusões e inserções). O driver tentará enviar operações do mesmo tipo ao servidor no menor número possível de solicitações para otimizar viagens de ida e volta.
O valor padrão para a opção "writeConcern" será
inferido de uma transação ativa (indicada pela
opção "session"), seguida pelo
URI de conexão.
namespace (string)
Um namespace totalmente qualificado (por exemplo, "nomeDoBancoDados.nomeDaColecao").
bulk (MongoDB\Driver\BulkWrite)As gravações a serem executadas.
options
| Opção | Tipo | Descrição |
|---|---|---|
| session | MongoDB\Driver\Session |
Uma sessão para associar à operação. |
| writeConcern | MongoDB\Driver\WriteConcern |
Um write concern a ser aplicado à operação. |
Retorna MongoDB\Driver\WriteResult em caso de sucesso.
bulk não contiver nenhuma operação de gravação.bulk já tiver sido executado. Os objetos MongoDB\Driver\BulkWrite não podem ser executados várias vezes."session" for usada em combinação com uma preocupação de escrita não confirmada.
| Versão | Descrição |
|---|---|
| PECL mongodb 2.0.0 |
O parâmetro options não aceita mais uma instância de
MongoDB\Driver\WriteConcern.
|
| PECL mongodb 1.21.0 |
Passar um objeto MongoDB\Driver\WriteConcern como
options foi descontinuado e será removido na versão 2.0.
|
| PECL mongodb 1.4.4 |
MongoDB\Driver\Exception\InvalidArgumentException
será lançada se a opção "session" for usada em combinação
com uma preocupação de gravação não reconhecida.
|
| PECL mongodb 1.4.0 |
O terceiro parâmetro agora é um array options.
Para compatibilidade com versões anteriores, esse parâmetro ainda aceitará
um objeto MongoDB\Driver\WriteConcern.
|
| PECL mongodb 1.3.0 |
MongoDB\Driver\Exception\InvalidArgumentException
agora é lançada se bulk não contiver nenhuma operação
de gravação. Anteriormente, uma
MongoDB\Driver\Exception\BulkWriteException era
lançada.
|
Nota: É responsabilidade do invocador garantir que o servidor seja capaz de executar a operação de escrita. Por exemplo, executar uma operação de escrita em um servidor secundário (excluindo seu banco de dados "local") falhará.