Docs Menu
Docs Home
/
MongoDBマニュアル
/
参照
/
mongosh メソッド
/
シャーディング

sh.enableSharding()

項目一覧

  • 定義
  • 構文
  • 動作
  • 例

定義

sh.enableSharding(database, primaryShard)

指定されたデータベースのシャーディングを有効にします。 データベースのシャーディングを有効にすると、 sh.shardCollection()を使用してそのデータベース内のコレクションをシャーディングできます。 mongoshメソッドsh.enableSharding()はenableShardingコマンドをラップします。

重要

mongosh メソッド

このページでは、mongosh メソッドについて記載しています。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。

データベースコマンドについては、enableSharding コマンドを参照してください。

MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。

構文

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

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

Parameter

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

Parameter
タイプ
説明
文字列

シャーディングを有効にするデータベース。

文字列

任意。 データベースのプライマリシャード。プライマリシャードには、このデータベースのシャーディングされていないコレクションが含まれています。 一般に、プライマリ シャードを明示的に指定するのではなく、バランサーによってプライマリ シャードが選択されるようにすることをお勧めします。

警告

Tip

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

動作

書込み保証 (write concern)

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

プライマリシャード

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

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

例

次の例では、 mongosから実行すると、 testデータベースのシャーディングが有効になります。

sh.enableSharding("test")

確認するには、 sh.status()を実行します。

Tip

以下も参照してください。

戻る

sh.enableAutoSplit

次へ

sh.getBalancerState