cursor.readPref()（mongoshメソッド）

定義

cursor.readPref(mode, tagSet, hedgeOptions): 重要
mongosh メソッド
This page documents a mongosh method. This is not the documentation for a language-specific driver, such as Node.js.
MongoDB API ドライバーについては、各言語の「MongoDB ドライバーのドキュメント」を参照してください。
Append readPref() to a cursor to control how the client routes the query to members of the replica set.
注意
You must apply readPref() to the cursor before retrieving any documents from the database.

パラメーター

Parameter	タイプ	説明
モード	string	次の読み取り設定モードのいずれか: `primary`、`primaryPreferred`、`secondary`、`secondaryPreferred`、または `nearest`
tagSet	ドキュメントの配列	任意。指定されたタグを持つメンバーへの読み取りをターゲットにするために使用されるタグセット。 `tagSet`は使用できません`primary` 詳しくは、「読み込み設定（read preference）のタグセットリスト」を参照してください。
hedgeOptions	ドキュメント	任意。ヘッジの使用を有効にするかどうかを指定するドキュメント。 `{ enabled: <boolean> }` `enabled` フィールドのデフォルトは true です。つまり、空のドキュメント `{ }` を指定することは `{ enabled: true }` を指定することと同じです。ヘッジされた読み取りはシャーディングされたクラスターで利用できます。ヘッジされた読み取りを使用するには、 `mongos`にヘッジされた読み取り用の`enabled support` （デフォルト）と、 `primary`以外の読み込み設定（ read preference ）がヘッジされた読み取りの使用を有効にする必要があります。読み込み設定（read preference）`nearest` により、シャーディングされたクラスターでのヘッジ読み取りの使用がデフォルトで有効になります。つまり、デフォルトでは `{ enabled: true }` になります。

readPref() does not support the Read Preference maxStalenessSeconds option for read preference.

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

注意

This command is supported in all MongoDB Atlas clusters. For information on Atlas support for all commands, see Unsupported Commands.

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

例

読み込み設定（read preference）モードを指定する

次の操作では、読み込み設定（read preference）モードを使用して、セカンダリメンバーへの読み取りをターゲットにします。

db.collection.find({ }).readPref( "secondary")

読み込み設定（read preference）のタグセットを指定する

To target secondaries with specific tags, include both the mode and the tagSet array:

db.collection.find({ }).readPref(
   "secondary",
   [
      { "datacenter": "B" },    // First, try matching by the datacenter tag
      { "region": "West"},      // If not found, then try matching by the region tag
      { }                       // If not found, then use the empty document to match all eligible members
   ]
)

セカンダリ選択プロセス中に、MongoDB は最初に datacenter: "B" タグを持つセカンダリノードを検索しようとします。

見つかった場合、MongoDB は適格なセカンダリを datacenter: "B" タグを持つものに制限し、残りのタグを無視します。
何も見つからない場合、MongoDB は "region": "West" タグを持つセカンダリノードを検索しようとします。
- 見つかった場合、MongoDB は適格なセカンダリを "region": "West" タグのあるものに制限します。
- 何も見つからない場合、MongoDB は適格なセカンダリを使用します。

詳しくは、「タグの一致順序」を参照してください。

Tip

レプリカセットタグセットの構成

ヘッジされた読み取りを指定する

シャーディングされたクラスターの場合、非プライマリ読み込み設定（ read preference ）でヘッジされた読み取りを有効にできます。ヘッジされた読み取りを使用するには、 mongosにヘッジされた読み取り用のenabled support （デフォルト）と、 primary以外の読み込み設定（ read preference ）でヘッジされた読み取りの使用が有効になっている必要があります。

To target secondaries on sharded clusters using hedged reads, include both the mode and the hedgeOptions, as in the following examples:

タグセットなし
db.collection.find({ }).readPref( "secondary", // mode null, // tag set { enabled: true } // hedge options )
タグセットあり
db.collection.find({ }).readPref( "secondary", // mode [ { "datacenter": "B" }, { } ], // tag set { enabled: true } // hedge options )

戻る

cursor.readConcern

cursor.returnKey