sh.removeShardFromZone()

項目一覧

定義

動作
例

定義

sh.removeShardFromZone(shard, zone)

バージョン 3.4 で追加。

ゾーンとシャードの間の関連付けを削除します。

重要

mongosh メソッド

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

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

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

このメソッドには次のパラメーターがあります。

Parameter	タイプ	説明
シャード	string	ゾーン関連付けを削除するシャードの名前。
ゾーン	string	シャードとの関連付けを削除するゾーンの名前。

sh.removeShardFromZone()インスタンスに接続されている場合にのみmongos を発行します。

動作

sh.removeShardFromZone() は、ゾーンに関連付けられた範囲を削除しません。

クラスターからゾーンを完全に削除するには、ゾーンに関連付けられている各シャードでsh.removeShardFromZone()を実行する必要があります。

指定されたシャードがゾーンに関連付けられた最後のシャードである場合は、ゾーンに関連付けられている残りの範囲がないことを確認する必要があります。 sh.removeShardFromZone() を実行する前に、ゾーンに関連付けられている既存の範囲を削除するには、 updateZoneKeyRangeを使用し。

シャーディングされたクラスター内のゾーンの詳細については、ゾーンのマニュアルページを参照してください。

バランサー

ゾーンとシャードの間の関連付けを削除すると、シャード上のゾーンによってカバーされるチャンクを維持する制約が削除されます。次のバランサーラウンド中に、バランサーは以前にゾーンによってカバーされていたチャンクを移行する場合があります。

シャーディングされたクラスターで移行がどのように機能するかについて詳しくは、シャーディングされたクラスターバランサーのマニュアルページを参照してください。

セキュリティ

アクセス制御を強制するシャーディングされたクラスターの場合は、次のいずれかとして認証する必要があります。

次の特権を持つユーザー:
- データベース内のupdate shardsコレクションにある { }、およびconfig
- findtagsデータベース内のconfig コレクションにある {
または、あるいは、
クラスターリソースで enableSharding を含む権限を持つユーザー。

clusterAdminまたはclusterManagerの組み込みロールには、 sh.removeShardFromZone()を発行するための適切な権限があります。詳細については、ロールベースのアクセス制御のマニュアルページを参照してください。

例

次の例では、 shard0000とNYCゾーン間の関連付けを削除します。

sh.removeShardFromZone("shard0000", "NYC")

Tip

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

sh.addShardToZone() sh.updateZoneKeyRange() sh.removeRangeFromZone()

戻る

sh.removeShardTag

sh.removeTagRange