“文档” 菜单
文档首页
/
MongoDB Manual
/ / /

getDefaultRWConcern

在此页面上

  • 定义
  • 语法
  • 命令字段
  • 输出
  • 行为
  • 例子
getDefaultRWConcern

getDefaultRWConcern管理命令检索全局默认读关注或写关注设置。

  • 对于分片集群,在 上发出getDefaultRWConcern mongos}。

该命令采用以下形式:

db.adminCommand(
{
getDefaultRWConcern: 1 ,
inMemory: <boolean>,
comment: <any>
}
)

该命令具有以下字段:

字段
类型
说明
getDefaultRWConcern
int

设置为 1

布尔

可选。

设置为 true 可返回全局默认读关注或写关注设置的内存中缓存副本。在对操作应用全局默认值时,实例会使用内存中副本。

设置为 false 可返回部署的全局默认读关注或写关注的磁盘副本。默认为 false

comment
任何

可选。用户提供的待附加到该命令的注释。设置后,该注释将与该命令的记录一起出现在以下位置:

注释可以是任何有效的 BSON 类型(字符串、整型、对象、数组等)。

输出可能包括以下字段:

字段
类型
说明
object

全局默认的写关注配置。

如果部署没有全局默认写关注设置,则此字段不会出现在 getDefaultRWConcern 输出中。

object

全局默认的读关注配置。

如果部署没有全局默认读关注设置,则此字段不会出现在 getDefaultRWConcern 输出中。

字符串

默认写关注的来源。默认情况下,该值为 "implicit"。使用 setDefaultRWConcern 完成设置默认写关注后,该值即变为 "global"

字符串

默认读关注的来源。默认情况下,该值为 "implicit"。使用 setDefaultRWConcern 完成设置默认读关注后,该值即变为 "global"

时间戳

上次修改任何全局默认读关注或写关注设置时的操作时间戳。如果曾经为集群设置过默认值,则存在。

Date

管理员上次设置全局默认读关注或写关注的挂钟日期。此值仅供参考,不应用于任何近期比较。

Date

mongodmongos 上次更新其全局默认读关注和写关注设置的本地副本时的挂钟日期。此值仅供参考,不应用于任何近期比较。

提示

另请参阅:

注意

需要 featureCompatibilityVersion 4.4+

副本集或分片集群中的每个 mongod必须featureCompatibilityVersion 设置为至少 4.4,才能使用 getDefaultRWConcern。如果您将部署的 featureCompatibilityVersion4.4 降级为 4.2,则所有集群范围的读关注和写关注默认设置都将丢失,但是 mongos 实例可能会继续应用默认设置长达 30 秒。

您可以针对副本集的任何数据承载节点发出 getDefaultRWConcern(即,不针对仲裁节点)。

如果从节点尚未从主节点复制最新更改,则它可以返回全局默认设置的“过时”版本。

向集群中的 mongos 发出 setDefaultRWConcern

每个 mongos 都会定期刷新全局默认设置的本地副本。如果 mongos 在最近更新全局默认设置后尚未刷新其本地副本,或者从滞后的配置服务器从节点获取其设置,则它可以返回全局默认设置的“过时”版本。

全局默认设置不会传播到单个分片。不能对分片运行 getDefaultRWConcern

对于实施身份验证的副本集或分片集群,getDefaultRWConcern 要求经过身份验证的用户具有 getDefaultRWConcern 特权操作。

clusterManagerclusterMonitor 内置角色提供运行 getDefaultRWConcern 所需的权限。

以下操作检索 mongod 当前配置的全局默认读关注和写关注。

db.adminCommand({
"getDefaultRWConcern": 1
})

该操作返回类似于以下内容的输出:

{
"defaultWriteConcern" : {
"w" : "majority"
},
"defaultReadConcern" : {
"level" : "majority"
},
"defaultWriteConcernSource" : "global",
"defaultReadConcernSource" : "global",
"updateOpTime" : Timestamp(1586290895, 1),
"updateWallClockTime" : ISODate("2020-04-07T20:21:41.849Z"),
"localUpdateWallClockTime" : ISODate("2020-04-07T20:21:41.862Z"),
"ok" : 1,
"$clusterTime" : { ... }
"operationTime" : Timestamp(1586290925, 1)
}
← getClusterParameter