DOCS-15590 refineshardkey updates (#1746)

jason-price-mongodb · jason-price-mongodb · web-flow · commit ed524f07779a · 2022-09-02T10:32:26.000-07:00
* DOCS-15590-refineshardkey-updates

* DOCS-15590-refineshardkey-updates

* DOCS-15590-refineshardkey-updates

Co-authored-by: jason-price-mongodb &lt;jshfjghsdfgjsdjh@aolsdjfhkjsdhfkjsdf.com&gt;
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
@@ -183,6 +183,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
 --------
 
