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

jason-price-mongodb · jason-price-mongodb · web-flow · commit 652ede2d1d34 · 2022-09-02T10:51:01.000-07:00
* 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 * DOCS-15590 refineshardkey updates (#1746) * DOCS-15590-refineshardkey-updates * DOCS-15590-refineshardkey-updates * DOCS-15590-refineshardkey-updates Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com> Co-authored-by: jason-price-mongodb <jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com>
diff --git a/source/core/sharding-refine-a-shard-key.txt b/source/core/sharding-refine-a-shard-key.txt
@@ -19,6 +19,8 @@ data distribution and can address situations where the existing key
 has led to :ref:`jumbo chunks <jumbo-chunks>` due to insufficient
 :ref:`cardinality <shard-key-cardinality>`.
 
+.. include:: /includes/refine-shard-key-index-type.rst
+
 .. note::
 
    Starting in MongoDB 5.0, you can also :ref:`reshard your collection
diff --git a/source/includes/refine-shard-key-index-type.rst b/source/includes/refine-shard-key-index-type.rst
@@ -0,0 +1,6 @@
+.. warning::
+
+   Do not modify the range or hashed type for any of the current shard
+   key fields. It causes data inconsistencies. For example, do not
+   modify a shard key from ``{ customer_id: 1 }`` to ``{ customer_id:
+   "hashed", order_id: 1 }``.
diff --git a/source/reference/command/refineCollectionShardKey.txt b/source/reference/command/refineCollectionShardKey.txt
@@ -189,6 +189,8 @@ Index Considerations
       of the indexes whose fields support the shard key pattern must
       have the simple collation.
 
+.. include:: /includes/refine-shard-key-index-type.rst
+
 Examples
 --------
 
