Mongo::switchSlave
(PECL mongo >=1.1.0)
Mongo::switchSlave — Выбирает новый вторичный сервер для чтения slaveOkay
Описание
Выбирает случайный вторичный сервер для соединения для чтения. Он вызывается драйвером автоматически и не должен использоваться. Он вызывает MongoClient::getHosts() (для обновления статуса хостов) и Mongo::getSlave() (для получения возвращаемого значения).
Смотрите раздел про запросы руководства для получения информации о распределении чтений среди вторичных серверов.
Список параметров
У этой функции нет параметров.
Возвращаемые значения
Адрес вторичного сервера, который использует это соединение для чтения. Он может совпадать с предыдущим адресом, поскольку адреса выбираются случайным образом. Он может возвращать только один адрес, если доступен только один дополнительный (или только основной).
Например, если бы у нас была реплика из трех элементов с основным, вторичным и арбитром, этот метод всегда возвращал бы адрес вторичного сервера. Если вторичный сервер становится недоступным, этот метод всегда вернет адрес основного. Если основной также становится недоступным, этот метод выдаст исключение, так как арбитр не может обрабатывать чтения.
Ошибки
Выдает исключение MongoException (код ошибки 15), если оно вызывается для соединения, не связанного с репликой. Он также выдаст исключение MongoException, если не найдет ни одного (основного или дополнительного) сервера для чтения (код ошибки 16).
Список изменений
| Версия | Описание |
|---|---|
| PECL mongo 1.2.11 | Выдает E_DEPRECATED, при использовании. |