getDefaultRWConcern

在此页面上

定义

兼容性
语法
命令字段
输出
行为
例子

定义

getDefaultRWConcern

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

对于分片的集群，在getDefaultRWConcern 上发出mongos }。

兼容性

此命令可用于以下环境中托管的部署：

MongoDB Atlas：用于云中 MongoDB 部署的完全托管服务

注意

所有 MongoDB Atlas 集群都支持此命令。有关 Atlas 对所有命令的支持的信息，请参阅不支持的命令。

MongoDB Enterprise：基于订阅、自我管理的 MongoDB 版本
MongoDB Community：源代码可用、免费使用且可自行管理的 MongoDB 版本

语法

该命令采用以下形式：

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

命令字段

该命令具有以下字段：

字段	类型	说明
getDefaultRWConcern	int	设置为 `1`。
inMemory	布尔	可选。设置为 `true` 可返回全局默认读关注或写关注设置的内存中缓存副本。在对操作应用全局默认值时，实例会使用内存中副本。设置为 `false` 可返回部署的全局默认读关注或写关注的磁盘副本。默认为 `false`。
`comment`	any	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 `attr.command.cursor.comment` 字段中。 `command.comment` 字段中的数据库分析器输出。 `currentOp` 输出，在 `command.comment` 字段。注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。

输出

输出可能包括以下字段：

字段	类型	说明
默认写关注	`object`	全局默认的写关注配置。如果部署没有全局默认写关注设置，则此字段不会出现在 `getDefaultRWConcern` 输出中。
默认读关注	`object`	全局默认的读关注配置。如果部署没有全局默认读关注设置，则此字段不会出现在 `getDefaultRWConcern` 输出中。
defaultWriteConcernSource	字符串	默认写关注的来源。默认情况下，该值为 `"implicit"`。使用 `setDefaultRWConcern` 完成设置默认写关注后，该值即变为 `"global"`。
defaultReadConcernSource	字符串	默认读关注的来源。默认情况下，该值为 `"implicit"`。使用 `setDefaultRWConcern` 完成设置默认读关注后，该值即变为 `"global"`。
updateOpTime	时间戳	上次修改任何全局默认读关注或写关注设置时的操作时间戳。如果曾经为集群设置过默认值，则存在。
updateWallClockTime	Date	管理员上次设置全局默认读关注或写关注的挂钟日期。此值仅供参考，不应用于任何近期比较。
localUpdateWallClockTime	Date	`mongod` 或 `mongos` 上次更新其全局默认读关注和写关注设置的本地副本时的挂钟日期。此值仅供参考，不应用于任何近期比较。

提示

另请参阅：

setDefaultRWConcern

行为

注意

需要 featureCompatibilityVersion 4.4+

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

副本集

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

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

分片集群

向集群中的 mongos 发出 setDefaultRWConcern。

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

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

访问控制

对于在自管理部署上实施身份验证的副本集或分片的集群， getDefaultRWConcern要求经过身份验证的用户具有getDefaultRWConcern权限动作。

clusterManager 或 clusterMonitor 内置角色提供运行 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

来年

getParameter