Azure Cosmos DB for MongoDB アカウントの API バージョンをアップグレードする

適用対象: MongoDB

この記事では、Azure Cosmos DB の MongoDB 用 API アカウントの API バージョンをアップグレードする方法について説明します。 アップグレード後、Azure Cosmos DB の MongoDB 用 API に含まれる最新機能を使用できます。 アップグレード プロセスによって、アカウントの可用性が中断されることはなく、どの時点においても、RU/秒が消費されたりデータベースの容量が減少したりすることはありません。 既存のデータまたはインデックスには、このプロセスの影響はありません。

新しい API バージョンにアップグレードする場合は、運用環境のワークロードをアップグレードする前に、開発 (またはテスト) ワークロードから始めます。 Azure Cosmos DB for MongoDB アカウントをアップグレードする前に、アップグレード後の API バージョンと互換性のあるバージョンにクライアントをアップグレードしておくことが大切です。

Note

現時点では、サーバー バージョン 3.2 を使用している条件を満たすアカウントのみをバージョン 3.6 以降にアップグレードできます。 アカウントにアップグレード オプションが表示されない場合は、サポート チケットをご提出ください

4.2、4.0、または 3.6 にアップグレードする

バージョン 4.2 にアップグレードする利点:

  • $merge、三角関数、算術式のサポートなど、集計パイプラインに対するいくつかの大きな改良。
  • クライアント側フィールド暗号化のサポート。これにより、個々のフィールドを選択的に暗号化し、暗号化されたデータのプライバシーをデータベース ユーザーやホスティング プロバイダーから守ることで、データベースをさらにセキュリティ保護できます。

バージョン 4.0 にアップグレードする利点

バージョン 4.0 には、次の新機能があります。

  • シャード化されていないコレクション内の複数ドキュメント トランザクションのサポート。
  • 新しい集計演算子
  • スキャン パフォーマンスの向上
  • ストレージの高速化と効率化

バージョン 3.6 にアップグレードする利点

バージョン 3.6 には、次の新機能があります。

  • 強化されたパフォーマンスと安定性
  • 新しいデータベース コマンドのサポート
  • 既定の集計ステージと新しい集計ステージによる集計パイプラインのサポート
  • Change Stream のサポート
  • 複合インデックスのサポート
  • 次の操作のためのクロスパーティションのサポート: 更新、削除、カウント、並べ替え
  • 次の集計操作のパフォーマンスの向上: $count、$skip、$limit、$group
  • ワイルドカードのインデックス作成がサポートされるようになりました

バージョン 3.2 からの変更点

  • SSR (Server Side Retry) 機能が既定で有効になっているため、クライアント アプリケーションからの要求で 16500 エラーが返されることはありません。 要求が完了するか 60 秒のタイムアウトに達するまで、要求が再開されます。
  • 要求ごとのタイムアウトは 60 秒に設定されています。
  • 新しいワイヤ プロトコル バージョンで作成された MongoDB コレクションによって、既定でインデックスが作成されるのは _id プロパティのみです。

3\.2 からアップグレードする際に必要な対応

3\.2 からアップグレードすると、データベース アカウントのエンドポイントのサフィックスが次の形式に更新されます。

<your_database_account_name>.mongo.cosmos.azure.com

バージョン 3.2 からアップグレードする場合は、このデータベース アカウントで接続するアプリケーションとドライバーの既存のエンドポイントを置き換える必要があります。 新しいエンドポイントを使用している接続のみが、新しい API バージョンの機能にアクセスできます。 以前の 3.2 エンドポイントには .documents.azure.com というサフィックスが付いているはずです。

3\.2 から新しいバージョンにアップグレードする場合、複数のフィールドを並べ替え、これらのクエリの安定した高パフォーマンスを実現するために複合インデックスが必要になりました。 複数フィールドの並べ替えを成功させるため、このような複合インデックスを作成するようにします。

Note

このエンドポイントは、お使いのアカウントがソブリン、政府、または制限された Azure クラウドに作成されたときは少し異なる場合があります。

アップグレードする方法

  1. Azure portal にサインインします。

  2. Azure Cosmos DB for MongoDB アカウントに移動します。 [概要] ウィンドウを開き、現在のサーバーのバージョンが 3.2 または 3.6 であることを確認します。

    Azure portal から MongoDB アカウントの現在のバージョンを確認します。

  3. 左側のメニューから、Features ウィンドウを開きます。 このウィンドウに、データベース アカウントで使用できるアカウント レベルの機能が表示されます。

  4. Upgrade MongoDB server version 行を選択します。 このオプションが表示されない場合は、アカウントがこのアップグレードに適合していない可能性があります。 これに該当する場合は、サポート チケットをご提出ください。

    [機能] ブレードを開き、アカウントをアップグレードします。

  5. アップグレードについて表示されている情報を確認します。 Set server version to 4.2 (または現在のバージョンに応じて 4.0 または 3.6) を選びます。

    アップグレードのガイダンスを確認し、アップグレードを選択します。

  6. アップグレードを開始すると、 [機能] メニューがグレー表示になり、状態が [保留中] に設定されます。 アップグレードは、完了するまで約 15 分かかります。 このプロセスは、データベース アカウントの既存の機能や操作には影響しません。 完了すると、 [MongoDB サーバー バージョンの更新] の [状態] にアップグレードされたバージョンが表示されます。 要求の処理中に問題が発生した場合は、サポートにお問い合わせください

  7. アカウントをアップグレードした後の考慮事項を次に示します。

    1. 3\.2 からアップグレードする場合は、 [概要] ウィンドウに戻り、アプリケーションで使用する新しい接続文字列をコピーします。 3\.2 を実行している古い接続文字列は中断されません。 一貫性のあるエクスペリエンスを確保するには、すべてのアプリケーションで新しいエンドポイントを使用する必要があります。

    2. 3.6 からアップグレードした場合、既存の接続文字列は、指定されたバージョンにアップグレードされて引き続き使用されます。

ダウングレードする方法

「アップグレードする方法」セクションと同じ手順で、アカウントを 4.0 または 3.6 にダウングレードすることもできます。

3.2 からアップグレードした後で 3.2 にダウングレードしたい場合は、アップグレード後もバージョン 3.2. を実行しているアクティブなホスト accountname.documents.azure.com で、以前 (3.2) の接続文字列に戻すだけでかまいません。

次のステップ