isMaster

在本页面

Definition

isMaster
- isMaster返回描述mongod实例角色的文档。

如果实例是副本集的成员，则isMaster返回副本集配置和状态的子集，包括实例是否为副本集的primary。

当发送到不是副本集成员的mongod实例时，isMaster返回此信息的子集。

MongoDB drivers和clients使用isMaster确定副本集成员的状态并发现replica set的其他成员。

mongo Shell 中的db.isMaster()方法提供了isMaster的包装。

该命令采用以下形式：

{ isMaster: 1 }

Output

All Instances

以下isMaster字段在所有角色中都是公用的：

isMaster. ismaster
- 一个布尔值，报告该节点何时可写。如果是true，那么此实例是replica set中的primary，或者是主从配置中的master，或者是mongos实例，或者是独立的mongod。

如果实例是副本集的secondary成员或成员是副本集的arbiter，则此字段为false。

isMaster. maxBsonObjectSize
- 此mongod进程允许的BSON对象的最大大小(以字节为单位)。如果未提供，则 Client 端应假定最大大小为“ 16 * 1024 * 1024”。
isMaster. maxMessageSizeBytes
- BSON有线协议消息的最大允许大小。默认值为48000000个字节。
isMaster. maxWriteBatchSize
- 写批处理中允许的最大写操作数。如果批处理超出此limit，则 Client 端驱动程序会将批处理分为较小的组，每个组的计数小于或等于此字段的值。

此限制的值为100,000次写入。

在版本 3.6 中进行了更改：写入次数从1,000增加到100,000。此限制也适用于旧版OP_INSERT消息。

isMaster. localTime
- 以 UTC 返回本地服务器时间。此值为ISO date。
isMaster. logicalSessionTimeoutMinutes
- 3.6 版的新功能。

session最近一次使用后保持活动状态的时间(以分钟为单位)。尚未从 Client 端接收新的读/写操作或在此阈值内用refreshSessions刷新的会话将从缓存中清除。服务器可以随时清除与过期会话相关的状态。

仅在featureCompatibilityVersion为"3.6"时可用。参见向后不兼容的功能。

isMaster. minWireVersion
- 2.6 版的新功能。

mongod或mongos实例可用于与 Client 端通信的有线协议的最早版本。

Client 端可以使用minWireVersion帮助协商与 MongoDB 的兼容性。

isMaster. maxWireVersion
- 2.6 版的新功能。

mongod或mongos实例可用于与 Client 端通信的最新版本的有线协议。

Client 端可以使用maxWireVersion帮助协商与 MongoDB 的兼容性。

isMaster. readOnly
- 3.4 版的新功能。

一个布尔值，当true时，指示mongod或mongos以只读模式运行。

isMaster. compression
- 3.4 版的新功能。

一个数组，列出了用于压缩 Client 端和mongod或mongos实例之间的通信的压缩算法(即 Client 端和mongod或mongos实例共有)。

仅当使用压缩时，此字段才可用。例如：

如果启用了mongod以使用snappy,zlib压缩器，并且 Client 端指定了zlib，则compression字段将包含：

"compression": [ "zlib" ]

如果启用了mongod以使用snappy,zlib压缩器，并且 Client 端指定了zlib,snappy，则compression字段将包含：

"compression": [ "zlib", "snappy" ]

如果启用了mongod以使用snappy压缩器，并且 Client 端指定了zlib,snappy，则compression字段将包含：

"compression": [ "snappy" ]

如果启用了mongod以使用snappy压缩器，并且 Client 端指定了zlib或 Client 端未指定压缩器，则将省略该字段。

即，如果 Client 端未指定压缩，或者 Client 端指定未为连接的mongod或mongos实例启用压缩器，则该字段不会返回。

Sharded Instances

mongos个实例将以下字段添加到isMaster响应文档中：

isMaster. msg
- 当isMaster从mongos实例返回时，包含值isdbgrid。

Replica Sets

副本集的成员返回isMaster时，包含以下字段：

isMaster. setName
- 当前：replica 集的名称。
isMaster. setVersion
- 2.6 版的新功能。

当前副本集的配置版本。

isMaster. secondary
- 一个布尔值，当true时，指示mongod是否是replica set的secondary成员。
isMaster. hosts
- "[hostname]:[port]"格式的字符串数组，列出了replica set既不是hidden，passive也不是arbiters的所有成员。

驱动程序使用此数组和isMaster.passives确定要读取的成员。

isMaster. passives
- "[hostname]:[port]"格式的字符串数组，列出members[n].priority的0的replica set的所有成员。

仅当至少有一个成员的members[n].priority为0时，才会显示此字段。

驱动程序使用此数组和isMaster.hosts确定要读取的成员。

isMaster. arbiters
- "[hostname]:[port]"格式的字符串数组，列出了replica set的所有成员arbiters。

仅当副本集中至少有一个仲裁器时，才会显示此字段。

isMaster. primary
- "[hostname]:[port]"格式的字符串，列出副本集的当前primary成员。
isMaster. arbiterOnly
- 一个布尔值，当true时，指示当前实例是arbiter。如果实例是仲裁者，则仅提供arbiterOnly字段。
isMaster. passive
- 一个布尔值，当true时，指示当前实例为passive。 passive字段仅对members[n].priority为0的成员显示。
isMaster. hidden
- 一个布尔值，当true时，指示当前实例为hidden。 hidden字段仅适用于隐藏成员。
isMaster. tags
- tags文档包含用户定义的标记字段和副本集成员的值对。

{ "<tag1>": "<string1>", "<tag2>": "<string2>",... }

对于读取操作，您可以在read preference中指定一个标签集，以将操作定向到具有指定标签的副本集成员。
对于写操作，可以使用settings.getLastErrorModes和settings.getLastErrorDefaults创建自定义write concern。

有关更多信息，请参见配置副本集标记集。

Docs

Docs4dev

Title here