DOCSP-40130 - Note on Sharded Partitioner (#201)

Co-authored-by: Nora Reidy <[email protected]>
(cherry picked from commit e25e13f)

Author: mongoKart

source/batch-mode/batch-read-config.txt

@@ -10,6 +10,13 @@ Batch Read Configuration Options
    :depth: 1
    :class: singlecol
 
+.. facet::
+   :name: genre
+   :values: reference
+    
+.. meta::
+   :keywords: partitioner, customize, settings 
+
 .. _spark-batch-input-conf:
 
 Overview
@@ -212,9 +219,12 @@ based on your shard configuration.
 To use this configuration, set the ``partitioner`` configuration option to
 ``com.mongodb.spark.sql.connector.read.partitioner.ShardedPartitioner``.
 
-.. warning::
-
-   This partitioner is not compatible with hashed shard keys.
+.. important:: ShardedPartitioner Restrictions
+   
+   1. In MongoDB Server v6.0 and later, the sharding operation creates one large initial
+      chunk to cover all shard key values, making the sharded partitioner inefficient.
+      We do not recommend using the sharded partitioner when connected to MongoDB v6.0 and later.
+   2. The sharded partitioner is not compatible with hashed shard keys.
 
 .. _conf-mongopaginatebysizepartitioner:
 .. _conf-paginatebysizepartitioner: