(mongodb >=1.4.0)
MongoDB\Driver\Server::executeWriteCommand — Executa um comando de banco de dados que grava neste servidor
$db
, MongoDB\Driver\Command $command
, ?array $options
= null
): MongoDB\Driver\CursorExecuta o comando neste servidor.
Este método aplicará lógica específica para comandos que escrevem (por exemplo,
» drop).
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.
Nota: Este método não se destina a ser usado para executar comandos » insert, » update ou » delete. Os usuários são incentivados a usar MongoDB\Driver\Server::executeBulkWrite() para essas operações.
db
(string)O nome do banco de dados no qual executar o comando.
command
(MongoDB\Driver\Command)O comando a ser executado.
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. |
Se uma "session"
que tem uma transação em andamento
estiver sendo usada, uma opção "readConcern"
ou
"writeConcern"
não pode ser especificada. Isso resultará em uma
exceção MongoDB\Driver\Exception\InvalidArgumentException
sendo lançada. Em vez disso, essas duas opções devem ser definidas ao criar
a transação com
MongoDB\Driver\Session::startTransaction().
Retorna MongoDB\Driver\Cursor em caso de sucesso.
"session"
for usada com uma transação associada em combinação com uma opção "readConcern"
ou "writeConcern"
."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.
|
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á.