/ /

読み取り保証（read concern） `"snapshot"`

バージョン5.0で変更。

読み取り保証 "snapshot" を指定したクエリでは、直近の特定の点のシャード全体に表示れる、過半数のコミット済みデータが返されます。読み取り保証 "snapshot" は、トランザクションが書込み保証 "majority" でコミットされた場合にのみ保証を提供します。

読み取り保証"snapshot"は、マルチドキュメントトランザクションと MongoDB 5.0 以降では、マルチドキュメントトランザクション外の特定の読み取り操作で使用できます。

トランザクションが因果関係がコンシステントなセッションの一部でない場合、書込み保証"majority"によるトランザクションのコミット時に、トランザクション操作は、大多数がコミットされたデータのスナップショットから読み取られることが保証されます。
トランザクションが因果関係がコンシステントなセッションの一部である場合、書込み保証"majority"によるトランザクションのコミット時に、トランザクション操作は、トランザクションの開始直前の操作との因果整合性を提供する、大多数がコミットされたデータのスナップショットから読み取られることが保証されます。

重要

"snapshot" 読み取りは、minSnapshotHistoryWindowInSeconds で指定された期間内にのみ実行できます。minSnapshotHistoryWindowInSeconds より長く続く読み取り操作が終了する可能性があります。

Outside of multi-document transactions, read concern "snapshot" is available on primaries and secondaries for the following read operations:

find
aggregate
distinct （シャーディングされていないコレクションの場合）

All other read commands prohibit "snapshot".

操作

読み取り保証を受け入れるすべての操作のリストについては、「読み取り保証をサポートする操作」を参照してください。

読み取り保証（read concern）とトランザクション

Multi-document transactions support read concern "snapshot" as well as "local", and "majority".

注意

読み取り保証 (read concern) は、個々の操作レベルではなく、トランザクションレベルで設定します。トランザクションに読み取り保証 (read concern) を設定するには、「トランザクションと読み取り保証 (read concern)」を参照してください。

読み取り保証（read concern）と `atClusterTime`

Outside of multi-document transactions, reads with read concern "snapshot" support the optional parameter atClusterTime. The parameter atClusterTime allows you to specify the timestamp for the read. To satisfy a read request with a specified atClusterTime of T, the mongod performs the request based on the data available at time T. If the mongod has not yet reached time T in its oplog, it waits to service the request.

Tip

レプリカセットのノードの延遅に向けて読み取りが行われる場合、maxTimeMS を使用して、指定された atClusterTime で読み取りの待機時間に上限を設定できます。maxTimeMS により、操作が無期限にブロックされることはなく、代わりに mongod が指定された atClusterTime に時間内に達しない場合はエラーが返されます。

操作のoperationTimeまたはclusterTimeは、 db.runCommand()の応答またはSession()オブジェクトから取得できます。

The following command performs a find operation with read concern "snapshot" and specifies that the operation should read data from the snapshot at cluster time Timestamp(1613577600, 1).

db.runCommand( {
    find: "restaurants",
    filter: { _id: 5 },
    readConcern: {
        level: "snapshot",
        atClusterTime: Timestamp(1613577600, 1)
    },
} )

パラメータatClusterTimeが指定されていない場合、 mongos 、または単一ノードレプリカセットではmongodは、最新の過半数がコミットしたスナップショットのタイムスタンプをatClusterTimeとして選択し、それをクライアントに返します。

Outside of transactions, "snapshot" reads are guaranteed to read from majority-committed data.

`atClusterTime` 考慮事項と動作

The allowed values for atClusterTime depend on the minSnapshotHistoryWindowInSeconds parameter. minSnapshotHistoryWindowInSeconds is the minimum time window in seconds for which the storage engine keeps the snapshot history. If you specify an atClusterTime value older than the oldest snapshot retained according to minSnapshotHistoryWindowInSeconds, mongod returns an error.
If you perform a read operation with "snapshot" without specifying atClusterTime against a delayed replica set member, the returned majority-committed data could be stale. If you specify atClusterTime, the mongod waits for the specified timestamp instead of returning stale data, though the read may block or time out.
It is not possible to specify atClusterTime for "snapshot" inside of causally consistent sessions.