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

定義

sh.removeShardFromZone(shard, zone)

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

重要

mongosh メソッド

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

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

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

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

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

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

互換性

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

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

重要

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

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

動作

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

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

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

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

バランサー

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

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

セキュリティ

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

次の特権を持つユーザー:
- データベース内の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