(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|MongoDB\Driver\WriteConcern|null $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 um write concern não confirmado.
| Versão | Descrição |
|---|---|
| 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á.