定義
sh.addShard(<url>)シャード レプリカセット をのシャーディングされたクラスターに追加します。 このメソッドは
mongosインスタンスで実行する必要があります。重要
mongosh メソッド
このページでは、
mongoshメソッドについて記載しています。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。データベースコマンドについては、
addShardコマンドを参照してください。MongoDB API ドライバーについては、各言語の MongoDB ドライバー ドキュメントを参照してください。
sh.addShard()メソッドには次のパラメーターがあります。Parameterタイプ説明hoststring
シャードのレプリカセットの少なくとも 1 つのノードのレプリカセット名、ホスト名、ポート。 追加のレプリカセット ノードのホスト名は、カンマで区切る必要があります。 例:
<replica_set>/<hostname><:port>,<hostname><:port>, ... sh.addShard()メソッドのプロトタイプ形式は次のとおりです。sh.addShard("<replica_set>/<hostname><:port>") 警告
コンフィギュレーションサーバーも
localhostで実行されていない限り、ホスト名にlocalhostを使用しないでください。公式の「DebianにMongoDB Community Edition をインストール 」および「
mongosRed Hat またはCentOSにMongoDB Community Edition をインストール 」パッケージからインストールされたbind_ip127.0.0.1は、 構成がデフォルトで に設定されています。mongos"majority"addShardsh.addShard()は、 コマンドとそのヘルパー に使用します。
互換性
このメソッドは、次の環境でホストされている配置で使用できます。
MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです
重要
このコマンドは、M0 および Flex クラスターではサポートされていません。詳細については、「 サポートされていないコマンド 」を参照してください。
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
Considerations
バランシング
シャーディングされたクラスターにシャードを追加すると、既存のすべてのシャーディングされたコレクションのクラスターのシャード間のチャンクのバランスに影響します。 バランサーはチャンクの移行を開始し、クラスターがバランスをとります。 詳細については、「バランサーの内部」を参照してください。
チャンクの移行はディスク容量に影響を与える可能性があり、ソースシャードは移行されたドキュメントをデフォルトで自動的にアーカイブします。 詳細については、 moveChunkディレクトリを参照してください。
非表示メンバー
重要
に提供されるシードリストにsh.addShard() 非表示メンバー を含めることはできません。
例
シャードを追加するには、レプリカセットの名前と、レプリカセットの少なくとも 1 つのノードのホスト名をシードとして指定します。 追加のホスト名を指定する場合、すべてが同じレプリカセットのノードである必要があります。
次の例では、 repl0という名前のレプリカセットを追加し、レプリカセットの 1 つのノードを指定します。
sh.addShard("repl0/mongodb3.example.net:27327")