(mongodb >=1.4.0)
MongoDB\Driver\Manager::executeReadCommand — Executa um comando de banco de dados que faz leitura
$db
, MongoDB\Driver\Command $command
, ?array $options
= null
): MongoDB\Driver\Cursor
Seleciona um servidor de acordo com a opção "readPreference"
e executa o comando nesse servidor.
Este método aplicará uma lógica específica para comandos de leitura (por exemplo,
» distinct).
Os valores padrão para as opções "readPreference"
e
"readConcern"
serão inferidos de uma transação
ativa (indicada pela opção "session"
), seguido
pelo URI de conexão.
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 |
---|---|---|
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. |
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"
.