Azure Cosmos DB for MongoDB 仮想コア クラスターでリージョン間レプリケーションを管理する
適用対象: MongoDB 仮想コア
Azure Cosmos DB for MongoDB 仮想コアを使うと、別の Azure リージョンのレプリカ クラスターにデータを継続的にストリーミングできます。 この機能により、リージョン間ディザスター リカバリー (DR) の保護と、リージョンをまたぐ読み取りスケーラビリティが提供されます。 このドキュメントは、クラスターのリージョン間レプリケーションを管理する方法について知りたい開発者のためのクイック ガイドとして役に立ちます。
前提条件
- アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
リージョン間レプリケーションを有効にする
"クラスターの作成中に" 新しいクラスターでリージョン間レプリケーションを有効にするには、次の手順に従います。
- 次の手順に従って、クラスターの作成を開始し、新しい Azure Cosmos DB for MongoDB 仮想コア クラスターの [基本] タブを完了します。
- [グローバル配信] タブで、[別のリージョンの読み取りレプリカ] に対して [有効] を選択します。
- [読み取りレプリカ名] フィールドにレプリカ クラスター名を指定します。
- [読み取りレプリカ リージョン] でリージョンを選択します。 レプリカ クラスターは、選択した Azure リージョンでホストされます。
- (オプション) [ネットワーク] タブで、クラスターに必要なネットワーク アクセス設定を選択します。
- [確認と作成] タブで、クラスター構成の詳細を確認し、[作成] を選択します。
Note
レプリカ クラスターは、プライマリ クラスターと同じ Azure サブスクリプションおよびリソース グループに作成されます。
"クラスターの作成後の任意のタイミングで" 新しいクラスターでリージョン間レプリケーションを有効にするには、次の手順に従います。
- 手順に従って、新しい Azure Cosmos DB for MongoDB 仮想コア クラスターを作成します。
- [グローバル配信] タブをスキップします。このタブは、プライマリ クラスターのプロビジョニング中にクラスター レプリカを作成するために使用されます。
- クラスターが作成されたら、クラスターのサイドバーの [設定] で、[グローバル配信] を選びます。
- [新しい読み取りレプリカの追加] を選択します。
- [読み取りレプリカ名] フィールドにレプリカ クラスター名を指定します。
- [読み取りレプリカ リージョン] でリージョンを選択します。 レプリカ クラスターは、選択した Azure リージョンでホストされます。
- 選択内容を確認し、[保存] ボタンを選択してレプリカの作成を確認します。
読み取り操作でレプリカ クラスターにアクセスできるようにするには、パブリック アクセスのファイアウォール規則を構成するか、セキュリティで保護されたプライベート アクセス用のプライベート エンドポイントを追加して、そのネットワーク設定を調整します。
レプリカを昇格させる
読み取り/書き込みクラスターにクラスター レプリカを昇格させるには、次の手順のようにします。
- ポータルで昇格させるクラスター レプリカを選びます。
- クラスターのサイドバーの [設定] で、[グローバル配布] を選びます。
- [グローバル配布] ページで、[昇格] を選びます。
- [<クラスター名> を昇格する] 画面で、クラスター レプリカの名前を再確認し、警告テキストを読んで、[昇格する] を選びます。
昇格されたクラスター レプリカは、読み取りと書き込みが可能なクラスターになります。 プライマリ (読み取り/書き込み) クラスター 高可用性 (HA) が有効になっている場合は、昇格後にレプリカ クラスターで再度有効にする必要があります。
クラスター レプリケーション ロールとレプリケーション リージョンを確認する
クラスターのレプリケーション ロールを確認するには、次の手順のようにします。
- 既存の Azure Cosmos DB for MongoDB 仮想コア クラスターを選びます。
- [概要] ページを選びます。
- [読み取りリージョン] (プライマリ クラスター上) または [書き込みリージョン] (レプリカ クラスター) の値を確認します。
[読み取りリージョン] の値が [有効になっていない] の場合、このクラスターではリージョン間レプリケーションが無効になっています。
リージョン間レプリケーションを無効にする
リージョン間レプリケーションを無効にするには、次の手順のようにします。
- Azure Cosmos DB for MongoDB 仮想コアの "レプリカ" クラスターを選びます。
- [概要] を選択します。
- それがレプリカ クラスターであることを確認します。
- Azure portal で、レプリカ クラスターの [概要] ページを開き、[削除] を選びます。
- [<レプリカ名> の削除] 画面で、警告テキストを読み、[アカウント名を確認する] フィールドにクラスターの名前を入力します。
- [削除] を選択して、レプリカの削除を確認します。
プライマリとレプリカのクラスターを削除する必要がある場合は、レプリカ クラスターを最初に削除する必要があります。
接続文字列の使用
通常の読み取り/書き込みクラスターと同様に、クラスター レプリカに接続できます。 さまざまなケースの接続文字列を取得するには、次の手順のようにします。
- ポータルでプライマリ クラスターまたはそのクラスター レプリカを選びます。
- クラスターのサイドバーの [設定] で、[接続文字列] を選びます。
- 現在選択されているクラスターの自己接続文字列をコピーして、そのクラスターに接続します。
- (必要に応じて、プライマリ クラスターのみ) 書き込みに使用できるクラスターを常に指すグローバル読み取り/書き込み接続文字列をコピーします。
自己接続文字列は、クラスター レプリカの昇格の後も保持されます。 読み取り操作には、引き続き文字列またはグローバル読み取り/書き込み接続文字列を使用できます。 書き込み操作に自己接続文字列を使用する場合は、昇格が完了した後もデータベースへの書き込みを続行するには、昇格されたレプリカ クラスターを指すようにアプリケーションの接続文字列を更新する必要があります。