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

適用対象: NoSQL MongoDB Cassandra Gremlin Table

この記事では、Azure portal を使用して、Azure Cosmos DB アカウントでさまざまなタスクを管理する方法を紹介します。 Azure Cosmos DB は、Azure PowerShellAzure CLIAzure Resource 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 アカウントの作成] ページを示すスクリーンショット。

    Note

    [Capacity mode](容量モード) として [サーバーレス] を選択した場合、以下のオプションは利用できません。

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

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

    Note

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

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

    • ネットワーク仮想ネットワークからのアクセスを構成します。
    • Backup Policy定期的または継続的のいずれかのバックアップ ポリシーを構成します。
    • 暗号化。 サービス マネージド キーまたはカスタマー マネージド キーのいずれかを使用します。
    • タグ。 タグは名前と値のペアで、同じタグを複数のリソースやリソース グループに適用することでリソースを分類したり、統合した請求を表示したりできるようにします。
  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 アカウントでのフェールオーバーの優先度の設定

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

重要

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

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

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

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

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

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

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

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

Azure Cosmos アカウントで手動フェールオーバーを実行する

重要

この操作を成功させるには、Azure Cosmos DB アカウントに手動フェールオーバーを構成する必要があります。

Note

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

警告

書き込みリージョンが停止した場合、Azure Cosmos DB アカウントで "サービスマネージド フェールオーバー" によってセカンダリ リージョンが昇格されて新しいプライマリ書き込みリージョンになり、復旧後に元の書き込みリージョンが自動的に書き込みリージョンとして再び昇格されることはありません ユーザーが PowerShell、Azure CLI、または Azure portal を使って、書き込みリージョンとして復旧したリージョンに再び切り替える必要があります (前述のように、安全に実行できるようになったら)。

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

  2. メニューの上部で、 [手動フェールオーバー] を選択します。

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

  3. [手動フェールオーバー] メニューで、新しい書き込みリージョンを選択します。 チェック ボックスをオンにして、このオプションによって書き込みリージョンが変更されることを理解していることを示します。

  4. フェールオーバーをトリガーするには、 [OK] を選択します。

    [手動フェールオーバー] ポータル メニューのスクリーンショット。