次の方法で共有


Azure portal を使用して Azure Cosmos DB アカウントを管理する

適用対象: NoSQL MongoDB カサンドラ グレムリン

この記事では、Azure portal を使用して、Azure Cosmos DB アカウントでさまざまなタスクを管理する方法を紹介します。 Azure Cosmos DB は、Azure PowerShell、Azure CLI、AzureResource Manager テンプレートBicepTerraform など、他の Azure 管理クライアントでも管理できます。

ヒント

Azure Cosmos DB または コントロール プレーン 用の管理 API は、サービスの残りの部分のような高要求ボリューム用に設計されていません。 詳細については、「コントロール プレーン サービスの制限」を参照してください。

前提条件

なし

アカウントを作成する

次の手順のようにします。

  1. Azure portal のメニューまたは [ホーム] ページで、 [リソースの作成] を選択します。

  2. Azure Cosmos DB を検索します。 [作成]>[Azure Cosmos DB] を選択します。

  3. [Azure Cosmos DB アカウントの作成] ページで、 Azure Cosmos DB for NoSQL セクション内の [作成] オプションを選択します。

    Azure Cosmos DB には、いくつかの API が用意されています:

    • NoSQL (ドキュメント データ用)
    • PostgreSQLの
    • MongoDB (ドキュメント データ用)
    • Apache Cassandra
    • テーブル
    • Apache Gremlin (グラフ データ用)

    NoSQL 用 API の詳細については、「Azure Cosmos DB へようこそ」を参照してください。

  4. [Azure Cosmos DB アカウントの作成] ページで、新しい Azure Cosmos DB アカウントの基本的な設定を入力します。

    設定 説明
    サブスクリプション サブスクリプション名 この Azure Cosmos DB アカウントに使用する Azure サブスクリプションを選択します。
    リソースグループ リソース グループ名 リソース グループを選択するか、 [新規作成] を選択し、新しいリソース グループの一意の名前を入力します。
    アカウント名 一意の名前 自分の Azure Cosmos DB アカウントを識別するための名前を入力します。 指定した名前に documents.azure.com が付加されて URI が作成されるので、一意の名前を使用してください。 名前に含めることができるのは、英小文字、数字、ハイフン (-) のみです。 3 から 44 文字にする必要があります。
    場所 ユーザーに最も近いリージョン Azure Cosmos DB アカウントをホストする地理的な場所を選択します。 データに最も高速にアクセスできるよう、お客様のユーザーに最も近い場所を使用します。
    容量モード プロビジョニング スループットまたはサーバーレス プロビジョニング スループット モードでアカウントを作成するには、 [Provisioned throughput](プロビジョニング スループット) を選択します。 サーバーレス モードでアカウントを作成するには、 [サーバーレス] を選択します。
    Apply Azure Cosmos DB free tier discount (Azure Cosmos DB Free レベル割引を適用する) [適用] または [適用しない] Azure Cosmos DB Free レベルのアカウントでは、最初の 1000 RU/s と 25 GB のストレージを無料でご利用いただけます。 Free レベルの詳細を確認してください。
    合計アカウント スループットを制限する 選択済みかどうか このアカウントでプロビジョニングできるスループットの総量を制限する。 この制限により、プロビジョニングされたスループットに関連する予期しない料金が回避されます。 この制限は、アカウントの作成後に更新または削除できます。

    Azure サブスクリプションにつき所有できる Free サービス レベルの Azure Cosmos DB アカウントは 1 つまでです。また、アカウントの作成時にオプトインする必要があります。 Free レベル割引を適用するオプションが表示されない場合は、サブスクリプション内の別のアカウントが Free レベルで既に有効になっています。

    [Azure Cosmos DB アカウントの作成] ページを示すスクリーンショット。

    容量モードとして [サーバーレス] を選択した場合、次のオプションは使用できません。

    • Apply Free Tier Discount (Free レベルの割引の適用)
    • 合計アカウント スループットを制限する
  5. [グローバル分散] タブで、次の詳細を構成します。 このクイックスタートでは、既定値のままにしておいてかまいません。

    設定 説明
    geo 冗長 無効化 リージョンをペア リージョンとペアリングすることによる、アカウントでのグローバル配信を有効または無効にします。 アカウントには、後でさらにリージョンを追加できます。
    マルチリージョン書き込み 無効化 マルチリージョン書き込み機能を使用すると、世界中のデータベースとコンテナーで、プロビジョニングされたスループットを利用できます。
    可用性ゾーン 無効化 可用性ゾーンは、アプリケーションの可用性と回復性をさらに向上させるために役立ちます。

    前の [基本] ページで [容量モード] として [サーバーレス] を選択した場合、次のオプションは使用できません。

    • geo 冗長
    • マルチリージョン書き込み
  6. 必要に応じて、次のタブでさらに詳細を構成できます:

  7. [Review + create](レビュー + 作成) を選択します。

  8. アカウントの設定を確認し、 [作成] を選択します。 アカウントの作成には数分かかります。 ポータル ページに "デプロイが完了しました" と表示されるまで待ちます。

    デプロイが完了したことを示すスクリーンショット。

  9. [リソースに移動] を選択し、Azure Cosmos DB アカウント ページに移動します。

    Azure Cosmos DB アカウント ページを示すスクリーンショット。

データベース アカウントのリージョンの追加/削除

ヒント

新しいリージョンが追加されるとき、すべてのデータが新しいリージョンに完全にレプリケートおよびコミットされるまで、リージョンには使用可能のマークが付きません。 この操作にかかる時間は、アカウント内に保存されているデータの量によって変動します。 非同期スループット スケーリング操作が進行中の場合、スループットのスケールアップ操作は一時停止され、リージョンの追加または削除操作が完了すると自動的に再開されます。

  1. Azure ポータルにサインインします。

  2. お使いの Azure Cosmos DB アカウントに移動して、リソース メニューの [データをグローバルにレプリケートする] を選択します。

  3. 領域を追加するには、目的の領域に対応する + ラベルを持つマップ上の六角形を選択します。 別の方法でリージョンを追加するには、 [+ リージョンの追加] オプションを選択し、ドロップダウン メニューからリージョンを選択します。

  4. リージョンを削除するには、チェック マークの付いた青い六角形をマップ上で選択して、1 つ以上のリージョンを消去します。 右側のリージョンの横にある 廃棄物箱 (🗑) アイコンを選択することもできます。

  5. 変更を保存するには、 [OK] を選択します。

    リージョンが強調表示された [データをグローバルにレプリケートする] メニューのスクリーンショット。

    単一リージョン書き込みモードでは、書き込みリージョンを削除できません。 その現在の書き込みリージョンを削除する前に、別のリージョンへのフェールオーバーを行う必要があります。

    複数リージョン書き込みモードでは、少なくとも 1 つのリージョンがあれば、どのリージョンも追加または削除できます。

    複数の書き込みリージョンの構成

    [データをグローバルにレプリケートする] タブを開き、[有効] を選択して複数リージョンの書き込みを有効にします。 複数リージョンの書き込みを有効にすると、アカウントで現在用意されているすべての読み取りリージョンが読み書きリージョンになります。

    リージョンの構成と保存が強調表示された [データをグローバルにレプリケートする] メニューのスクリーンショット。

Azure Cosmos DB アカウントでのサービスマネージド フェールオーバーの有効化

サービスマネージド フェールオーバー オプションを使用すると、Azure Cosmos DB は、リージョンが使用できなくなった場合にユーザーアクションなしで、フェールオーバー優先度が最も高いリージョンにフェールオーバーできます。 サービスマネージド フェールオーバーが有効になっているとき、リージョン優先順位を変更できます。 サービスマネージド フェールオーバーを有効にするには、アカウントに 2 つ以上のリージョンを用意する必要があります。

  1. Azure Cosmos DB アカウントで、[データをグローバルにレプリケートする] メニューを開きます。

  2. ウィンドウの上部で、[サービスマネージド フェールオーバー] を選択します。

    [データをグローバルにレプリケートする] メニューを示すスクリーンショット。

  3. [サービスマネージド フェールオーバー] ウィンドウで [Enable Service-Managed Failover] (サービス管理フェールオーバーを有効にする)[ON] に設定されていることを確認します。

  4. [保存] を選択します。

    [サービスマネージド フェールオーバー] ポータル メニューのスクリーンショット。

Azure Cosmos DB アカウントの強制フェールオーバーを実行する

強制フェールオーバー (オフライン リージョン) を使用すると、ユーザーは Cosmos DB アカウントのパフォーマンス低下、部分的な停止、またはリージョンの中断に迅速に対処できます。 サービスで管理されるフェールオーバーは、サービスの確認に依存し、停止の進行に基づいてアクティブ化に時間がかかる場合があります。 強制フェールオーバーを使用すると、管理者はサービスによって管理されるフェールオーバーを待たずに、影響を受けるリージョンの可用性をすばやく復元できます。

  1. Azure Cosmos DB アカウントで、[データをグローバルにレプリケートする] メニューを開きます。

  2. ウィンドウの上部にある [ オフライン リージョン] を選択します。

    オフラインリージョンポータルメニューを示すスクリーンショット。

  3. フェールオーバーの優先度に基づいて新しい書き込みリージョンに昇格されるリージョンで、レプリケートされていない書き込みが使用できないことによるデータ損失の可能性を示す警告メッセージを確認します。

  4. オフラインとしてマークするリージョンを選択し、 現在選択されているリージョンをオフラインにすることを理解して同意するというタイトルのボックスをオンにして、[ オフラインリージョン ] ボタンをクリックします。

    オフライン リージョンの警告を示すスクリーンショット。

  5. 完了すると、フェールオーバー優先度が最も高いリージョンは新しい書き込みリージョンに昇格され、元の書き込みリージョンはオフラインとしてマークされます。

    オフライン リージョンの完了を示すスクリーンショット。

    Azure Cosmos DB サービス チームは、リージョンをオンラインに戻します。 障害発生時にリージョンがオフラインになっている場合、影響の重大度によっては、オンラインに復元するのに 3 日以上かかる場合があります。 リージョンがオフラインになっているディザスター リカバリー訓練では、リージョンをオンラインに戻すためのサポート チケット要求を作成してください。

    単一書き込みリージョンの場合、書き込みリージョンがドリル中または停止中にオフラインの場合、リージョンをオンラインに戻すと、"読み取りリージョン" として復元されます。 その後、"書き込みリージョンの変更" 操作を実行して、リージョンを書き込みリージョンに昇格させることができます。

    Azure Cosmos DB では、これらのメトリックに基づいて自動化を作成するユーザー向けに、 リージョン オフラインリージョン オンライン のメトリックが提供されます。 たとえば、リージョンがオンラインに戻った後、リージョンを変更/書き込みするオートメーション ジョブをトリガーできます。 サポートされているデータベース アカウントメトリックの一覧 は、こちらをご覧ください

Azure Cosmos DB アカウントでのフェールオーバーの優先度の設定

Azure Cosmos DB アカウントにサービスマネージド フェールオーバーを構成した後、リージョンのフェールオーバーの優先順位を変更できます。

重要

アカウントにサービスマネージド フェールオーバーを構成しているとき、書き込みリージョン (フェールオーバーの優先順位がゼロ) は変更できません。 書き込みリージョンを変更するには、サービスマネージド フェールオーバーを無効にし、手動フェールオーバーを実行する必要があります。

  1. Azure Cosmos DB アカウントで、[データをグローバルにレプリケートする] メニューを開きます。

  2. ウィンドウの上部で、[サービスマネージド フェールオーバー] を選択します。

    [データをグローバルにレプリケートする] メニューを示すスクリーンショット。

  3. [サービスマネージド フェールオーバー] ウィンドウで [Enable Service-Managed Failover] (サービス管理フェールオーバーを有効にする)[ON] に設定されていることを確認します。

  4. フェールオーバーの優先度を変更するには、カーソルを置くと行の左側に表示される 3 つのドットを使い、読み込みリージョンをドラッグします。

  5. [保存] を選択します。

    [サービスマネージド フェールオーバー] ポータル メニューのスクリーンショット。

Azure Cosmos DB アカウントの書き込みリージョンを変更する

重要

変更/書き込みリージョン操作のために、Azure Cosmos DB アカウントを複数のリージョンで構成する必要があります。

非同期スループット スケーリング操作の進行中に手動の変更/書き込みリージョン操作を実行すると、スループットのスケールアップ操作は一時停止されます。 フェールオーバー操作が完了すると、自動的に再開されます。 詳細については、プロビジョニングされたスループット (RU/秒) のスケーリングに関するベスト プラクティスに関する記事を参照してください。

警告

書き込みリージョンが停止した場合は、変更/書き込みリージョンを使用しないでください。 停止シナリオについては、強制フェールオーバーに関するセクションを参照してください。

  1. Azure Cosmos DB アカウントに移動して、[データをグローバルにレプリケートする] メニューを開きます。

  2. メニューの上部にある [ 書き込みリージョンの変更] を選択します。

    [書き込みリージョンの変更] メニューのスクリーンショット。

  3. [ 書き込みリージョンの変更 ] パネルには、停止シナリオ中にこの操作が実行されないようにするための詳細が表示されます。 リージョンの停止中にこの操作が実行されていないことを選択して確認します。

    変更書き込みリージョンの詳細のスクリーンショット。

  4. 新しい書き込みリージョンとチェック ボックスをオンにして、操作の確認を確認します。 [ OK] を クリックして操作を実行します。

    変更書き込みリージョンの確認のスクリーンショット。