Mongo::getSlave
(PECL mongo >=1.1.0)
Mongo::getSlave — slaveOkay の読み込みに使われているアドレスを返す
説明
public string Mongo::getSlave
( void
)
これは、現在読み込みに使っているセカンダリのアドレスを探します。 このメソッドは読み込み専用です。オブジェクトの内部状態は一切変更しません。
データベースへの接続を作成した時点では、
ドライバはまだどのセカンダリを使うのかを決めていません。
したがって、接続後にこの関数を実行したときには、たとえ利用可能なセカンダリがあったとしても
NULL を返します。slaveOkay を設定したクエリを初めて実行したときに、
ドライバがこの接続で使うセカンダリを選びます。
それ以降は、この関数は選択したセカンダリを返すようになります。
読み込みのセカンダリへの分散についての情報は、このマニュアルの 問い合わせの節 を参照ください。
パラメータ
この関数にはパラメータはありません。
返り値
この接続が読み込みに使っているセカンダリのアドレスを返します。
レプリカセットへの接続ではない場合や接続がまだ初期化されていない場合は
NULL を返します。
エラー / 例外
E_DEPRECATED が発生します。
返される結果はあまり役には立ちません。 というのも、二段階の選択手順でクエリやデータベースコマンドを実行するからです。
変更履歴
| バージョン | 説明 |
|---|---|
| 1.2.11 | E_DEPRECATED を発行するようになりました。 |
参考
- MongoCursor::info() - カーソルの作成と走査に関する情報を取得する
忘却曲線を使ってこの知識を確実に記憶に残す
