[DOCS-15590] [Server] Warn users that they cannot change index type when running refineshardkey Created: 30/Aug/22  Updated: 13/Nov/23  Resolved: 02/Sep/22

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

Type: Task Priority: Critical - P2
Reporter: Kelsey Schubert Assignee: Jason Price
Resolution: Done Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Issue Links:
Related
related to SERVER-69220 refineCollectionShardKey permits togg... Closed
Participants:
Days since reply: 1 year, 22 weeks, 1 day ago
Epic Link: DOCSP-11701
Story Points: 3

 Description   

We should update

https://www.mongodb.com/docs/manual/core/sharding-refine-a-shard-key/

and

https://www.mongodb.com/docs/manual/reference/command/refineCollectionShardKey/#mongodb-dbcommand-dbcmd.refineCollectionShardKey

to more explicitly state that you cannot modify the index type as part of this operation. In some versions this will succeed (SERVER-69220 will block it), but introduce sharding metadata inconsistencies.

For example, users should not refine from {a:1} to {a:"hashed",b:1}. As this would make the routing table not match the physical location of the documents.



 Comments   
Comment by Githook User [ 06/Sep/22 ]

Author:

{'name': 'jason-price-mongodb', 'email': '69260375+jason-price-mongodb@users.noreply.github.com', 'username': 'jason-price-mongodb'}

Message: DOCS-15590 refineshardkey updates (#1746)

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: v6.1
https://github.com/10gen/docs-mongodb-internal/commit/ed524f07779a6a3e9d71118db86753660bbbce5d

Comment by Githook User [ 02/Sep/22 ]

Author:

{'name': 'jason-price-mongodb', 'email': '69260375+jason-price-mongodb@users.noreply.github.com', 'username': 'jason-price-mongodb'}

Message: DOCS-15590 refineshardkey updates (#1746) (#1766)

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

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: v4.4
https://github.com/10gen/docs-mongodb-internal/commit/7bc530eebc626ada58677bc7b4d50da471c721da

Comment by Githook User [ 02/Sep/22 ]

Author:

{'name': 'jason-price-mongodb', 'email': '69260375+jason-price-mongodb@users.noreply.github.com', 'username': 'jason-price-mongodb'}

Message: DOCS-15590 refineshardkey updates (BACKPORT) (#1765)

  • DOCSP-24882 set window fields and transaction (#1734)
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction
  • DOCSP-24882-setWindowFields-and-transaction

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

  • DOCSP-24882-setWindowFields-update

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

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: v5.0
https://github.com/10gen/docs-mongodb-internal/commit/652ede2d1d347927a67b060dc7fcd109b633d8d5

Comment by Githook User [ 02/Sep/22 ]

Author:

{'name': 'jason-price-mongodb', 'email': '69260375+jason-price-mongodb@users.noreply.github.com', 'username': 'jason-price-mongodb'}

Message: DOCS-15590 refineshardkey updates (#1746)

Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
Branch: master
https://github.com/10gen/docs-mongodb-internal/commit/ed524f07779a6a3e9d71118db86753660bbbce5d

Comment by Garaudy Etienne [ 31/Aug/22 ]

Add me as reviewer please

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