unshardコレクション

定義

unshardCollection

既存のシャーディングされたコレクションのシャーディングを解除し、コレクションデータを単一のシャードに移動します。コレクションをシャーディング解除すると、コレクションを複数のシャードに分割できなくなり、シャードキーが削除されます。

バージョン8.0の新機能。

Tip

mongoshでは、このコマンドはsh.unshardCollection()を通じて実行することもできます。

ヘルパー メソッドはmongoshユーザーには便利ですが、データベースコマンドと同じレベルの情報は返されない可能性があります。 便宜上必要ない場合、または追加の戻りフィールドが必要な場合は、 データベースコマンドを使用します。

このコマンドはadminデータベースで実行する必要があります。

コレクションにゾーン構成が適用されている場合は、コレクションのシャーディングを解除する 前に、まずゾーンから範囲の関連付けとシャードを削除する必要があります。詳細については、「 シャーディングされていないゾーン 」を参照してください。

注意

コレクションのシャーディングを解除するには 書き込み集中型の操作であり、 oplogの増加率が増加する可能性があります。 これを軽減するには、次の構成変更を検討してください。

• oplogの無制限の増加を防ぐには、固定のoplogサイズを設定します。

• セカンダリが古くなる可能性を減らすには、 oplogサイズを増やします。

詳しくは、レプリカセットのoplogを参照してください。

互換性

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

• MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

• MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

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

制限事項

次の場合は、 unshardCollectionは使用できません。

• 時系列コレクション。

• Queryable Encryptionコレクション。

構文

db.adminCommand( {
   unshardCollection: "<database>.<collection>",
   toShard: "<shard-id>"
} )

コマンドフィールド

Considerations

• unshardCollectionはシャーディングされたクラスターでのみ実行できます。

• unshardCollectionは、シャーディングされたコレクションでのみ動作できます。

• unshardCollectionは一度に 1 つのコレクションに対してのみ操作できます。

• unshardCollectionの最小表示時間は5分です。

• Atlas Search インデックスは、 unshardCollectionの実行後に 再構築する必要があります 。

• unshardCollectionが完了するまで、シャードの追加や削除、埋め込みコンフィギュレーションサーバーと専用コンフィギュレーションサーバーの間の移行などのトポロジー変更を行うことはできません。

• unshardCollectionの進行中にシャーディングされていないコレクションに対して次の操作を実行することはできません。

  • collMod

  • convertToCapped

  • createIndexes

  • db.collection.createIndexes()

  • drop

  • db.collection.drop()

  • dropIndexes

  • db.collection.dropIndex()

  • renameCollection

  • db.collection.renameCollection()

• unshardCollectionの進行中は、クラスターで次の操作を実行できません。

  • addShard

  • removeShard

  • db.createCollection()

  • dropDatabase

  • transitionToDedicatedConfigServer

  • transitionFromDedicatedConfigServer

• unshardCollectionの進行中に発生するインデックスビルドは、メッセージが表示されずに失敗する可能性があります。

  • unshardCollectionの進行中は、インデックスを作成しないでください。

  • インデックスビルドが進行中の場合は、 unshardCollectionを呼び出しないでください。

要件

コレクションのシャーディングを解除する 前に、以下の要件を満たしていることを確認してください。

• アプリケーションは、影響を受けるコレクションが書込みをブロックする期間を2 秒許容できます。 書込み (write) がブロックされている期間中、アプリケーションのレイテンシが増加します。

• データベースが次のリソース要件を満たしている。

  • コレクションを移動するシャードに、コレクションとそのインデックス用の十分なストレージ領域があることを確認します。 宛先シャードでは少なくとも( Collection storage size + Index Size ) * 2バイトが使用可能である必要があります。

  • I/Oキャパシティーが50 % 未満であることを確認します。

  • CPU 負荷が80 % 未満であることを確認します。

動作

例

db.adminCommand( {
    unshardCollection: "sales.eu_accounts"
} )

db.adminCommand( {
    unshardCollection: "sales.eu_accounts",
    toShard: "shard1"
} )

db.adminCommand( { balancerStop: 1 } )

sh.status()

db.adminCommand( {
   updateZoneKeyRange: "app.inventory",
   min: 100,
   max: 500,
   zone: null
} )

db.adminCommand( {
   removeShardFromZone: "shard01",
   zone: "us"
} )

db.adminCommand( { balancerStart: 1 } )

db.adminCommand( { unshardCollection: "app.inventory" } )

詳細

• sh.unshardCollection()

• コレクションのシャーディング解除