Docs Menu
Docs Home
/
MongoDB マニュアル
/
参照
/
データベース コマンド
/
シャーディング

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>
   }
)

コマンドフィールド

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

フィールド
タイプ
説明
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