定義
removeShardFromZoneremoveShardFromZone管理コマンドは、シャードとゾーンの間の関連付けを削除します。Tip
mongoshでは、このコマンドはsh.removeShardFromZone()ヘルパーメソッドを通じて実行することもできます。ヘルパー メソッドは
mongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、データベースコマンド を使用します。
互換性
このコマンドは、次の環境でホストされている配置で使用できます。
- MongoDB Atlas はクラウドでの MongoDB 配置のための完全管理サービスです
MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン
構文
データベースではmongos removeShardFromZoneインスタンスからのみadmin を実行できます。
このコマンドの構文は、次のとおりです。
db.adminCommand( { removeShardFromZone: <string>, zone: <string> } )
コマンドフィールド
このコマンドは、次のフィールドを使用します。
フィールド | タイプ | 説明 |
|---|---|---|
string | ||
string |
動作
removeShardFromZone は、ゾーンに関連付けられた範囲を削除しません。
クラスターからゾーンを完全に削除するには、ゾーンに関連付けられている各シャードでremoveShardFromZone を実行する必要があります。
指定されたシャードがゾーンに関連付けられた最後のシャードである場合は、ゾーンに関連付けられているシャードキー範囲が残りないことを確認する必要があります。updateZoneKeyRange を実行中前に、ゾーンに関連付けられている既存の範囲を削除するには、removeShardFromZone を使用します。
シャーディングされたクラスター内のゾーンの詳細については、ゾーンのマニュアル ページを参照してください。
セキュリティ
アクセス制御を強制するシャーディングされたクラスターの場合は、次のいずれかとして認証する必要があります。
クラスター リソースで
enableShardingを含む 権限 を持つユーザー。
clusterAdminまたはclusterManager の組み込みロールには、removeShardFromZone を発行するための適切な権限があります。詳細については、 ロールベースのアクセス制御 のマニュアル ページを参照してください。
例
次の例では、 shard0000とゾーンNYCの間の関連付けを削除します。
db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )