/ /

/ /

deleteShardFromZone （データベースコマンド）

定義

removeShardFromZone: removeShardFromZone管理コマンドは、シャードとゾーンの間の関連付けを削除します。
Tip
mongoshでは、このコマンドはsh.removeShardFromZone()ヘルパーメソッドを通じて実行することもできます。
ヘルパーメソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、データベースコマンドを使用します。

互換性

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

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

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

構文

データベースではmongos removeShardFromZoneインスタンスからのみadmin を実行できます。

このコマンドの構文は、次のとおりです。

db.adminCommand(
   {
     removeShardFromZone: <string>,
     zone: <string>
   }
)

コマンドフィールド

このコマンドは、次のフィールドを使用します。

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

mongoshはヘルパーメソッドsh.removeShardFromZone()を提供します。

動作

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

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

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

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

セキュリティ

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

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

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

例

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

db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )

戻る

deleteShard

reshardCollection

定義

Tip

互換性

構文

コマンドフィールド

動作

セキュリティ

例