[DOCS-15138] [Server] Investigate changes in SERVER-60926: Make enableSharding command optional Created: 28/Feb/22  Updated: 13/Nov/23  Resolved: 17/May/22

Status: Closed
Project: Documentation
Component/s: manual, Server
Affects Version/s: None
Fix Version/s: 6.0.0-rc0, Server_Docs_20231030, Server_Docs_20231106, Server_Docs_20231105, Server_Docs_20231113

Type: Task Priority: Major - P3
Reporter: Backlog - Core Eng Program Management Team Assignee: Kenneth Dyer
Resolution: Fixed Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Documented
documents SERVER-60926 Make enableSharding command optional Closed
Participants:
Days since reply: 1 year, 38 weeks, 2 days ago
Epic Link: DOCSP-19446

 Description   
Original Downstream Change Summary

Starting from FCV 6.0 all databases will be considered sharding-enabled by default, meaning that it won't be necessary to call `enableSharding` on a database before to shard a collection (through `shardCollection`) in that database.

Additionally starting from FCV 6.0 `shardCollection` will automatically create the database if doesn't exists, this means that starting from FCV 6.0 it won't never throw NamespacesNotFound.

Description of Linked Ticket

Before to create a sharded collection it is currently required to invoke the enableSharding command. This command doesn't really do much apart from setting a flag in config.databases, that is only consumed by the shardCollection command.

This additional step is not very useful and not really required in order to create a sharded collection, additionally it contributes to make the sharding experience more complicated than than the replica set one without any real benefit.

This ticket contain a proposal to make the enableSharding command optional and to deprecate it.

Proposal:

  • It won't be necessary anymore to call enableSharding  before to shard a collection. 
  • We will still keep support for enableSharding command  because users are using it to select the database primaryShard before to create a collection. So enableSharding  will really behave like a "createDatabase" that you can use if you want to create a database with specific options, otherwise default options will be chosen automatically on the implicit creation (like the primarShard). 
  • Additionally the name "enableSharding" will become misleading since it won't really "enable sharding" anymore, so we will introduce a new  createDatabase command as an alias of the old enableSharding. In this sense the new  createDatabase  command will be very similar to createCollection , it will be optional but you can use it to specify particular options for database creation.


 Comments   
Comment by Githook User [ 16/May/22 ]

Author:

{'name': 'Kenneth P. J. Dyer', 'email': '93145796+kennethdyer@users.noreply.github.com', 'username': 'kennethdyer'}

Message: DOCS-15138 enableSharding (#1040)

  • DOCS-15138 Adds versionchanged notice to reference page
  • (DOCS-15177): Add count to stable API v1 (#1015)
  • (DOCSP-21679): stage stable api updates for count

add 6.0 release notes

add stable api changelog

remove extra text

updates per review feedback

re-stage

re-stage

add footnotes to table

adjust table widths

table widths

tweak header copy

adding command specific section to changelog

formatting

formatting

  • remove count migration example
  • remove list of supported commands
  • tweak
  • add link to stable api changelog from release notes
  • clarify actor
  • add stable API ref
  • apply copy review suggestion
  • wording
  • Update 5.0.txt
  • DOCSP-22186-namespace-content-addition (#1017)
  • DOCSP-22186-namespace-content-addition
  • DOCSP-22186-namespace-content-addition
  • DOCSP-22186-namespace-content-addition
  • DOCSP-22186-namespace-content-addition
  • DOCSP-22186-namespace-content-addition

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>

Co-authored-by: jeff-allen-mongo <jeffrey.allen@10gen.com>
Co-authored-by: ianf-mongodb <85948430+ianf-mongodb@users.noreply.github.com>
Co-authored-by: jason-price-mongodb <69260375+jason-price-mongodb@users.noreply.github.com>
Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: master
https://github.com/10gen/docs-mongodb-internal/commit/3e13f8614b44e31030c13e623e53f5819c907585

Comment by Kenneth Dyer [ 09/May/22 ]

tommaso.tocci@mongodb.com  We have docs ready for your review and sign-off here: PR.

Comment by Jess Mokrzecki [ 28/Mar/22 ]

Fix Version updated for upstream SERVER-60926:
6.0.0-rc0

Comment by Jess Mokrzecki [ 28/Mar/22 ]

Fix Version updated for upstream SERVER-60926:
6.0.0, 6.0.0-rc0

Comment by Jess Mokrzecki [ 28/Feb/22 ]

Fix Version updated for upstream SERVER-60926:
6.0.0

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