[DOCS-4292] The definition for sh.splitAt() is not correct Created: 06/Nov/14  Updated: 13/Nov/23  Resolved: 09/Feb/15

Status: Closed
Project: Documentation
Component/s: manual
Affects Version/s: None
Fix Version/s: v1.3.18, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Bug Priority: Major - P3
Reporter: Linda Qin Assignee: Kay Kim (Inactive)
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
Participants:
Days since reply: 9 years, 1 week, 2 days ago

 Description   

http://docs.mongodb.org/manual/reference/method/sh.splitAt/

Currently the definition for sh.splitAt() is:

Splits the chunk containing the document specified by the query as if that document were at the “middle” of the collection, even if the specified document is not the actual median of the collection.

This command doesn't split the chunk at the "middle" of the collection. It is used to split the chunk in a specific point specified by the query.

Also, the description for the "query" parameter is:

query document A query to identify a document in a specific chunk. Typically specify the shard key for a document as the query.

This is not true. The query is to identify the split point in a specific chunk range, and it must use the shard key as the query.



 Comments   
Comment by Githook User [ 09/Feb/15 ]

Author:

{u'username': u'kay-kim', u'name': u'kay', u'email': u'kay.kim@10gen.com'}

Message: DOCS-4292 sh.split methods
Branch: master
https://github.com/mongodb/docs/commit/346dcd7233154daed068f02c6d7577dfee50a16e

Comment by Githook User [ 09/Feb/15 ]

Author:

{u'username': u'kay-kim', u'name': u'kay', u'email': u'kay.kim@10gen.com'}

Message: DOCS-4292 sh.split methods
Branch: v2.6
https://github.com/mongodb/docs/commit/ed69e3e362f0ab9d65ae1372ad04f25de5d1de49

Comment by Githook User [ 09/Feb/15 ]

Author:

{u'username': u'kay-kim', u'name': u'kay', u'email': u'kay.kim@10gen.com'}

Message: DOCS-4292 sh.split methods
Branch: v2.4
https://github.com/mongodb/docs/commit/e4ae0b754513ff14fdae8a45c632ba5cbb8a1fe4

Comment by Linda Qin [ 06/Nov/14 ]

Also, there is the same issue for the parameter query in sh.splitFind():

query document A query to identify a document in a specific chunk. Typically specify the shard key for a document as the query.

It must specify the shard key as the query, otherwise, it will return an error (Similar misleading message as SERVER-13450):

{
	"code" : 13141,
	"ok" : 0,
	"errmsg" : "exception: Chunk map pointed to incorrect chunk"
}

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