MongoDB\Driver\ReadPreference 類別

(mongodb >=1.0.0)

簡介

類別概要

final class MongoDB\Driver\ReadPreference implements MongoDB\BSON\Serializable, Serializable {

/* 常數 */

const int RP_PRIMARY = 1;

const int RP_PRIMARY_PREFERRED = 5;

const int RP_SECONDARY = 2;

const int RP_SECONDARY_PREFERRED = 6;

const int RP_NEAREST = 10;

const string PRIMARY = primary;

const string PRIMARY_PREFERRED = primaryPreferred;

const string SECONDARY = secondary;

const string SECONDARY_PREFERRED = secondaryPreferred;

const string NEAREST = nearest;

const int NO_MAX_STALENESS = -1;

const int SMALLEST_MAX_STALENESS_SECONDS = 90;

/* 方法 */

final public bsonSerialize(): stdClass

final public __construct(string|int $mode, ?array $tagSets = null, ?array $options = null)

final public getHedge(): ?object

final public getMaxStalenessSeconds(): int

final public getMode(): int

final public getModeString(): string

final public getTagSets(): array

final public serialize(): string

final public unserialize(string $data): void

}

預定義常數

MongoDB\Driver\ReadPreference::RP_PRIMARY: 所有操作皆從目前的副本集主節點讀取。這是 MongoDB 的預設讀取偏好設定。

警告
此常數自擴充版本 1.20.0 起已遭 *棄用*，並將於 2.0 中移除。應用程式應改用 MongoDB\Driver\ReadPreference::PRIMARY。
MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED: 在大多數情況下，操作會從主節點讀取，但如果主節點不可用，操作將從次要成員讀取。

警告
此常數自擴充版本 1.20.0 起已遭 *棄用*，並將於 2.0 中移除。應用程式應改用 MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED。
MongoDB\Driver\ReadPreference::RP_SECONDARY: 所有操作皆從副本集的次要成員讀取。

警告
此常數自擴充版本 1.20.0 起已遭 *棄用*，並將於 2.0 中移除。應用程式應改用 MongoDB\Driver\ReadPreference::SECONDARY。
MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED: 在大多數情況下，操作會從次要成員讀取，但如果沒有可用的次要成員，操作將從主節點讀取。

警告
此常數自擴充套件版本 1.20.0 起已遭棄用，並將於 2.0 版中移除。應用程式應改用MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED。
MongoDB\Driver\ReadPreference::RP_NEAREST: 從具有最小網路延遲的副本集成員讀取操作，不考慮成員的類型。

警告
此常數自擴充套件版本 1.20.0 起已遭棄用，並將於 2.0 版中移除。應用程式應改用MongoDB\Driver\ReadPreference::NEAREST。
MongoDB\Driver\ReadPreference::PRIMARY: 所有操作皆從目前的副本集主節點讀取。這是 MongoDB 的預設讀取偏好設定。
MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED: 在大多數情況下，操作會從主節點讀取，但如果主節點不可用，操作將從次要成員讀取。
MongoDB\Driver\ReadPreference::SECONDARY: 所有操作皆從副本集的次要成員讀取。
MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED: 在大多數情況下，操作會從次要成員讀取，但如果沒有可用的次要成員，操作將從主節點讀取。
MongoDB\Driver\ReadPreference::NEAREST: 從具有最小網路延遲的副本集成員讀取操作，不考慮成員的類型。
MongoDB\Driver\ReadPreference::NO_MAX_STALENESS: "maxStalenessSeconds" 選項的預設值是不指定最大延遲限制，這表示驅動程式在選擇將讀取操作導向何處時，不會考慮次要節點的延遲。
MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS: "maxStalenessSeconds" 選項的最小值為 90 秒。驅動程式會透過定期檢查每個副本集成員的最新寫入日期來估計次要節點的延遲。由於這些檢查並不頻繁，因此延遲估計值較為粗略。因此，驅動程式無法強制執行小於 90 秒的最大延遲值。

更新日誌

版本說明

PECL mongodb 1.20.0

版本	說明
PECL mongodb 1.20.0	已棄用 `MongoDB\Driver\ReadPreference::RP_PRIMARY`、`MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED`、`MongoDB\Driver\ReadPreference::RP_SECONDARY`、`MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED` 和 `MongoDB\Driver\ReadPreference::RP_NEAREST` 常數。
PECL mongodb 1.7.0	新增了 `MongoDB\Driver\ReadPreference::PRIMARY`、`MongoDB\Driver\ReadPreference::PRIMARY_PREFERRED`、`MongoDB\Driver\ReadPreference::SECONDARY`、`MongoDB\Driver\ReadPreference::SECONDARY_PREFERRED` 和 `MongoDB\Driver\ReadPreference::NEAREST` 常數。實作 Serializable 介面。
PECL mongodb 1.2.0	新增了 `MongoDB\Driver\ReadPreference::NO_MAX_STALENESS` 和 `MongoDB\Driver\ReadPreference::SMALLEST_MAX_STALENESS_SECONDS` 常數。實作 MongoDB\BSON\Serializable 介面。

已棄用 MongoDB\Driver\ReadPreference::RP_PRIMARY、MongoDB\Driver\ReadPreference::RP_PRIMARY_PREFERRED、MongoDB\Driver\ReadPreference::RP_SECONDARY、MongoDB\Driver\ReadPreference::RP_SECONDARY_PREFERRED 和 MongoDB\Driver\ReadPreference::RP_NEAREST 常數。

PECL mongodb 1.7.0