Mongo::switchSlave
(PECL mongo >=1.1.0)
Mongo::switchSlave — Choose a new secondary for slaveOkay reads
Description
This choses a random secondary for a connection to read from. It is called automatically by the driver and should not need to be used. It calls MongoClient::getHosts() (to refresh the status of hosts) and Mongo::getSlave() (to get the return value).
See the query section of this manual for information on distributing reads to secondaries.
Parameters
This function has no parameters.
Return Values
The address of the secondary this connection is using for reads. This may be the same as the previous address as addresses are randomly chosen. It may return only one address if only one secondary (or only the primary) is available.
For example, if we had a three member replica set with a primary, secondary, and arbiter this method would always return the address of the secondary. If the secondary became unavailable, this method would always return the address of the primary. If the primary also became unavailable, this method would throw an exception, as an arbiter cannot handle reads.
Errors/Exceptions
Throws a MongoException (error code 15) if it is called on a non-replica-set connection. It will also throw MongoExceptions if it cannot find anyone (primary or secondary) to read from (error code 16).
Changelog
Version | Description |
---|---|
1.2.11 | Emits E_DEPRECATED when used. |
See Also
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения для работы с базами данных
- Расширения для работы с базами данных отдельных производителей
- MongoDB
- Дополнительно
- Функция Mongo::connectUtil() - Connects with a database server
- Функция Mongo::__construct() - The __construct purpose
- Функция Mongo::getPoolSize() - Get pool size for connection pools
- Функция Mongo::getSlave() - Returns the address being used by this for slaveOkay reads
- Функция Mongo::getSlaveOkay() - Get slaveOkay setting for this connection
- Функция Mongo::poolDebug() - Returns information about all connection pools.
- Функция Mongo::setPoolSize() - Set the size for future connection pools.
- Функция Mongo::setSlaveOkay() - Change slaveOkay setting for this connection
- Функция Mongo::switchSlave() - Choose a new secondary for slaveOkay reads
Коментарии
404 Not Found