MongoDB\Driver\Manager::executeReadCommand
(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeReadCommand — Execute a database command that reads
Descrição
$db, MongoDB\Driver\Command $command, ?array $options = null): MongoDB\Driver\Cursor
Selects a server according to the "readPreference" option
and executes the command on that server. By default, the read preference from
the MongoDB Connection
URI will be used.
This method will apply logic that is specific to commands that read (e.g.
» count)
and take the MongoDB server version into account. The
"readConcern" option will default to the corresponding
value from the MongoDB
Connection URI.
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 -
options Option Type Description readConcern MongoDB\Driver\ReadConcern Um read concern a ser aplicado à operação.
Esta opção está disponível no MongoDB 3.2+ e resultará em uma exceção em tempo de execução se for especificada para uma versão de servidor mais antiga.
readPreference MongoDB\Driver\ReadPreference Uma preferência de leitura a ser usada para selecionar um servidor para a operação.
session MongoDB\Driver\Session Uma sessão para associar à operação.
AvisoSe 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 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.
- Throws MongoDB\Driver\Exception\RuntimeException on other errors (e.g. invalid command).
Veja Também
- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Manager::executeCommand() - Execute a database command
- MongoDB\Driver\Manager::executeReadWriteCommand() - Execute a database command that reads and writes
- MongoDB\Driver\Manager::executeWriteCommand() - Execute a database command that writes
- MongoDB\Driver\Server::executeReadCommand() - Execute a database command that reads on this server
add a note
