Mongo::switchSlave

(PECL mongo >=1.1.0)

Mongo::switchSlaveElije un nuevo secundario para lecturas slaveOkay

Descripción

public Mongo::switchSlave ( void ) : string

Elije un secundario aleatorio para una conexión desde la cual realizar las lecturas. Este método es invocado automáticamente por el controlador, por lo que no es necesesario utilizarlo. Realiza una llamada a MongoClient::getHosts() (para recargar el estado de los hosts) y a MongoClient::getSlave() (para obtener el valor devuelto).

Véase la sección de consultas de este manual para obtener información sobre lecturas distribuidas en secundarios.

Parámetros

Esta función no tiene parámetros.

Valores devueltos

La dirección del secundario que está usando esta conexió para realizar lecturas. Podría ser la misma que la anterior, ya que se eligen aleatoriamente. Si sólo hubiera un secundario (o sólo el primario) únicamente se devolvería una dirección.

Por ejemplo, si tuviéramos un conjunto de réplicas de tres miembros, con un primario, secundario, y un árbitro, este método siempre devolvería la dirección del secundario. Si éste no estvuiera disponible, este método devolvería la dirección del primario. Si éste tampoco estuviera disponible, se emitiría una excepción, ya que un árbitro no puede realizar operaciones de lectura.

Errores/Excepciones

Si se le llama desde una conexión sin conjuntos de réplicas, emite MongoException (código de error 15). También emite MongoException si no pudiera encontrar ningún elemento (primario o secundario) del que leer (código de error 16).

Historial de cambios

Versión Descripción
1.2.11 Emite un error de nivel E_DEPRECATED cuando se usa.