MongoDB\Driver\Server::executeBulkWrite
(mongodb >=1.0.0)
MongoDB\Driver\Server::executeBulkWrite ā Executa uma ou mais operaƧƵes de gravaĆ§Ć£o neste servidor
DescriĆ§Ć£o
$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.
ParĆ¢metros
namespace(string)-
Um namespace totalmente qualificado (por exemplo,
"nomeDoBancoDados.nomeDaColecao"). bulk(MongoDB\Driver\BulkWrite)- As gravaƧƵes a serem executadas.
options-
OpƧƵes 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.
Valor Retornado
Retorna MongoDB\Driver\WriteResult em caso de sucesso.
Erros/ExceƧƵes
- LanƧa uma MongoDB\Driver\Exception\InvalidArgumentException se
bulknĆ£o contiver nenhuma operaĆ§Ć£o de gravaĆ§Ć£o. - LanƧa uma MongoDB\Driver\Exception\InvalidArgumentException se
bulkjĆ” tiver sido executado. Os objetos MongoDB\Driver\BulkWrite nĆ£o podem ser executados vĆ”rias vezes. - LanƧa uma exceĆ§Ć£o MongoDB\Driver\Exception\InvalidArgumentException se a opĆ§Ć£o
"session"for usada em combinaĆ§Ć£o com uma preocupaĆ§Ć£o de escrita nĆ£o confirmada. - LanƧa uma exceĆ§Ć£o MongoDB\Driver\Exception\InvalidArgumentException em caso de erro ao analisar argumentos.
- LanƧa uma exceĆ§Ć£o MongoDB\Driver\Exception\ConnectionException se a conexĆ£o com o servidor falhar (por outros motivos alĆ©m da autenticaĆ§Ć£o).
- LanƧa uma exceĆ§Ć£o MongoDB\Driver\Exception\AuthenticationException se a autenticaĆ§Ć£o for necessĆ”ria e falhar.
- LanƧa uma exceĆ§Ć£o MongoDB\Driver\Exception\BulkWriteException em caso de qualquer falha de escrita (por exemplo, erro de escrita, falha ao aplicar uma preocupaĆ§Ć£o de escrita).
- LanƧa um MongoDB\Driver\Exception\RuntimeException em outros erros.
Registro de AlteraƧƵes
| 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.
|
Notas
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Ć”.
Veja TambƩm
- MongoDB\Driver\BulkWrite
- MongoDB\Driver\WriteResult
- MongoDB\Driver\WriteConcern
- MongoDB\Driver\Manager::executeBulkWrite() - Executa uma ou mais operaƧƵes de escrita
Melhore Esta PƔgina
Notas de UsuƔrios
-
0
pcntl_sigtimedwaitWaits for signals, with a timeout
-
0
similar_textCalculate the similarity between two strings
-
0
boolvalGet the boolean value of a variable
-
0
curl_multi_closeClose a set of cURL handles
-
0
imap_bodyRead the message body
-
0
mb_strposFind position of first occurrence of string in a string
-
0
pg_send_prepareSends a request to create a prepared statement with the given parameters, without waiting for completion
-
0
swoole_native_socket_bind
-
0
Arr::prependKeysWith
-
0
zend_versionGets the version of the current Zend engine