(mongodb >=1.4.0)
MongoDB\Driver\Server::executeReadCommand — Execute a database command that reads on this server
$db
, MongoDB\Driver\Command $command
, ?array $options
= null
): MongoDB\Driver\Cursor
Executes the command on this server, irrespective of the
"readPreference"
option.
This method will apply logic that is specific to commands that read (e.g.
» distinct).
Default values for the "readPreference"
and
"readConcern"
options will be inferred from an active
transaction (indicated by the "session"
option), followed
by the connection URI.
Nota: A opção
"readPreference"
não controla o servidor ao qual o driver emite a operação; ela sempre será executada neste objeto servidor. Em vez disso, ela pode ser usada ao emitir a operação para um servidor secundário (de uma conexão de conjunto de réplicas, não autônomas) ou nós mongo para garantir que o driver defina o protocolo de conexão de acordo ou adicione a preferência de leitura à operação, respectivamente.
db
(string)O nome do banco de dados no qual executar o comando.
command
(MongoDB\Driver\Command)O comando a ser executado.
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. |
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"
.