大师

客户端断开¶

从MongoDB 4.2开始，如果发出isMaster 断开连接的客户端在操作完成之前断开连接，则MongoDB将标记isMaster为终止（即killOp在操作上）。

所有实例¶

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

isMaster.ismaster¶

一个布尔值，报告该节点何时可写。如果 true，则该实例是一个主要的 副本集，或mongos实例，或一个独立的 mongod。

false如果实例是副本集的辅助成员，或者该成员是副本集的 仲裁者，则 此字段为。

isMaster.maxBsonObjectSize¶

此过程允许的BSON对象的最大大小（以字节为单位）mongod。如果未提供，则客户应假定最大大小为“ ”。16 * 1024 * 1024

isMaster.maxMessageSizeBytes¶

BSON有线协议消息的最大允许大小。默认值为48000000字节。

isMaster.maxWriteBatchSize¶

写入批处理中允许的最大写入操作数。如果批处理超出此范围 limit，则客户端驱动程序会将批处理分为较小的组，每个组的计数小于或等于此字段的值。

此限制的值是100,000写入。

在3.6版本中更改：该限制从提出1,000到100,000写入。此限制也适用于旧OP_INSERT邮件。

isMaster.localTime¶

以UTC返回本地服务器时间。该值是一个 ISO日期。

isMaster.logicalSessionTimeoutMinutes¶

3.6版的新功能。

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

只有当可featureCompatibilityVersion为"3.6"或更大。请参阅向后不兼容功能。

isMaster.connectionId¶

4.2版中的新功能。

mongod/ mongos 实例到客户端的传出连接的标识符。

isMaster.minWireVersion¶

该协议mongod或mongos实例能够用来与客户端通信的有线协议的最早版本 。

客户可以minWireVersion用来帮助协商与MongoDB的兼容性。

isMaster.maxWireVersion¶

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

客户可以maxWireVersion用来帮助协商与MongoDB的兼容性。

isMaster.readOnly¶

3.4版的新功能。

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

isMaster.compression¶

3.4版的新功能。

阵列上市使用，或可使用的压缩算法（即共用的客户端和两个mongod或 mongos实例），以压缩在客户端和之间的通信mongod或 mongos实例。

该字段仅在使用压缩时可用。例如：

• 如果mongod启用可以同时使用 snappy,zlib压缩程序和客户端zlib，则该compression字段将包含：

  复制

  "compression": [ "zlib" ]
  

• 如果mongod启用可以同时使用 snappy,zlib压缩程序和客户端zlib,snappy，则该compression字段将包含：

  复制

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

• 如果mongod已启用，以使用 snappy压缩程序并且已指定客户端zlib,snappy，则该compression字段将包含：

  复制

  "compression": [ "snappy" ]
  

• 如果mongod启用可以使用snappy 压缩器，并且已指定zlib客户端或客户端未指定压缩器，那么将省略该字段。

也就是说，如果客户端未指定压缩，或者客户端指定未为连接mongod或mongos实例启用的压缩器 ，则该字段不会返回。

isMaster.saslSupportedMechs¶

一系列用于创建用户凭证或凭据的SASL机制。支持的SASL机制是：

• GSSAPI
• SCRAM-SHA-256
• SCRAM-SHA-1

仅当命令与saslSupportedMechs字段一起运行时才返回该 字段：

复制

db.runCommand( { isMaster: 1, saslSupportedMechs: "<db.username>" } )

分片实例¶

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

isMaster.msg¶

从实例返回isdbgrid时包含值。isMastermongos

副本集¶

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

isMaster.hosts¶

在格式字符串数组"[hostname]:[port]"，其中列出的所有成员副本集既不是 隐藏的，被动，也不仲裁器。

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

isMaster.setName¶

当前：replica集的名称。

isMaster.setVersion¶

当前副本集配置版本。

isMaster.secondary¶

一个布尔值，当时true，指示boolean 是否 mongod为副本集的次要成员。

isMaster.passives¶

串中的格式的阵列"[hostname]:[port]" 列出的所有成员副本集，其具有 members[n].priority的0。

仅当存在具有至少一个构件出现此域 members[n].priority的0。

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

isMaster.arbiters¶

在格式的字符串数组"[hostname]:[port]" 列出的所有成员副本集是 仲裁者。

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

isMaster.primary¶

以"[hostname]:[port]"列出副本集的当前主要成员格式的字符串。

isMaster.arbiterOnly¶

一个布尔值，当true表示当前实例是一个仲裁器时。arbiterOnly 如果实例是仲裁者，则仅存在该字段。

isMaster.passive¶

一个布尔值true，表示时，当前实例是被动的。该 passive字段仅出现用于与构件 members[n].priority的0。

isMaster.hidden¶

一个布尔值，当true表示当前实例为隐藏时。该 hidden字段仅适用于隐藏成员。

isMaster.tags¶

甲tags文档包含副本集构件用户定义标签字段和值对。

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

• 对于读取操作，可以在读取首选项中指定一个标记集，以将操作定向到具有指定标记的副本集成员。
• 对于写操作，您可以使用 和 创建自定义写关注。settings.getLastErrorModessettings.getLastErrorDefaults

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

也可以看看

members[n].tags

isMaster.me¶

在[hostname]:[port]返回的成员 isMaster。

isMaster.electionId¶

每次选举的唯一标识符。仅包含在输出isMaster为主要。由客户用来确定何时进行选举。

isMaster.lastWrite¶

3.4版的新功能。

包含optime和日期信息的文档，用于数据库的最新写入操作。

isMaster.lastWrite.opTime¶

一个对象，提供OPTIME最后一次写操作。

isMaster.lastWrite.lastWriteDate¶

一个日期对象，包含上一次写入操作的时间。

isMaster.lastWrite.majorityOpTime¶

一个对象，提供OPTIME最后一次写操作可读的majority读取。

isMaster.lastWrite.majorityWriteDate¶

一个日期对象，其中包含majority读取可读取的最后一次写入操作的时间 。

有关ok状态字段，operationTime字段和$clusterTime字段的详细信息，请参见“ 命令响应”。