[DOCS-11045] Add missing output fields to isMaster results Created: 21/Nov/17  Updated: 29/Oct/23  Resolved: 12/Dec/17

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: None
Fix Version/s: mongodb-3.6

Type: Improvement Priority: Minor - P4
Reporter: Jeremy Mikola Assignee: Allison Reinheimer Moore
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Duplicate
is duplicated by DOCS-10426 Document isMaster.readOnly Closed
Related
related to DOCS-12251 isMaster.compression is not always r... Closed
related to DOCS-12252 isMaster.compression documentation i... Closed
related to DOCS-8388 3.4 -- automationNotices Closed
is related to SERVER-12275 Add MaxWriteBatchSize to isMaster res... Closed
Participants:
Days since reply: 6 years, 9 weeks, 1 day ago
Story Points: 1

 Description   

The maxWriteBatchSize was introduced in 2.6 (SERVER-12275) and specifies the maximum number of write operations that may appear in a single insert, update, or delete command.

This value was originally 1000 when first introduced but has increased over time. 3.6 reports a limit of 100,000. I don't think we need to document the exact version returned by each server version. It would be sufficient to simply mention what the field is. Drivers are instructed to respect this (along with maxBsonObjectSize and maxMessageSizeBytes) when splitting bulk write operations into commands to send over the wire.



 Comments   
Comment by Githook User [ 12/Dec/17 ]

Author:

{'name': 'Allison Moore', 'email': 'allison.moore@10gen.com', 'username': 'schmalliso'}

Message: DOCS-11045: adds new isMaster output fields for cluster time
Branch: master
https://github.com/mongodb/docs/commit/b5fe5498d423ece94e4cf8604ca117f583bc79ca

Comment by Allison Reinheimer Moore [ 22/Nov/17 ]

We're missing docs for the following output fields – we should add them to the isMaster reference:

Missing from v3.4:

  • readOnly
  • ok
  • automationServiceDescriptor (DOCS-8388)

3.6 adds a bunch as well – here's new sample output for 3.6:

replset:SECONDARY> db.isMaster()
{
	"hosts" : [
		"localhost:27017",
		"localhost:27018",
		"localhost:27019"
	],
	"setName" : "replset",
	"setVersion" : 1,
	"ismaster" : false,
	"secondary" : true,
	"me" : "localhost:27017",
	"lastWrite" : {
		"opTime" : {
			"ts" : Timestamp(1511362459, 1),
			"t" : NumberLong(-1)
		},
		"lastWriteDate" : ISODate("2017-11-22T14:54:19Z")
	},
	"maxBsonObjectSize" : 16777216,
	"maxMessageSizeBytes" : 48000000,
	"maxWriteBatchSize" : 100000,
	"localTime" : ISODate("2017-11-22T14:54:25.130Z"),
	"maxWireVersion" : 6,
	"logicalSessionTimeoutMinutes" : 30,
	"minWireVersion" : 0,
	"readOnly" : false,
	"compression" : [
		"snappy"
	],
	"ok" : 1,
	"operationTime" : Timestamp(1511362459, 1),
	"$clusterTime" : {
		"clusterTime" : Timestamp(1511362459, 1),
		"signature" : {
			"hash" : BinData(0,"AAAAAAAAAAAAAAAAAAAAAAAAAAA="),
			"keyId" : NumberLong(0)
		}
	}
}

So we should document those new ones as well!

Generated at Thu Feb 08 08:01:56 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.