默认 MongoDB 读关注/写关注

在此页面上

读关注 (read concern)

写关注
因果一致性保证

读关注 (read concern)

点击放大

默认读关注

默认的读关注如下：

操作	默认读关注
读取主节点	`"local"` 注意此读关注可返回可能已回滚的数据。这种读关注并不能保证因果一致性。
Reads against secondaries.	`"local"` 注意此读关注可返回可能已回滚的数据。这种读关注并不能保证因果一致性。

指定读关注：MongoDB 驱动程序

注意

以下内容适用于在事务之外发出的操作。

有关与事务内部发出的操作相关的读关注信息，请单击 Operations in Transactions 标签页。

使用 MongoDB 驱动程序，您可以覆盖默认的读关注并为以下级别的操作设置读关注：

等级	说明
客户端级别	适用于操作，除非在数据库/集合/操作级别为操作设置了更精细的读关注。
数据库级别	适用于对数据库的集合执行的操作（即覆盖客户端读关注），除非已在集合级别或操作级别设置读关注。注意不适用于事务内部的操作。
集合级别	适用于对集合执行的读取操作（即覆盖数据库/客户端读关注），除非已在操作级别设置读关注。注意不适用于事务内部的操作。
操作级别	适用于特定的读取操作（即覆盖数据库/客户端/集合读关注）。能否在操作中设置读关注取决于驱动程序。请参阅驱动程序文件。注意不适用于事务内部的操作。

注意

以下内容适用于事务内部发出的操作。

有关与事务外部发出的操作相关的读关注信息，请单击 Operations outside Transactions 标签页。

使用MongoDB 驱动程序，您可以覆盖默认的读关注并为以下级别的事务设置读关注：

等级	说明
客户端级别	适用于事务，除非在会话/事务级别设置了更细粒度的读关注。注意事务中的所有操作都使用事务读关注；也就是说，在操作/集合/数据库级别设置的任何读关注在事务中都会被忽略。
会话级别	适用于在会话中启动的事务（即覆盖客户端读关注），除非在特定事务级别设置了更细粒度的读关注级别。注意事务中的所有操作都使用事务读关注；也就是说，在操作/集合/数据库级别设置的任何读关注在事务中都会被忽略。有关详细信息，请参阅事务和读关注。
事务级别	适用于具体事务（即覆盖客户端/会话读关注）。注意事务中的所有操作都使用事务读关注；也就是说，在操作/集合/数据库级别设置的任何读关注在事务中都会被忽略。有关详细信息，请参阅事务和读关注。

写关注

点击放大

默认写关注

从 MongoDB 5.0 开始，隐式默认写关注为 w: majority。但是，对于包含仲裁节点的部署，需要特别考虑以下事项：

副本集的投票多数是 1 加投票成员数量的一半，四舍五入。如果数据承载投票成员的数量不超过投票多数，则默认写关注为 { w: 1 }。
在所有其他场景中，默认写关注为 { w: "majority" }。

具体来说，MongoDB 使用以下公式来确定默认写关注：

if [ (#arbiters > 0) AND (#non-arbiters <= majority(#voting-nodes)) ]
    defaultWriteConcern = { w: 1 }
else
    defaultWriteConcern = { w: "majority" }

例如，考虑以下部署以及各自的默认写关注：

Non-Arbiters	仲裁节点	投票节点	多数投票节点	隐式默认写关注
2	1	3	2	`{ w: 1 }`
4	1	5	3	`{ w: "majority" }`

在第一个示例中：
- 有 2 个非仲裁节点和 1 个仲裁节点，共有 3 个投票节点。
- 多数投票节点（1 加 3 的一半，四舍五入）为 2。
- 非仲裁节点的数量 (2) 等于多数投票节点 (2)，导致隐式写关注为 { w: 1 }。
在第二个示例中：
- 共有 5 个投票节点，其中有 4 个非仲裁节点和 1 个仲裁节点。
- 多数投票节点（1 加 5 的一半，四舍五入）为 3。
- 非仲裁节点的数量 (4) 大于多数投票节点 (3)，导致隐式写关注为 { w: "majority" }。

指定写关注：MongoDB 驱动程序

注意

以下内容适用于在事务之外发出的操作。

有关与事务内部发出的操作相关的读关注信息，请单击 Operations in Transactions 标签页。

使用MongoDB 驱动程序，您可以覆盖默认写关注并为以下级别的操作设置写关注：

等级	说明
客户端级别	适用于操作，除非在操作/数据库/集合级别为操作设置了更精细的写关注。
数据库级别	适用于对数据库的集合执行的写入操作（即覆盖客户端写关注），除非在集合级别或操作级别设置了写关注。注意不适用于事务内部的操作。
集合级别	适用于对集合执行的写入操作（即覆盖数据库和客户端写关注），除非在操作级别设置了写关注。注意不适用于事务内部的操作。
操作级别	适用于特定的写入操作。能否在操作中设置写关注取决于驱动程序。请参阅驱动程序文件。注意不适用于事务内部的操作。

注意

以下内容适用于事务内部发出的操作。

有关与事务外部发出的操作相关的读关注信息，请单击 Operations outside Transactions 标签页。

使用 MongoDB 驱动程序，您可以覆盖默认写关注，并在以下级别为事务设置写关注：

等级	说明
客户端级别	适用于事务，除非在会话/事务级别为事务设置了更细粒度的写关注。事务写关注适用于提交操作和事务内的操作。注意事务中的所有操作都使用事务写关注；也就是说，在操作/集合/数据库级别设置的任何写关注在事务中都会被忽略。
会话级别	适用于在会话中启动的事务，除非在特定事务级别设置写关注级别。事务写关注适用于提交操作和事务内的操作。注意事务中的所有操作都使用事务写关注；也就是说，在操作/集合/数据库级别设置的任何写关注在事务中都会被忽略。
事务级别	适用于特定事务。事务写关注适用于提交操作和事务内的操作。注意事务中的所有操作都使用事务写关注；也就是说，在操作/集合/数据库级别设置的任何写关注在事务中都会被忽略。

有关更多信息，请参阅事务和写关注。

因果一致性保证

使用因果一致的客户端会话时，只有在以下情况下，客户端会话才能保证因果一致性：

关联的读取操作使用 "majority" 读关注，而
关联的写入操作使用 "majority" 写关注。

后退

默认端口

来年

错误代码