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

sh.addShard()

項目一覧

  • 定義
  • 互換性
  • Considerations
  • 例

定義

sh.addShard(<url>)

シャード レプリカセット をのシャーディングされたクラスターに追加します。 このメソッドはmongosインスタンスで実行する必要があります。

重要

mongosh メソッド

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

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

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

sh.addShard()メソッドには次のパラメーターがあります。

Parameter
タイプ
説明
host
string

シャードのレプリカセットの少なくとも 1 つのノードのレプリカセット名、ホスト名、ポート。 追加のレプリカセット ノードのホスト名は、カンマで区切る必要があります。 例:

<replica_set>/<hostname><:port>,<hostname><:port>, ...

sh.addShard() メソッドのプロトタイプ形式は次のとおりです。

sh.addShard("<replica_set>/<hostname><:port>")

警告

コンフィギュレーションサーバーもlocalhostで実行されていない限り、ホスト名にlocalhostを使用しないでください。

mongos公式の .deb からインストールされたパッケージと.rpm パッケージであれば、 bind_ip構成がデフォルトで127.0.0.1に設定されています。

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

互換性

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

  • MongoDB Atlas はクラウドでの MongoDB 配置のためのフルマネージド サービスです

重要

このコマンドはサーバーレスインスタンスではサポートされていません。 詳細については、「サポートされていないコマンド 」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

Considerations

バランシング

シャーディングされたクラスターにシャードを追加すると、既存のすべてのシャーディングされたコレクションのクラスターのシャード間のチャンクのバランスに影響します。 バランサーはチャンクの移行を開始し、クラスターがバランスをとります。 詳細については、「バランサーの内部」を参照してください。

非表示メンバー

重要

に提供されるシードリストにsh.addShard() 非表示メンバー を含めることはできません。

DDL 操作

クラスターが DDL操作（ reshardCollectionなどのコレクションを変更する操作）を実行しているときにsh.addShardを実行すると、 sh.addShardは同時 DDL操作が完了した後にのみ実行されます。

例

シャードを追加するには、レプリカセットの名前と、レプリカセットの少なくとも 1 つのノードのホスト名をシードとして指定します。 追加のホスト名を指定する場合、すべてが同じレプリカセットのノードである必要があります。

次の例では、 repl0という名前のレプリカセットを追加し、レプリカセットの 1 つのノードを指定します。

sh.addShard("repl0/mongodb3.example.net:27327")

戻る

sh.abortUnshardCollection

次へ

sh.addShardTag