sh.enableSharding()（mongoshメソッド）

定義

sh.enableSharding(database, primaryShard): 注意
バージョン6.0で変更。
MongoDB 6.0 以降では、コレクションをシャードするためにこのメソッドは必須ではありません。
データベースを明示的に作成します。mongosh sh.shardCollection()メソッドmongosh を使用して、データベース上のコレクションをシャーディングします。sh.enableSharding() メソッドはenableSharding コマンドをラップします。
重要
mongosh メソッド
このページではメソッドについて説明します。ただし、データベースコマンドやNode.jsなどの言語固有のドライバーのドキュメントには該当しませんmongosh 。
データベースコマンドについては、enableSharding コマンドを参照してください。
MongoDB API ドライバーについては、各言語の「MongoDB ドライバーのドキュメント」を参照してください。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです

重要

このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、サポートされていないコマンドを参照してください。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

構文

sh.enableSharding()の形式は次のとおりです。

sh.enableSharding(
   <database>,
   <primary shard>  // Optional.
)

Parameter

sh.enableSharding()メソッドでは、次のパラメーターが使われます。

Parameter	タイプ	説明
database	文字列	作成するデータベースの名前。
プライマリシャード	文字列	任意。データベースのプライマリシャード。これは、データベース内のすべてのシャーディングされていないコレクションのデフォルトのシャードです。警告:一般に、プライマリシャードは指定しないでください。クラスターで代わりにプライマリシャードを選択できるようにします。

動作

書込み保証 (write concern)

mongosは"majority" enableShardingコマンドとそのヘルパーsh.enableSharding() にを使用します。

プライマリシャード

一般に、コマンドでプライマリシャードを指定する必要はありません。代わりに、バランサーでプライマリシャードを選択できるようにします。

ただし、データベースにプライマリシャードを指定し、かつデータベースが別のプライマリシャードでシャーディングがすでに有効になっている場合は、操作はエラーを返し、データベースのプライマリシャードは以前のままになります。データベースのプライマリシャードを変更するには、代わりにmovePrimary コマンドを使用します。