Azure Cosmos DB でのパーティションキーの変更 (プレビュー)

適用対象: NoSQL

データベース管理の領域では、アプリケーションの進化に伴ってコンテナーに対して最初に選択されたパーティションキーが不十分になることは珍しくありません。パフォーマンスが最適でない場合や、コンテナーのコストが増加する可能性があります。このような状況の原因には、次のような要因があります:

これらの問題に対処するために、Azure Cosmos DB には、Azure portal を使用してパーティションキーをシームレスに変更する機能が用意されています。

作業の開始

Azure portal を使用して NoSQL API 用 Azure Cosmos DB のコンテナーのパーティションキーを変更するには、次の手順に従います:

Azure Cosmos DB アカウントの Data Explorer の [パーティションキーの変更] 機能のスクリーンショット。

パーティションキーを変更するには、新しいコピー先コンテナーを作成するか、同じデータベース内の既存のコピー先コンテナーを選択する必要があります。

パーティションキーの変更中に Azure portal を使用して新しいコンテナーを作成する場合、パーティションキーと一意キーを除くすべての構成がコピー先コンテナーにレプリケートされます。

Azure Cosmos DB アカウントでパーティションキーを変更する際の [コピー先コンテナーの作成または選択] 画面のスクリーンショット。

次に、アカウント内コンテナーコピージョブを使用して、オフラインでソースコンテナーからコピー先コンテナーにデータがコピーされます。

Note

データの整合性を維持するために、コピープロセス全体の間、コンテナーのパーティションキーの変更に進む前に、ソースコンテナーのすべての更新を停止することをお勧めします。

コピーが完了したら、目的のパーティションキーを使用して新しいコンテナーの使用を開始し、必要に応じて古いコンテナーを削除できます。

既定では、4 つの vCPU と 16 GB のメモリを持つ 2 つのサーバー側コンピューティングインスタンスが、アカウントごとにデータコピージョブを処理するように割り当てられます。コピージョブのパフォーマンスは、さまざまな要因に依存します。より高い SKU サーバー側コンピューティングインスタンスを割り当てるには、Microsoft サポートにお問い合わせください。
パーティションキーの変更は、1,000,000 RU/秒未満で、4 TB 未満のデータを含むコンテナーでサポートされています。 1,000,000 を超えるプロビジョニング済みスループットまたは 4 TB を超えるデータを含むコンテナーについては、パーティションキーの変更に関するサポートを Microsoft サポートにお問い合わせください。
パーティションキーの変更は、次の機能を持つアカウントではサポートされていません。
- ローカル認証の無効化
- パーティションのマージ
この機能は現在、ドキュメントされているリージョンでのみサポートされています。