[DOCS-1708] Documentation isn't clear on what a 'blocking index build' is Created: 15/Jul/13  Updated: 19/Aug/13  Resolved: 15/Aug/13

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: None

Type: Bug Priority: Major - P3
Reporter: William Zola Assignee: Zack Brown
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified
Environment:

http://docs.mongodb.org/manual/core/indexes/#background-construction
http://docs.mongodb.org/manual/tutorial/build-indexes-in-the-background/#build-indexes-in-the-background


Issue Links:
Depends
Participants:
Days since reply: 10 years, 26 weeks, 2 days ago

 Description   

The documentation correctly states that a foreground index build is a blocking operation. However, it does not explain what this means.

When a foreground index build is occurring on a particular collection in a particular database, it holds a write lock for that database for the entire duration of the index build, and does not release it until the index build is complete. This means that while the index build is ongoing:

  • You cannot access (read, insert, update, delete) any documents in any collection in the same database as the index build
  • You cannot perform any operation that requires a read or write lock on all databases ( "listDatabases" comes to mind, but there are probably others ).

If and when collection-level locking gets implemented, this will change.



 Comments   
Comment by auto [ 19/Aug/13 ]

Author:

{u'username': u'tychoish', u'name': u'Sam Kleinman', u'email': u'samk@10gen.com'}

Message: DOCS-1708: edits background indexes
Branch: master
https://github.com/mongodb/docs/commit/a5d059070ef4f824563eaad429c5d193a3e18e66

Comment by auto [ 19/Aug/13 ]

Author:

{u'username': u'Zackrobat', u'name': u'Zack Brown', u'email': u'zack.brown@10gen.com'}

Message: DOCS-1708: Documentation isn't clear on what a 'blocking index build' is

Signed-off-by: Sam Kleinman <samk@10gen.com>
Branch: master
https://github.com/mongodb/docs/commit/ee296f516eaed93357851b406d5a934cf500797b

Generated at Thu Feb 08 07:41:43 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.