Azure DocumentDB クラスターのスケーリングと構成

Azure DocumentDB は、シームレスなスケーラビリティとリージョン内高可用性 (HA) を提供します。このドキュメントは、クラスターをスケーリングおよび構成する方法を学習する開発者向けのクイックガイドとして機能します。

[前提条件]

Azure サブスクリプション
- Azure サブスクリプションをお持ちでない場合は、無料アカウントを作成してください

既存の Azure DocumentDB クラスター
- クラスターがない場合は、新しいクラスターを作成します

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の概要」を参照してください。
CLI 参照コマンドをローカルで実行する場合は、Azure CLI をインストールします。 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 に減らしたりすることができます。

クラスターサイドバーの [設定]で、[スケール] を選択します。
クラスターレベルを変更するには、ドロップダウンメニューから新しいレベルを選択します。
[保存] を選択してご自身の変更を保存します。

クラスターコンピューティングレベルをスケールアップまたはスケールダウンするには、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 に増やすことができます。

ストレージサイズを大きくするには、ドロップダウンメニューから新しいサイズを選択します。
[保存] を選択してご自身の変更を保存します。

クラスターのストレージサイズを増やすには、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 を有効または無効にするには、チェックボックスオプションを切り替えます。
[保存] を選択してご自身の変更を保存します。

クラスターでリージョン内の高可用性を "有効にする" には、プロパティの値を 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 つの物理シャードクラスターの容量を超える場合は、ストレージサイズを増やすか、物理シャードを追加することができます。新しい物理シャードがクラスターに追加されたら、クラスターの再調整操作を実行してシャード全体にデータを再分散する必要があります。クラスター内の各物理シャードは、常に同じコンピューティング構成とストレージ構成を持ちます。

物理シャードを追加するには、一覧から新しいシャード数を選択します。
[保存] を選択してご自身の変更を保存します。
変更を保持するには、ポップアップウィンドウで [続行] を選択します。

クラスターに物理シャードを追加するには、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 portal で、クラスターのプロパティを開きます。
[機能] ページの [設定] で、[マルチハードクラスターの再調整] を選択します。
[マルチハードクラスターの再調整] パネルで、[有効] を選択します。

データの再調整を開始するには、 Mongo シェルなどの管理ツールを使用してクラスターに接続します。

sh.startBalancer() コマンドを使用して再調整を開始します。
sh.isBalancerRunning()を使用して再調整の状態を確認します。
sh.stopBalancer() コマンドを使用して再調整を停止します。

注

再調整プロセスの期間は、物理シャード間で移動されるデータの量によって異なります。操作はオンラインで実行され、クラスターの可用性や機能には影響しません。

次のステップ

このガイドでは、Azure portal での Azure DocumentDB クラスターのスケーリングと構成は簡単なプロセスであることを示しました。 Azure portal には、クラスター層の調整、ストレージサイズの増加、高可用性の有効化または無効化、ダウンタイムなしで物理シャードの追加を行う機能が含まれています。

Azure DocumentDB クラスターを復元する

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-11-19

次の方法で共有

Azure DocumentDB クラスターのスケーリングと構成

[前提条件]

クラスター コンピューティングのスケーリング

ストレージ サイズを増やします。

高可用性を有効または無効にする

物理シャードの数を増やす

データの再調整

次のステップ

フィードバック

その他のリソース

クラスターコンピューティングのスケーリング

ストレージサイズを増やします。