Executa um comando de banco de dados que grava neste servidor

Descrição

final public MongoDB\Driver\Server::executeWriteCommand(string $db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor

Executa 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.

Note: 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.

Parâmetros

db (string)

O nome do banco de dados no qual executar o comando.

command (MongoDB\Driver\Command)

O comando a ser executado.

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.

Warning

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().

Valor Retornado

Retorna MongoDB\Driver\Cursor em caso de sucesso.

Erros/Exceções

Lança uma exceção MongoDB\Driver\Exception\InvalidArgumentException se a opção "session" for usada com uma transação associada em combinação com uma opção "readConcern" ou "writeConcern".
Lança uma exceção MongoDB\Driver\Exception\InvalidArgumentException se a opção "session" for usada em combinação com um write concern não confirmado.
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 MongoDB\Driver\Exception\RuntimeException em outros erros (por exemplo, comando inválido).

Registro de Alterações

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.

Notas

Note: É 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\Command
MongoDB\Driver\Cursor
MongoDB\Driver\Server::executeCommand() - Executa um comando de banco de dados neste servidor
MongoDB\Driver\Server::executeReadCommand() - Executa um comando de banco de dados que lê neste servidor
MongoDB\Driver\Server::executeReadWriteCommand() - Executa um comando de banco de dados que lê e grava neste servidor
MongoDB\Driver\Manager::executeWriteCommand() - Executa um comando de banco de dados que escreve