Azure DocumentDB は、シームレスな スケーラビリティ と リージョン内高可用性 (HA) を提供します。 このドキュメントは、クラスターをスケーリングおよび構成する方法を学習する開発者向けのクイック ガイドとして機能します。
[前提条件]
Azure サブスクリプション
- Azure サブスクリプションがない場合は、無料アカウントを作成してください。
Azure Cloud Shell で Bash 環境を使用します。 詳細については、「Get started with Azure Cloud Shell」を参照してください。
CLI 参照コマンドをローカルで実行する場合は、Azure CLIinstallします。 Windowsまたは macOS で実行している場合は、Docker コンテナーでAzure CLIを実行することを検討してください。 詳細については、「 Docker コンテナーでAzure CLIを実行する方法を参照してください。
ローカル インストールを使用している場合は、az login コマンドを使用してAzure CLIにサインインします。 認証プロセスを完了するには、ターミナルに表示される手順に従います。 その他のサインイン オプションについては、「Azure CLI を使用して Azure に認証する方法」を参照してください。
メッセージが表示されたら、最初に使用するときにAzure CLI拡張機能をインストールします。 拡張機能の詳細については、「Azure CLIを参照してください。
az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。
クラスター コンピューティングのスケーリング
クラスター レベルでは、クラスターの物理シャード上の仮想コア数と RAM 容量を設定できます。 クラスター レベルは、中断することなく、いつでもニーズに合わせて変更できます。 たとえば、M50 から M60 に増やしたり、M50 から M40 に減らしたりすることができます。
クラスター サイド バーの [設定]で、[スケール] を選択します。
クラスター レベルを変更するには、ドロップダウン メニューから新しいレベルを選択します。
![クラスターの [スケール] ページでクラスター コンピューティング レベルを変更し、変更を保存する方法のスクリーンショット。](media/how-to-scale-cluster/configure-tier.png)
[保存] を選択してご自身の変更を保存します。
クラスター コンピューティング レベルをスケールアップまたはスケールダウンするには、update プロパティの MXXX 値を変更して、compute.tier 操作で既存のクラスターを更新します。
az resource update \
--resource-type "Microsoft.DocumentDB/mongoClusters" \
--name "<cluster-name>" \
--resource-group "<resource-group>" \
--set properties.compute.tier="<compute-tier>"
Azure REST API を直接使用することも、Azure CLI環境から az rest にラップすることもできます。
クラスターのコンピューティング レベルを変更するには、次のコマンドを使用します。
az rest \
--method "PATCH" \
--url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
--body "{\"location\":\"<cluster-region>\",\"properties\":{\"compute\":{\"tier\":\"<compute-tier>\"}}}"
ヒント
Azure Cloud Shellを使用している場合は、ファイルをシェルに直接アップロードまたはダウンロードできます。 詳細については、Azure Cloud Shellの管理されたファイルに関するページを参照してください。
注
通常のコンピューティング レベルから バースト可能なレベル へのダウングレードはサポートされていません。
ストレージ サイズを増やします。
ストレージ サイズの容量を増やして、データベースの容量を増やすことができます。 たとえば、ストレージを 128 GiB から 256 GiB に増やすことができます。
ストレージ サイズを大きくするには、ドロップダウン メニューから新しいサイズを選択します。
![クラスターの [スケール] ページの [物理シャードあたりのストレージ] オプションのスクリーンショット。](media/how-to-scale-cluster/configure-storage.png)
[保存] を選択してご自身の変更を保存します。
クラスターのストレージ サイズを増やすには、update プロパティの値を大きくして、既存のクラスターを storage.sizeGb 操作で更新します。
az resource update \
--resource-type "Microsoft.DocumentDB/mongoClusters" \
--name "<cluster-name>" \
--resource-group "<resource-group>" \
--set properties.storage.sizeGb="<new-size-in-GiB>"
Azure REST API を直接使用することも、Azure CLI環境から az rest にラップすることもできます。
クラスターのコンピューティング レベルを変更するには、次のコマンドを使用します。
az rest \
--method "PATCH" \
--url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
--body "{\"location\":\"<cluster-region>\",\"properties\":{\"storage\":{\"sizeGb\":\"<new-size-in-GiB>\"}}}"
ヒント
Azure Cloud Shellを使用している場合は、ファイルをシェルに直接アップロードまたはダウンロードできます。 詳細については、Azure Cloud Shellの管理されたファイルに関するページを参照してください。
Important
ストレージ サイズは増やすことはできますが、減らすことはできません。
高可用性を有効または無効にする
ニーズに合わせて リージョン内高可用性 (HA) を有効または無効にすることができます。 リージョン内 HA では、クラスター内のすべてのプライマリ シャードのレプリカ シャードを維持することで、データベースのダウンタイムを回避できます。 プライマリ シャードがダウンした場合、受信接続はそのレプリカ シャードに自動的にリダイレクトされ、ダウンタイムが最小限に抑えられます。
リージョン内 HA を有効または無効にするには、チェックボックス オプションを切り替えます。
![クラスターの [スケール] ページの [リージョン内の高可用性] チェック ボックスのスクリーンショット。](media/how-to-scale-cluster/configure-high-availability.png)
[保存] を選択してご自身の変更を保存します。
クラスターでリージョン内の高可用性を "有効にする" には、 プロパティの値を update に設定して、highAvailability.targetMode 操作で既存のクラスターを更新します。ZoneRedundantPreferred
az resource update \
--resource-type "Microsoft.DocumentDB/mongoClusters" \
--name "<cluster-name>" \
--resource-group "<resource-group>" \
--set properties.highAvailability.targetMode="ZoneRedundantPreferred"
クラスターでリージョン内の高可用性を "無効にする" には、 プロパティの値を update に設定して、highAvailability.targetMode 操作で既存のクラスターを更新します。Disabled
az resource update \
--resource-type "Microsoft.DocumentDB/mongoClusters" \
--name "<cluster-name>" \
--resource-group "<resource-group>" \
--set properties.highAvailability.targetMode="Disabled"
Azure REST API を直接使用することも、Azure CLI環境から az rest にラップすることもできます。
クラスターでリージョン内の高可用性を "有効にする" には、次のコマンドを使用します。
az rest \
--method "PATCH" \
--url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
--body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"ZoneRedundantPreferred\"}}}"
クラスターでリージョン内の高可用性を "無効にする" には、次のコマンドを使用します。
az rest \
--method "PATCH" \
--url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
--body "{\"location\":\"<cluster-region>\",\"properties\":{\"highAvailability\":{\"targetMode\":\"Disabled\"}}}"
物理シャードの数を増やす
データベースが 1 つの物理シャード クラスターの容量を超える場合は、 ストレージ サイズ を増やすか、 物理シャードを追加することができます。 新しい物理シャードがクラスターに追加されたら、クラスターの再調整操作を実行してシャード全体にデータを再分散する必要があります。 クラスター内の各物理シャードは、常に同じ コンピューティング 構成と ストレージ 構成を持ちます。
物理シャードを追加するには、一覧から新しいシャード数を選択します。
![クラスターの [スケール] ページの物理シャード数ドロップダウン リストのスクリーンショット。](media/how-to-scale-cluster/configure-add-shards.png)
[保存] を選択してご自身の変更を保存します。
変更を保持するには、ポップアップ ウィンドウで [続行] を選択します。
クラスターに物理シャードを追加するには、update プロパティの値を 1 つ増やす sharding.shardCount 操作で既存のクラスターを更新します。
az resource update \
--resource-type "Microsoft.DocumentDB/mongoClusters" \
--name "<cluster-name>" \
--resource-group "<resource-group>" \
--set properties.sharding.shardCount="<current-shard-count-plus-one>"
注
一度に追加できる物理シャードは 1 つだけです。 クラスターに複数の物理シャードを追加する必要がある場合は、順番に行う必要があります。
Azure REST API を直接使用することも、Azure CLI環境から az rest にラップすることもできます。
次のコマンドを使用して、クラスターに物理シャードを追加します。
az rest \
--method "PATCH" \
--url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>?api-version=2025-09-01" \
--body "{\"location\":\"<cluster-region>\",\"properties\":{\"sharding\":{\"shardCount\":\"<current-shard-count-plus-one>\"}}}"
注
一度に追加できる物理シャードは 1 つだけです。 クラスターに複数の物理シャードを追加する必要がある場合は、順番に行う必要があります。
ヒント
クラスターに 10 個を超える物理シャードが必要な場合は、サポート チケットを開きます。
データの再調整
物理シャードがクラスターに追加された後、またはマルチハード クラスターが物理シャード全体で不均一なストレージ使用量を持つ場合、データの再調整により、ダウンタイムなしでシャード間でデータが再分散されます。
プレビューでは、クラスターでデータの再調整を有効にする必要があります。
- Azure ポータルで、クラスターのプロパティを開きます。
-
[機能] ページの [設定] で、[マルチハード クラスターの再調整] を選択します。
-
[マルチハード クラスターの再調整] パネルで、[有効] を選択します。
データの再調整を開始するには、 Mongo シェルなどの管理ツールを使用してクラスターに接続します。
sh.startBalancer() コマンドを使用して再調整を開始します。
sh.isBalancerRunning()を使用して再調整の状態を確認します。
sh.stopBalancer() コマンドを使用して再調整を停止します。
注
再調整プロセスの期間は、物理シャード間で移動されるデータの量によって異なります。 操作はオンラインで実行され、クラスターの可用性や機能には影響しません。
次のステップ
このガイドでは、Azure ポータルでの Azure DocumentDB クラスターのスケーリングと構成は簡単なプロセスであることを示しました。 Azure ポータルには、クラスター層の調整、ストレージ サイズの増加、高可用性の有効化または無効化、ダウンタイムなしで物理シャードの追加を行う機能が含まれています。
![クラスターの [スケール] ページでクラスター コンピューティング レベルを変更し、変更を保存する方法のスクリーンショット。](media/how-to-scale-cluster/configure-tier.png#lightbox)
![クラスターの [スケール] ページの [物理シャードあたりのストレージ] オプションのスクリーンショット。](media/how-to-scale-cluster/configure-storage.png#lightbox)
![クラスターの [スケール] ページの [リージョン内の高可用性] チェック ボックスのスクリーンショット。](media/how-to-scale-cluster/configure-high-availability.png#lightbox)
![クラスターの [スケール] ページの物理シャード数ドロップダウン リストのスクリーンショット。](media/how-to-scale-cluster/configure-add-shards.png#lightbox)