[CXX-1998] 'CommitQuorum' option support for 'createIndexes’ command on MongoDB 4.4 Created: 16/Apr/20  Updated: 28/Oct/23  Resolved: 17/Jul/20

Status: Closed
Project: C++ Driver
Component/s: None
Affects Version/s: None
Fix Version/s: 3.6.0-rc0, 3.6.0

Type: New Feature Priority: Major - P3
Reporter: Backlog - Core Eng Program Management Team Assignee: Clyde Bazile III (Inactive)
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Depends
depends on CDRIVER-3627 'CommitQuorum' option support for 'cr... Closed
is depended on by DRIVERS-966 'CommitQuorum' option support for 'cr... Closed
Epic Link: CXX 4.4 Support

 Description   

Description of Drivers Ticket:

Execution team has introduced a new option named ‘commitQuorum’ to ‘createIndexes’ command as part of PM-253 (Two phase commit for index build). ‘commitQuorum’ is very similar to writeConcern options which can accept an integer or a string - “majority”and custom write concern option. In addition to those values, the new ‘commitQuorum’ option will also accept “votingMembers” string value. A primary node that coordinates an index build can’t complete an index build until it has received votes from secondaries stating that they have each finished collection scanning and draining phase for that index build. The number of votes the primary has to wait before committing an index depends on the commitQuorum option’s value. The primary is also eligible to vote and it will vote for itself.

The main purpose of this new ‘commitQuorum’ option is to prevent slow secondaries replication from getting blocked on applying ‘commitIndexBuild’ oplog entry waiting for the index build completion on that secondary.

The current default value for the ‘commitQuorum’ option in 4.4 RC0 is “majority”, i.e., majority of voting data bearing nodes. Currently, some implementation issues with initial sync and abort index build logic have prevented us from making the default value for ‘commitQuorum’ as ‘votingMembers’, i.e., all voting data bearing nodes. For MongoDB 4.4 GA, the default value for ‘commitQuorum’ will be ‘all’ and we are working towards making the default value change (SERVER-46823).

For a quick reference, if a user wants to create an index ‘x_1’ on foo.bar collection with a commit quorum value as “votingMembers”, then the shell syntax will be:

>> db.runCommand(
{createIndexes: “bar”,
indexes: [{name: "x_1", key: {x: 1}}],
commitQuorum: "votingMembers"});

Say, if it’s a 3 node replica set (PSA), then the primary index build will wait for 2 votes (PS) to commit the index build.
See DRIVERS-966 for updated details.



 Comments   
Comment by Githook User [ 17/Jul/20 ]

Author:

{'name': 'Clyde Bazile', 'email': '34226620+bazile-clyde@users.noreply.github.com', 'username': 'bazile-clyde'}

Message: CXX-1998 'CommitQuorum' support for 'createIndexes’ cmd (#691)
Branch: master
https://github.com/mongodb/mongo-cxx-driver/commit/5b73b8d6471cbe53ee22e187fbf09cb235a7213a

Generated at Wed Feb 07 22:04:34 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.