Executa um comando de banco de dados que faz leitura

# MongoDB\Driver\Manager::executeReadCommand

(mongodb >=1.4.0)

MongoDB\Driver\Manager::executeReadCommand — Executa um comando de banco de dados que faz leitura

### Descrição

final public function MongoDB\Driver\Manager::executeReadCommand(string `$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.

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

  Aviso

  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 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 (ex.: comando inválido).

### Veja Também

- MongoDB\Driver\Command
- MongoDB\Driver\Cursor
- MongoDB\Driver\Manager::executeCommand() - Executa um comando de banco de dados
- MongoDB\Driver\Manager::executeReadWriteCommand() - Executa um comando de banco de dados que lê e grava
- MongoDB\Driver\Manager::executeWriteCommand() - Executa um comando de banco de dados que escreve
- MongoDB\Driver\Server::executeReadCommand() - Executa um comando de banco de dados que lê neste servidor

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open