MongoDB\Driver\Manager::selectServer
(mongodb >=1.0.0)
MongoDB\Driver\Manager::selectServer — Seleciona um servidor que corresponde a uma preferência de leitura
Descrição
$readPreference = null): MongoDB\Driver\Server
Seleciona um MongoDB\Driver\Server correspondente
à preferência de leitura informada em readPreference. Se
readPreference for null ou omitido, o servidor
primário será selecionado por padrão. Isto pode ser usado para pré-selecionar um servidor
para realizar a verificação de versão antes de executar uma operação.
Note: Ao contrário do MongoDB\Driver\Manager::getServers(), este método inicializará as conexões do banco de dados e realizará a descoberta do servidor, se necessário. Consulte a » Especificação de seleção de servidor para obter informações adicionais.
Parâmetros
readPreference(MongoDB\Driver\ReadPreference)-
A preferência de leitura a ser usada para selecionar um servidor. Se
nullou omitido, o servidor primário será selecionado por padrão.
Valor Retornado
Retorna um MongoDB\Driver\Server que corresponde à preferência de leitura.
Erros/Exceções
- 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 MongoDB\Driver\Exception\RuntimeException se um servidor que corresponda à preferência de leitura não puder ser encontrado.
Registro de Alterações
| Versão | Descrição |
|---|---|
| PECL mongodb 1.11.0 |
O readPreference agora é opcional. Se null
ou omitido, o servidor primário será selecionado por padrão.
|
Veja Também
- MongoDB\Driver\Server
- MongoDB\Driver\Manager::getServers() - Retorna os servidores aos quais este gerenciador está conectado
- » Especificação de seleção de servidor