翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon DocumentDB グローバルクラスターの概要
## グローバルクラスターとは
グローバルクラスターは、1 つのプライマリリージョンと、最大 10 個の読み取り専用セカンダリリージョンで構成されます。書き込みオペレーションを、プライマリリージョンのプライマリクラスターに直接行うと、Amazon DocumentDB 専用のインフラストラクチャを使用してセカンダリリージョンにデータを自動的にレプリケートします。レイテンシーは通常 1 秒未満です。
## グローバルクラスターはどのように役立つのか
+ **リージョン全体の停止からのリカバリー** - リージョン全体の停止が発生した場合、セカンダリクラスターの 1 つを数分以内にプライマリクラスターに昇格できます。通常、目標復旧時間 (RTO) は 1 分未満です。通常、目標復旧時点 (RPO) は秒単位で測定されますが、これは障害発生時のネットワーク経由の遅延によって異なります。
+ **ローカルレイテンシーによるグローバルな読み取り** - 世界中にオフィスを持つ企業は、グローバルクラスターを使用することで、自社の主な情報源をプライマリリージョンで最新状態に保つことができます。他のリージョンにあるオフィスは、自社のリージョンにある情報にローカルのレイテンシーでアクセスすることができます。
+ **スケーラブルなセカンダリクラスター** - 読み取り専用のインスタンス をセカンダリリージョンにさらに追加することでセカンダリクラスターは、スケールできます。セカンダリクラスターは読み取り専用です。したがって、読み取り専用のレプリカインスタンスを、1 つの クラスターにつき、通常の 15 件ではなく最大 16 件サポートします。
+ **プライマリからセカンダリクラスターへの迅速なレプリケーション** - グローバルクラスターによるレプリケーションは、プライマリデータベースクラスターのパフォーマンスにほとんど影響しません。DB インスタンスのリソースは、全面的にアプリケーションの読み取りおよび書き込みワークロードに当てられます。
## グローバルクラスターの現在の制限は何ですか。
+ グローバルクラスターは Amazon DocumentDB v3.6 ではサポートされていません。
+ グローバルクラスターは、db.t3、db.t4g、db.r4 を除くすべてのインスタンスタイプでサポートされています。
+ グローバルクラスターは、南米 (サンパウロ)、欧州 (ミラノ)、中国 (北京)、中国 (寧夏) の各リージョンでは利用できません。
+ リージョンが異なるエンジンバージョンにある場合、スイッチオーバーとグローバルフェイルオーバーはサポートされていません。エンジンのバージョンが一致しない場合、手動フェイルオーバーがサポートされます。
+ 書き込みオペレーションはプライマリクラスターのみが実行します。書き込みオペレーションを実行するクライアントは、プライマリクラスターの クラスターエンドポイントに接続します。
+ クラスターには、最大 10 個のセカンダリリージョンと 1 つのプライマリリージョンを設定できます。
+ セカンダリクラスターは停止できません。プライマリクラスターにセカンダリクラスターが関連付けられている場合、プライマリクラスターを停止できません。セカンダリクラスターを持たないリージョナルクラスターのみを停止できます。
+ セカンダリクラスターにアタッチされたレプリカは、特定の場合に再起動することが可能です。プライマリリージョンのインスタンスが再起動またはフェイルオーバーすると、そのセカンダリリージョンにあるレプリカも再起動します。このクラスターは、その後すべてのレプリカがプライマリデータベースのクラスターのライターインスタンスと同期するまでは使用できません。この動作は想定されるものです。プライマリクラスターに変更を加えるときは、必ず事前に、グローバルクラスターへの影響を把握してください。
+ セカンダリクラスターでは変更ストリームを使用できません。
**Topics**
+ [グローバルクラスターとは](#w2aac33b9b3)
+ [グローバルクラスターはどのように役立つのか](#w2aac33b9b5)
+ [グローバルクラスターの現在の制限は何ですか。](#w2aac33b9b7)
+ [「クイックスタートガイド」](global-clusters.get-started.md)
+ [グローバルクラスターの管理](global-clusters.manage.md)
+ [グローバルクラスターの接続](global-clusters-connect.md)
+ [グローバルクラスターのモニタリング](global-clusters-monitor.md)
+ [ディザスタリカバリ](global-clusters-disaster-recovery.md)
# クイックスタートガイド: グローバルクラスター
**Topics**
+ [設定](#global-clusters.config)
+ [グローバルクラスターの作成](#global-clusters-create)
+ [グローバルクラスターへのリージョンの追加](#global-clusters.add-region)
+ [スナップショットの使用](#global-clusters.snapshot)
## 設定
Amazon DocumentDB グローバルクラスターは、少なくとも 2 つにまたがります AWS リージョン。プライマリリージョンは、1 つのプライマリ (ライター) インスタンスと最大 15 個のレプリカインスタンスを持つクラスターをサポートします。セカンダリリージョンでは、最大 16 個のレプリカインスタンスで構成される読み取り専用クラスターが実行されます。グローバルクラスターには、最大 5 つのセカンダリリージョンを設定することできます。この表は、グローバルクラスターで許容されているクラスター、インスタンス、レプリカの最大数をリスト化したものです。
| 説明 | プライマリ AWS リージョン | セカンダリ AWS リージョン |
| --- | --- | --- |
| クラスター | 1 | 5 (最大) |
| ライターインスタンス | 1 | 0 |
| 読み取り専用インスタンス (Amazon DocumentDB レプリカ)、クラスターごと | 15 (最大数) | 16 (総数) |
| 読み取り専用インスタンス (最大許容数、指定されたセカンダリリージョンの実数) | 15 - s | s = セカンダリの総数 AWS リージョン |
クラスターには、以下の固有の要件があります。
+ **データベースインスタンスクラスの要件** — 使用できるのは `db.r5` と`db.r6g` インスタンスクラスのみです。
+ **AWS リージョン 要件** — プライマリクラスターは 1 つのリージョンにあり、少なくとも 1 つのセカンダリクラスターは同じアカウントの別のリージョンにある必要があります。セカンダリ (読み取り専用) クラスターは最大 5 つ作成できます。それぞれが異なるリージョンに存在していなければなりません。つまり、2 つのクラスターを、同じリージョン内に置くことはできません。
+ **命名の要件** - それぞれのクラスターで選ぶ名前は、すべてのリージョンにおいて一意でなければなりません。異なるクラスターに、たとえそれらが別のリージョンに置かれていたとしても、同じ名前を付けることはできません。
## Amazon DocumentDB グローバルクラスターの作成
最初のグローバルクラスターを構築する準備はできていますか。このセクションでは、 AWS マネジメントコンソール または を使用して、 AWS CLI 新しいデータベースクラスターとインスタンスを使用して新しいグローバルクラスターを作成する方法について説明します。
### の使用 AWS マネジメントコンソール
1. で AWS マネジメントコンソール、**Amazon DocumentDB** に移動します。
1. Amazon DocumentDB コンソールにアクセスしたら、[**クラスター**] を選択します。
![\[Amazon DocumentDB コンソールのクラスターページ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. **[作成]** を選択します。
![\[クラスターテーブルの右上隅に表示される作成ボタン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. **Amazon DocumentDB クラスター** のフォームの [**設定**] セクションをそれぞれに応じて入力します。
+ **クラスター識別子**: このインスタンスの一意の識別子を入力するか、クラスター識別子に基づき Amazon DocumentDB でインスタンスを指定できるようにします。
+ エンジンバージョン: [**4.0.0**] を選択します。
+ インスタンスクラス: [**db.r5.large**] を選択します。
+ インスタンス数: [**3**] を選択します。
![\[Amazon DocumentDB クラスターを作成するための設定オプションフォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. [**認証**] セクションで、マスターユーザーネームとマスターパスワードを入力します。
![\[新しい Amazon DocumentDB クラスターのマスターユーザー名とパスワードを指定する認証フォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. [**詳細設定を表示**] を選択します。
![\[キャンセルボタンとクラスター作成ボタンの横にある「詳細設定を表示」トグルボタンを表示します。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. [**ネットワーク設定**] セクションで以下の操作を行います。
+ **仮想プライベートクラウド (VPC)** と **サブネットグループ** のデフォルトオプションを保持します。
![\[VPC、サブネットグループ、および VPC セキュリティグループオプションを示すネットワーク設定フォーム。VPC およびサブネットグループフィールドには、デフォルトのオプションが選択されています。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ **VPC セキュリティグループ** では、**デフォルト VPC** は既に追加されている必要があります。
![\[デフォルトの VPC が既に追加されていることを示すネットワーク設定フォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ [**VPC セキュリティグループ**] フィールドに `DocDB` を入力し、[**DocDB-Inbound (VPC)**] を選択します。
![\[VPC セキュリティグループのドロップダウンメニューで選択された DocDB インバウンド VFC。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. **クラスターオプション** と **保管時の暗号化** では、デフォルトの選択のままにします。
![\[デフォルトのオプションが選択されたクラスターオプションと保管時の暗号化フォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. **バックアップ** と **ログのエクスポート** では、デフォルトの選択のままにします。
![\[デフォルトのオプションが選択されたバックアップとログのエクスポートフォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. **メンテナンス**、**タグ**、および **削除保護** では、デフォルトの選択のままにします。
![\[デフォルトのオプションが選択されているメンテナンス、タグ、削除保護フォーム。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. 次に、[**クラスターの作成**] というボタンをクリックしてください。
![\[クラスター作成プロセスの最後に表示されたクラスターの作成ボタン。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### の使用 AWS CLI
Amazon DocumentDB リージョンクラスターを作成するには、[create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html)を呼び出します。次の AWS CLI コマンドは、 という名前の Amazon DocumentDB クラスターを作成します`global-cluster-id`。削除に対する保護についての詳細は、「[Amazon DocumentDB クラスターの削除](db-cluster-delete.md)」を参照してください。
また、`--engine-version` は、デフォルトで最新のメジャーエンジンバージョンとなるオプションのパラメータです。現在のデフォルトのエンジンバージョンは です `5.0.0` (注: Amazon DocumentDB 8.0 は利用可能ですが、 として明示的に指定する必要があります`8.0.0`)。新しいメジャーエンジンバージョンがリリースされると、`--engine-version` のデフォルトのエンジンバージョンが最新のメジャーエンジンバージョンに更新されます。そのため、本稼働ワークロード、特にスクリプト、オートメーション、または CloudFormation テンプレートに依存するワークロードの場合は、目的のメジャーバージョン`--engine-version`に を明示的に指定することをお勧めします。
`db-subnet-group-name` または `vpc-security-group-id` が指定されていない場合、Amazon DocumentDB は、指定されたリージョンに対してデフォルトのサブネットグループと Amazon VPC セキュリティグループを使用します。
次の例では、各 *ユーザー入力プレースホルダー* を独自の情報に置き換えます。
Linux、macOS、Unix の場合:
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Windows の場合:
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
このオペレーションによる出力は、次のようになります (JSON 形式)。
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
クラスターが作成されるまでに数分かかります。 AWS マネジメントコンソール または を使用して AWS CLI 、クラスターのステータスをモニタリングできます。詳細については、「[Amazon DocumentDB クラスターのステータスのモニタリング](monitoring_docdb-cluster_status.md)」を参照してください。
**重要**
を使用して Amazon DocumentDB リージョンクラスター AWS CLI を作成する場合、インスタンスは作成されません。したがって、プライマリインスタンスと必要なレプリカインスタンスを明示的に作成してください。コンソールまたは を使用してインスタンス AWS CLI を作成できます。詳細については、「[クラスターへの Amazon DocumentDB インスタンスの追加](db-instance-add.md) および [CreateDBCluster](API_CreateDBCluster.md)」がある「Amazon DocumentDB API リファレンス」を参照してください。
リージョンクラスターが使用可能になったら、[Amazon DocumentDB グローバルクラスター AWS リージョン への の追加](#global-clusters.add-region) の手順に従って、別のリージョンにセカンダリクラスターを追加できます。リージョンを追加すると、リージョンクラスターがプライマリクラスタになり、選択したリージョンに新しいセカンダリクラスターが作成されます。
## Amazon DocumentDB グローバルクラスター AWS リージョン への の追加
グローバルクラスターは、プライマリクラスターとは異なるリージョンに少なくとも 1 つのセカンダリクラスターを必要とし、最大 5 つのセカンダリクラスターを追加できます。追加する各セカンダリクラスターで、プライマリクラスターに許容されたレプリカの数を減らします。例えば、グローバルクラスターに 5 つのセカンダリリージョンがある場合、プライマリクラスターが持てるレプリカの数は 10 です (15 ではなく)。詳細については、「[Amazon DocumentDB グローバルクラスターの設定要件](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config)」を参照してください。
### の使用 AWS マネジメントコンソール
1. にサインイン AWS マネジメントコンソール し、Amazon DocumentDB コンソールを開きます。
1. ナビゲーションペインで **[Clusters]** (クラスター) を選択してください。
![\[Amazon DocumentDB コンソールのクラスターページ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. セカンダリクラスターを追加するクラスターを選択します。クラスターが `Available` であることを確認します。
![\[mydocdbglobalcluster が強調表示された、使用可能ステータスを示すリージョンクラスターとグローバルクラスターのリスト。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. ドロップダウンメニューから [**アクション**] を選択し、[**リージョンの追加**] を選択します。
![\[クラスターインターフェイスのアクションドロップダウンに、リージョンの追加オプションが表示されます。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. [** AWS リージョンの追加**] ページで、セカンダリリージョンを選択します。同じグローバルクラスターのセカンダリクラスターがすでに存在するリージョンを選択することはできません。また、プライマリクラスターと同じリージョンにすることはできません。これが最初に追加するリージョンである場合は、選択したグローバルクラスター ID も指定する必要があります。
![\[AWS リージョン フォームの追加のドロップダウンメニューを使用して、セカンダリリージョンを選択します。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. 新しいリージョンのセカンダリクラスターの残りのフィールドを入力し、[**クラスターの作成**] を選択してください。リージョンの追加が完了すると、[**クラスター**] の AWS マネジメントコンソールのリストに表示されます。
![\[設定フォーム、時間単位のコスト見積もり、クラスターの作成ボタンを示す、リージョンをクラスターに追加する最終ステップ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### の使用 AWS CLI
+ お客様のグローバルクラスターの名前 `create-db-cluster` を指定して、`(--global-cluster-identifier)` CLI コマンドを使用します。他のパラメータでは、以下の操作を行います。
+ では`--region`、プライマリリージョン AWS リージョン とは異なる を選択します。
+ `--engine` および `--engine-version` パラメータの特定の値を選択します。
+ 暗号化されたクラスターの場合、プライマリを暗号化`--source-region`用の AWS リージョン として指定します。
次の例では、新しい Amazon DocumentDB クラスターを作成し、それを読み取り専用セカンダリクラスターとしてグローバルクラスターにアタッチします。最後のステップでは、インスタンスを新しいクラスターに追加します。
次の例では、各 *ユーザー入力プレースホルダー* を独自の情報に置き換えます。
Linux、macOS、Unix の場合:
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Windows の場合:
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Amazon DocumentDB グローバルクラスターのスナップショットの使用
Amazon DocumentDB クラスターのスナップショットを復元することで、グローバルクラスターの開始ポイントとして使用することができます。これを行うには、スナップショットを復元し、新しいクラスターを作成する必要があります。これは、グローバルクラスタのプライマリクラスターとして機能します。次に、復元したクラスターを別のリージョンに追加して、グローバルクラスターに変換します。
# Amazon DocumentDB グローバルクラスターの管理
グローバルクラスターを構成する個別のクラスターに対して、ほとんどの管理オペレーションを実行できます。コンソールで、[**Group related resources (グループ関連のリソース)**] を[**クラスター**] ページで選択すると、プライマリクラスターとセカンダリクラスターが、関連付けられたグローバルクラスターの下にグループとして表示されます。
グローバルクラスター**の設定**タブには、クラスターが実行されている AWS リージョン 、バージョン、グローバルクラスター識別子が表示されます。
**Topics**
+ [グローバルクラスターの変更](#global-clusters.modify)
+ [パラメータの変更](#global-clusters.modify-parameters)
+ [グローバルクラスターの削除](#global-clusters.remove)
+ [グローバルクラスターの削除](#global-clusters.delete)
+ [ヘッドレスクラスター](#global-clusters.headless)
## Amazon DocumentDB グローバルクラスターの変更
の**クラスター**ページには、すべてのグローバルクラスターが AWS マネジメントコンソール 一覧表示され、それぞれのプライマリクラスターとセカンダリクラスターが表示されます。グローバルクラスターには、独自の構成設定があります。具体的には、プライマリクラスターとセカンダリクラスターに関連付けられたリージョンがあります。
グローバルクラスターに変更を加えると、変更をキャンセルする機会が与えられます。
[続行] を選択したら、変更を確認します。
## Amazon DocumentDB グローバルクラスターのパラメータの変更
グローバルクラスター内の各クラスターで、クラスターパラメータグループを個別に設定することができます。ほとんどのパラメータの動作は、他の種類の Amazon DocumentDB クラスターと同じです。グローバルデータベース内のすべてのクラスター間で設定の一貫性を保つことをお勧めします。これにより、セカンダリクラスターをプライマリクラスターに昇格した場合に、予期しない動作の変更が生じることを回避できます。
例えば、別のクラスターがプライマリクラスターを肩代わりしたときに動作が変わらないように、タイムゾーンと文字セットに同じ設定を使用します。
## Amazon DocumentDB グローバルクラスターからのクラスターの削除
グローバルクラスターからクラスターを削除したい場合がいくつかあります。例えば、プライマリクラスターの性能低下や切断が生じて、グローバルクラスターからクラスターを削除したい場合があります。その後、新しいグローバルクラスターを作成するために使用できるスタンドアロンのプロビジョニングクラスターになります。詳細については[Amazon DocumentDB グローバルクラスターの手動フェイルオーバーの実行](global-clusters-disaster-recovery.md#manual-failover)を参照してください。
また、不要になったグローバルクラスターを削除するために、クラスターを削除する場合も可能です。関連するすべてのクラスターを削除 (デタッチ) した後、プライマリが最後に残るまで、グローバルクラスターを削除することはできません。詳細については、「[Amazon DocumentDB グローバルクラスターからのクラスターの削除](#global-clusters.delete)」を参照してください。
**注記**
クラスターがグローバルクラスターからデタッチされると、プライマリは同期されなくなります。これは、完全な読み取り/書き込み機能を備えたスタンドアロンのプロビジョニングクラスターになります。さらに、Amazon DocumentDB コンソールに表示されなくなりました。これは、クラスターが配置されたコンソールでリージョンを選択した場合にのみ表示されます。
グローバルクラスターからクラスターを削除するには AWS マネジメントコンソール、、 AWS CLI、または RDS API を使用します。
------
#### [ Using the AWS マネジメントコンソール ]
1. にサインイン AWS マネジメントコンソール し、Amazon DocumentDB コンソールに移動します。
1. 左のナビゲーションで [**Clusters (クラスター)**] を選択します。
![\[イメージ: 既存のクラスターリンクとそれに対応するインスタンスリンクのリストを示すクラスターナビゲーションボックス。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. グローバルクラスターを展開して、すべてのセカンダリクラスターを表示します。削除するセカンダリクラスターを選択します。[**アクション**] を選択し、ドロップダウンメニューで [**グローバルから削除**] を選択します。
![\[イメージ: 特定の既存のセカンダリクラスターが選択された状態で、「グローバルから削除」アクションを強調表示したクラスターナビゲーションボックス。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/remove-global.png)
1. グローバルクラスターからセカンダリをデタッチするかどうかを確認するプロンプトが表示されます。グローバルクラスターからクラスターを削除するには、[**削除して昇格する**] を選択します。
![\[イメージ:「削除して昇格する」プロンプト。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/remove-promote.png)
クラスターは、セカンダリとして機能しなくなり、プライマリクラスターと同期しなくなります。これは、完全な読み取り/書き込み機能を備えたスタンドアロンクラスターです。
すべてのセカンダリクラスターを解除または削除したら、次にプライマリクラスターを同じ方法で解除できます。すべてのセカンダリクラスターを削除するまで、グローバルクラスターからプライマリクラスターをデタッチ (削除) することはできません。グローバルクラスターは、リージョンと AZ が 0 のままクラスターリストに残り続ける場合があります。今後このグローバルクラスターを使用しない場合は、削除できます。
------
#### [ Using the AWS CLI ]
グローバルクラスターからクラスターを削除するには、次のパラメータを指定して、`remove-from-global-cluster` CLI コマンドを実行します。
+ `--global-cluster-identifier` - グローバルクラスターの名前 (識別子)。
+ `--db-cluster-identifier` - グローバルクラスターから削除する各クラスターの名前。
以下の例では、まずセカンダリクラスターを削除し、次にグローバルクラスターからプライマリクラスターを削除します。
Linux、macOS、Unix の場合:
```
aws docdb --region secondary_region \
remove-from-global-cluster \
--db-cluster-identifier secondary_cluster_ARN \
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region \
remove-from-global-cluster \
--db-cluster-identifier primary_cluster_ARN \
--global-cluster-identifier global_cluster_id
```
グローバルクラスターの各セカンダリリージョンで `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` コマンドを繰り返し実行します。
Windows の場合:
```
aws docdb --region secondary_region ^
remove-from-global-cluster ^
--db-cluster-identifier secondary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region ^
remove-from-global-cluster ^
--db-cluster-identifier primary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
```
グローバルクラスターの各セカンダリリージョンで `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` コマンドを繰り返し実行します。
------
## Amazon DocumentDB グローバルクラスターからのクラスターの削除
グローバルクラスターを削除するには、以下の操作を行います。
+ グローバルクラスターからすべてのセカンダリクラスターを削除します。各クラスターは、スタンドアロンクラスターになります。前のセクション「[Amazon DocumentDB グローバルクラスターからのクラスターの削除](#global-clusters.remove)」を参照してください。
+ 各スタンドアロンクラスターから、すべてのレプリカを削除します。
+ グローバルクラスターからプライマリクラスターを削除します。これは、スタンドアロンクラスターになります。
+ プライマリクラスターから、まずすべてのレプリカを削除し、次にプライマリインスタンスを削除します。新しいスタンドアロンクラスターからプライマリインスタンスを削除すると、通常クラスターとグローバルクラスターも削除されます。
------
#### [ Using the AWS マネジメントコンソール ]
1. にサインイン AWS マネジメントコンソール し、Amazon DocumentDB コンソールに移動します。
1. [**クラスター**] を選択し、削除するグローバルクラスターを見つけます。
![\[イメージ: 既存のクラスターリンクとそれに対応するインスタンスリンクのリストを示すクラスターナビゲーションボックス。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. グローバルクラスターを選択した状態で、[**削除**] を [**アクション**] メニューから選択します。
![\[イメージ: 特定のグローバルクラスターが選択された状態で、「削除」アクションを強調表示したクラスターナビゲーションボックス。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)
グローバルクラスターからすべてのクラスターが削除されていることを確認します。グローバルクラスターでは、リージョンと AZ が 0で、クラスターのサイズが 0 と表示されるはずです。グローバルクラスターにクラスターが含まれている場合は、これを削除できません。まず、前のステップの [**[Amazon DocumentDB グローバルクラスターからのクラスターの削除](#global-clusters.remove)**] の指示に従わなければなりません。
------
#### [ Using the AWS CLI ]
グローバルクラスターを削除するには、次の例に示すように、 の名前 AWS リージョン とグローバルクラスター識別子を使用して `delete-global-cluster` CLI コマンドを実行します。
Linux、macOS、Unix の場合:
```
aws docdb --region primary_region delete-global-cluster \
--global-cluster-identifier global_cluster_id
```
Windows の場合:
```
aws docdb --region primary_region delete-global-cluster ^
--global-cluster-identifier global_cluster_id
```
------
## セカンダリリージョンでのヘッドレス Amazon DocumentDB クラスターの作成
Amazon DocumentDB グローバルクラスターには、プライマリ AWS リージョン とは異なる に少なくとも 1 つのセカンダリクラスターが必要ですが、セカンダリクラスターにはヘッドレス設定を使用できます。ヘッドレスセカンダリ Amazon DocumentDB クラスターは、インスタンスがないクラスターのことです。この種類の設定では、グローバルクラスターの費用を削減できます。Amazon DocumentDB クラスターでは、コンピューティングとストレージは分離されています。インスタンスがない場合、コンピューティングに対する課金は発生せず、ストレージに対してのみが課金されます。正しく設定されていれば、ヘッドレスセカンダリのストレージボリュームはプライマリクラスターと同期したままになります。
Amazon DocumentDB グローバルクラスターの作成時に通常行うように、セカンダリクラスターを追加します。ただし、プライマリクラスターがセカンダリへのレプリケーションを開始した後、セカンダリクラスターから読み取り専用インスタンスを削除します。インスタンスがなくなったため、このセカンダリクラスターは「ヘッドレス」とみなされます。ただし、ストレージボリュームはプライマリ Amazon DocumentDB クラスターと同期されたままとなります。
**重要**
リージョン全体の障害を 15 分以上許容できるお客様にのみ、ヘッドレスクラスターをお勧めします。これは、ヘッドレスセカンダリクラスターを使用してリージョン全体の障害から復旧するには、フェイルオーバー後にユーザーが新しいインスタンスを作成する必要があるためです。新しいインスタンスが利用可能になるまで 10 ～ 15 分かかることがあります。
### ヘッドレスセカンダリクラスターをお客様のグローバルクラスターに追加するには
1. にサインイン AWS マネジメントコンソール し、[Amazon DocumentDB コンソール](https://console.aws.amazon.com/rds/)を開きます。
1. 左のナビゲーションで [**Clusters (クラスター)**] を選択します。
1. セカンダリクラスターを必要とするグローバルクラスターを選択します。プライマリクラスターが `Available` であることを確認します。
1. [**アクション**] で、[**リージョンの追加**] を選択します。
1. [**リージョンの追加**] ページで、セカンダリリージョンを選択します。
**注記**
同じグローバルクラスターのセカンダリクラスターがすでに存在するリージョンを選択することはできません。また、プライマリクラスターと同じリージョンにすることはできません。
1. 新しいリージョンのセカンダリクラスターの残りのフィールドに入力してください。これらは、他のクラスターインスタンスと同じ設定オプションです。
1. リージョンを追加します。グローバルクラスターへのリージョンの追加が完了すると、`Clusters` の AWS マネジメントコンソールのリストに表示されます。
1. AWS マネジメントコンソール または を使用して、続行する前にセカンダリクラスターとそのリーダーインスタンスのステータスを確認します AWS CLI。以下に、 AWS CLIを使用した場合のコマンドの例を示します。
```
$ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
```
新しく追加されたセカンダリクラスターのステータスが作成中から使用可能に変わるまでに数分かかる場合があります。クラスターが使用可能になったら、リーダーインスタンスを削除できます。
1. セカンダリクラスターでリーダーインスタンスを選択し、[**Delete (削除)**] を選択します。
1. リーダーインスタンスを削除しても、セカンダリクラスターはグローバルクラスターの一部にとどまります。関連付けられたインスタンスは存在しません。
**注記**
このヘッドレスセカンダリの Amazon DocumentDB クラスターを使用して、Amazon DocumentDB グローバルクラスターをプライマリリージョンの予期しない停止から手動で復旧できます。
# Amazon DocumentDB グローバルクラスターへの接続
グローバルクラスターへの接続方法は、クラスターへの書き込みと、クラスターからの読み取りの、どちらを必要とするのかに応じて異なります。
+ 読み取り専用のリクエストまたはクエリ場合、 AWS リージョンにあるクラスターのリーダーエンドポイントに接続します。
+ データ操作言語 (DML) またはデータ定義言語 (DDL) のステートメントを実行するには、プライマリクラスターのクラスターエンドポイントに接続します。このエンドポイントは、アプリケーション AWS リージョン とは異なる にある可能性があります。
コンソールでグローバルクラスターを表示すると、そのすべてのクラスターに関連付けられているすべての汎用エンドポイントを表示できます。
グローバルクラスターへの接続方法は、データベースへの書き込みと、データベースからの読み取りの、どちらを必要とするのかに応じて異なります。プライマリリージョンから提供する DDL、DML、および読み取りオペレーションの場合は、プライマリクラスターに接続する必要があります。レプリカセットモードのクラスターエンドポイントを使用し、プライマリクラスターに接続し、読み取り設定を `secondaryPreferred=true` にすることをお勧めします。これにより、プライマリクラスターのライターインスタンスに書き込みトラフィックがルーティングされ、読み取りトラフィックがプライマリクラスターのレプリカインスタンスにルーティングされます。
クロスリージョンでは、読み取り専用トラフィックの場合は、セカンダリクラスターの 1 つに接続する必要があります。レプリカセットモードのクラスターエンドポイントを使用し、セカンダリクラスターに接続することをお勧めします。すべてのインスタンスは読み取り専用レプリカインスタンスであるため、読み取り設定を指定する必要はありません。レイテンシーを最小限にするときは、お使いのリージョンか、最寄りのリージョンの、いずれかにあるリーダーエンドポイントを選択します。
# Amazon DocumentDB グローバルクラスターのモニタリング
Amazon DocumentDB (MongoDB 互換性) は CloudWatch と統合することで、クラスターのオペレーションメトリクスを収集および分析できます。これらのメトリクスは、CloudWatch コンソール、Amazon DocumentDB コンソール、 AWS Command Line Interface (AWS CLI)、または CloudWatch API を使用してモニタリングできます。
グローバルクラスターをモニタリングするには、次の CloudWatch メトリクスを使用します。
| メトリクス | 説明 |
| --- | --- |
| GlobalClusterReplicatedWriteIO | プライマリ のクラスターボリュームからセカンダリ のクラスターボリューム AWS リージョン にレプリケートされた課金書き込み I/O オペレーションの平均数。5 分間隔で AWS リージョン報告されます。各セカンダリリージョンへレプリケートされた ReplicatedWriteIOs の数は、リージョン内の VolumeWriteIOPs の数と同じで、プライマリリージョンによって実行されます。 |
| GlobalClusterDataTransferBytes | プライマリクラスターからセカンダリクラスター AWS リージョン に転送されるデータの量 AWS リージョン。バイト単位で測定します。 |
| GlobalClusterReplicationLag | 変更イベントをプライマリクラスターの からセカンダリクラスターの AWS リージョン にレプリケートする際の、ミリ秒単位の遅延の量 AWS リージョン |
これらのメトリクスの表示方法の詳細については、「[CloudWatch データを表示する](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data)」を参照してください。
# ディザスタリカバリと Amazon DocumentDB グローバルクラスターについて
**Topics**
+ [Amazon DocumentDB グローバルクラスターのマネージドフェイルオーバーの実行](#managed-failover)
+ [Amazon DocumentDB グローバルクラスターの手動フェイルオーバーの実行](#manual-failover)
+ [Amazon DocumentDB グローバルクラスターのスイッチオーバーの実行](#global-cluster-switchover)
+ [グローバルクラスターのスイッチオーバーまたはフェイルオーバーのブロック解除](#unblocking-gc-so-fo)
グローバルクラスターを使用すると、リージョンの障害などの災害から迅速に復旧できます。災害からの復旧は、通常、RTO と RPO (目標復旧時点) の値を使用して測定します。
+ **目標復旧時間 (RTO)**– 災害後にシステムが稼働状態に戻るまでにかかる時間。つまり、RTO はダウンタイムを測定します。グローバルクラスターの場合、RTO は分単位です。
+ **目標復旧時点 (RPO)** – 損失する可能性があるデータの量 (時間単位)。グローバルクラスターの場合、目標復旧時点 (RPO) は通常、秒単位で測定されます。
+ 予期しない停止から復旧するには、グローバルクラスター内のセカンダリの 1 つのクロスリージョンフェイルオーバーを実行できます。グローバルクラスターに複数のセカンダリリージョンがある場合、プライマリとして昇格させたいすべてのセカンダリリージョンをデタッチしてください。次に、これらのセカンダリリージョンの 1 つを新しいプライマリ AWS リージョンに昇格させます。最後に、他の各セカンダリリージョンに新しいクラスターを作成し、それらのクラスターをグローバルクラスターにアタッチします。
## Amazon DocumentDB グローバルクラスターのマネージドフェイルオーバーの実行
このアプローチは、真の地域災害やサービスレベルの全面的な停止が発生した場合でも事業を継続できるようにするためのものです。
マネージドフェイルオーバー中、プライマリクラスターは選択したセカンダリリージョンにフェイルオーバーされ、お使いの Amazon DocumentDB グローバルクラスターの既存のレプリケーショントポロジが維持されます。選択したセカンダリクラスターは、読み取り専用ノードの 1 つを完全な読み取り状態に昇格します。このステップにより、クラスターがプライマリクラスターのロールを引き受けることができます。クラスターが新しいロールを引き受ける間、データベースは短時間使用できなくなります。古いプライマリクラスターから選択したセカンダリクラスターにレプリケートされなかったデータは、このセカンダリクラスターが新しいプライマリクラスターになると失われます。古いプライマリボリュームは、新しいプライマリと同期する前にスナップショットを取得するべく、レプリケートされていないデータがスナップショットに保持されるように最善を尽くします。
**注記**
プライマリクラスターとすべてのセカンダリクラスターに同じエンジンバージョンがある場合にのみ、Amazon DocumentDB グローバルクラスターへのマネージドクロスリージョンクラスターフェイルオーバーを実行できます。ご使用のエンジンバージョンに互換性がない場合は、[Amazon DocumentDB グローバルクラスターの手動フェイルオーバーの実行](#manual-failover) の手順に従ってフェイルオーバーを手動で実行できます。
リージョンのエンジンバージョンが一致しない場合、フェイルオーバーはブロックされます。保留中のアップグレードを確認して適用し、すべてのリージョンのエンジンバージョンが一致し、グローバルクラスターフェイルオーバーがブロック解除されていることを確認してください。詳細については、「[グローバルクラスターのスイッチオーバーまたはフェイルオーバーのブロック解除](#unblocking-gc-so-fo)」を参照してください。
データの損失を最小限に抑えるため、この機能を使用する前に次のことを行うことをお勧めします。
+ 各アプリケーションをオフラインにして、Amazon DocumentDB グローバルクラスターのプライマリクラスターへの書き込みが送信されないようにします。
+ すべての Amazon DocumentDB セカンダリクラスターのラグタイムをチェックします。レプリケーションの遅延が最も少ないセカンダリリージョンを選択すると、現在障害が発生しているプライマリリージョンでのデータ損失を最小限に抑えることができます。Amazon CloudWatch 上で `GlobalClusterReplicationLag` メトリクスを確認して、グローバルクラスター内のすべての Amazon DocumentDB セカンダリクラスターのラグタイムを確認します。これらのメトリクスは、各セカンダリクラスターへのレプリケーションがプライマリクラスターに対してどの程度遅れているかをミリ秒単位で示します。
Amazon DocumentDB 向け CloudWatch メトリクスの詳細については、「[Amazon DocumentDB のメトリクス](cloud_watch.md#cloud_watch-metrics_list)」を参照してください。
マネージドフェイルオーバー中、選択されたセカンダリクラスターは、プライマリとして新しいロールに昇格されます。ただし、プライマリクラスターのさまざまな設定オプションは引き継がれません。構成の不一致は、パフォーマンスの問題、ワークロードの非互換性、およびその他の異常な動作につながる可能性があります。このような問題を回避するには、Amazon DocumentDB グローバルクラスター間の次のような相違点を解消しておくことをお勧めします。
+ **新しいプライマリ向けに Amazon DocumentDB のクラスターパラメータグループを構成する (必要な場合)** — Amazon DocumentDB グローバルクラスター内の各クラスターごとに、Amazon DocumentDB クラスターパラメータグループを構成できます。ただし、セカンダリクラスターを昇格してプライマリロールを引き継ぐ場合、セカンダリからのパラメータグループは、プライマリとは異なる設定になっている可能性があります。その場合は、昇格されたセカンダリクラスターのパラメータグループを、プライマリクラスターの設定に適合するように変更してください。この方法の詳細は、「[Amazon DocumentDB クラスターパラメータグループを変更する](cluster_parameter_groups-modify.md)」を参照してください。
+ **各種モニタリングツールやオプションを構成する (Amazon CloudWatch Events やアラームなど)** - グローバルクラスターに必要なログ機能、アラームなどを使用して、昇格されたクラスターの設定を行います。パラメータグループと同様に、フェイルオーバープロセス中にこれらの機能の設定がプライマリから継承されることはありません。レプリケーションラグなどの一部の CloudWatch メトリクスは、セカンダリリージョンのみで使用できます。そのため、フェイルオーバーによってメトリクスの表示方法やアラームの設定方法が変わり、定義済みのダッシュボードを変更する必要が生じる場合があります。Amazon DocumentDB クラスターとモニタリングの詳細については、「[Amazon DocumentDB のモニタリング](monitoring_docdb.md)」を参照してください。
通常、選択したセカンダリクラスターが 1 分以内に主要な役割を引き継ぎます。新しいプライマリリージョンのライターノードが使用可能になり次第、アプリケーションをそのライターノードに接続してワークロードを再開できます。Amazon DocumentDB が新しいプライマリクラスターを昇格させると、追加のセカンダリリージョンクラスターはすべて自動的にリビルドされます。
Amazon DocumentDB グローバルクラスターは非同期レプリケーションを使用するため、レプリケーションラグはセカンダリリージョンごとに異なる場合があります。これに対し Amazon DocumentDB は、これらのセカンダリリージョンを、新しいプライマリリージョンクラスターとまったく同じポイントインタイムデータを持つようにリビルドします。ストレージボリュームのサイズとリージョン間の距離によっては、再構築タスクが完了するまでに数分から数時間かかることがあります。セカンダリージョンのクラスターが新しいプライマリリージョンからの再構築を完了すると、読み取りアクセスが可能になります。新しいプライマリライターが昇格して使用可能になると、新しいプライマリリージョンのクラスターが、Amazon DocumentDB グローバルクラスターの読み取りおよび書き込みオペレーションを処理できるようになります。
グローバルクラスターの元のトポロジを復元するために、Amazon DocumentDB は古いプライマリリージョンの可用性を監視します。そのリージョンが再び正常な状態になり利用可能になるとすぐに、Amazon DocumentDB はそのリージョンをセカンダリリージョンとしてグローバルクラスターに自動的に追加します。古いプライマリリージョンに新しいストレージボリュームを作成する前に、Amazon DocumentDB は障害発生時の古いストレージボリュームのスナップショットを取得しようとします。これにより、欠落しているデータを回復することができます。このオペレーションが成功すると、Amazon DocumentDB は「rds:docdb-unplanned-global-failover-name-of-old-primary-DB-cluster-timestamp」という名前のスナップショットを AWS マネジメントコンソールのスナップショットセクションに格納します。このスナップショットは、`DescribeDBClusterSnapshots` API オペレーションによって返される情報にもリストアップされます。
**注記**
古いストレージボリュームのスナップショットは、古い主クラスターに設定されたバックアップ保持期間の対象となるシステムスナップショットです。このスナップショットを保存期間外に保存するには、スナップショットをコピーして手動スナップショットとして保存できます。価格などのスナップショットのコピーの詳細については、「[クラスタースナップショットのコピー](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot)」を参照してください。
元のトポロジを復元できたら、ビジネスとワークロードにとって最も都合のよいタイミングでスイッチオーバーオペレーションを実行することで、グローバルクラスターを元のプライマリリージョンにフェイルバックします。これを行うには、「[Amazon DocumentDB グローバルクラスターのスイッチオーバーの実行](#global-cluster-switchover)」の手順を実行します。
Amazon DocumentDB グローバルクラスターは AWS マネジメントコンソール、、 AWS CLI、または Amazon DocumentDB API を使用してフェイルオーバーできます。
------
#### [ Using the AWS マネジメントコンソール ]
**Amazon DocumentDB グローバルクラスターでマネージドフェイルオーバーを実行する**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。
1. ナビゲーションペインで **[Clusters]** (クラスター) を選択してください。
1. フェイルオーバーしたい Amazon DocumentDB グローバルクラスターを選択します。
![\[イメージ: グローバルクラスターが選択されたクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. **[アクション]** メニューから **[スイッチオーバーまたはフェイルオーバーする]** を選択します。
1. 表示されるダイアログボックスで、**[フェイルオーバー]** を選択し、**[新しいプライマリクラスター]** フィールドのドロップダウンリストからセカンダリクラスターを選択します。
![\[イメージ: グローバルクラスターの「スイッチオーバーまたはフェイルオーバーする」のダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. 最後のフィールドに「confirm」 (確定する) とキー入力します。**[Confirm]** (確認) を選択します。
プライマリクラスターのステータスが「**フェイルオーバー**」に変わります。この状態になるまでには約 1 分かかります。この間、新しいプライマリクラスターのステータスは「**変更中**」と表示されます。新しいプライマリが昇格されると、「**利用可能**」の表示に変わり、読み取りおよび書き込みトランザクションを処理できるようになります。古いプライマリを含むセカンダリリージョンは、「**再同期中**」と表示され、新しいプライマリに再同期されます。新しいプライマリと同様に、古いプライマリも、ステータスが「**利用可能**」に変わってからのみトランザクションの処理が可能となります。
1. 完了すると、元のプライマリクラスターはセカンダリクラスターになります。選択したセカンダリクラスターがプライマリクラスターになります。
![\[イメージ: 新しいプライマリクラスターを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Amazon DocumentDB グローバルクラスターでマネージドフェイルオーバーを実行する**
[https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html) CLI コマンドを実行して、Amazon DocumentDB グローバルクラスターをフェイルオーバーします。コマンドを使用して、次のオプションの値を渡します。
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
次の例では*ユーザー入力プレースホルダー*をユーザー自身の情報で置き換えます。
Linux、macOS、Unix の場合:
```
aws docdb failover-global-cluster \
--region region_of_selected_secondary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote \
--allow-data-loss
```
Windows の場合:
```
aws docdb failover-global-cluster ^
--region region_of_selected_secondary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote ^
--allow-data-loss
```
------
## Amazon DocumentDB グローバルクラスターの手動フェイルオーバーの実行
1 つの 内のクラスター全体が使用 AWS リージョン できなくなった場合は、グローバルクラスター内の別のクラスターを昇格させて読み取り/書き込み機能を持つことができます。
別の AWS リージョン にあるクラスターがプライマリクラスターとしてより適格であると判断される場合は、グローバルクラスターフェイルオーバー機能を手動で起動することができます。たとえば、特定のセカンダリクラスターの容量を増やして、プライマリクラスターに昇格させることもできます。または、 間のアクティビティのバランスが AWS リージョン 変化する可能性があるため、プライマリクラスターを別のクラスターに切り替えると、書き込みオペレーションのレイテンシーが低下する AWS リージョン 可能性があります。
次の手順では、Amazon DocumentDB グローバルクラスターのセカンダリクラスターの 1 つを昇格させる方法を説明します。
セカンダリクラスターを昇格させるには
1. 停止 AWS リージョン した のプライマリクラスターへの DML ステートメントやその他の書き込みオペレーションの発行を停止します。
1. 新しいプライマリクラスター AWS リージョン として使用するセカンダリからクラスターを特定します。グローバルクラスター AWS リージョン に 2 つ (またはそれ以上) のセカンダリがある場合は、ラグタイムが最も短いセカンダリクラスターを選択します。
1. 選択したセカンダリクラスターをグローバルクラスターからデタッチします。
グローバルクラスターからセカンダリクラスターを削除すると、プライマリからこのセカンダリへのレプリケーションが直ちに停止され、完全な読み取り/書き込み機能を備えたスタンドアロンのプロビジョニングクラスターへと昇格されます。停止しているリージョン内のプライマリクラスターに関連付けられたその他のセカンダリクラスターは引き続き利用可能で、アプリケーションからの呼び出しを受け付けることができます。また、リソースを使用することになります。グローバルクラスターを再作成するため、スプリットブレインなどの問題を回避するために、以下のステップで新しいグローバルクラスターを作成する前に、他のセカンダリクラスターを削除します。
アタッチ解除の詳細なステップについては、[Amazon DocumentDB グローバルクラスターからのクラスターの削除](global-clusters.manage.md#global-clusters.remove) を参照してください。
1. このクラスターは、次のステップでリージョンを追加すると、新しいグローバルクラスターのプライマリクラスターになります。
1. クラスター AWS リージョン に を追加します。これを行うと、プライマリからセカンダリへのレプリケーションプロセスがスタートされます。
1. 必要に応じて を追加して AWS リージョン 、アプリケーションをサポートするために必要なトポロジを再作成します。グローバルクラスター内 (スプリットブレインの問題) のクラスター間のデータの不整合を避けるために、これらの変更を行う前、最中、および後に、アプリケーションの書き込みが正しいクラスターに送信されていることを確認してください。
1. 停止状態が解決されて元の AWS リージョン をプライマリクラスターとして再度割り当てる準備が完了したら、同じステップを逆に実行します。
1. グローバルクラスターからセカンダリクラスターの 1 つを削除します。これにより、読み取り/書き込みトラフィックを提供できるようになります。
1. 元の AWS リージョンのプライマリクラスターにすべての書き込みトラフィックをリダイレクトします。
1. を追加して AWS リージョン 、以前 AWS リージョン と同じ に 1 つ以上のセカンダリクラスターを設定します。
Amazon DocumentDB グローバルクラスターは AWS SDKs を使用して管理できるため、ディザスタリカバリとビジネス継続性計画のユースケースのグローバルクラスターフェイルオーバープロセスを自動化するソリューションを作成できます。そのようなソリューションの 1 つは、Apache 2.0 ライセンスに基づいてお客様に提供されており、[こちら](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation)のツールリポジトリからアクセスできます。このソリューションは、エンドポイント管理に Amazon Route 53 を活用し、適切なイベントに基づいてトリガーできる AWS Lambda 機能を提供します。
## Amazon DocumentDB グローバルクラスターのスイッチオーバーの実行
スイッチオーバーを使用すると、プライマリクラスターのリージョンを定期的に変更できます。この機能は、運用メンテナンス、その他の計画された運用手順など、管理されたシナリオを対象としています。
スイッチオーバーを使用する一般的なユースケースは 3 つあります。
+ 特定の業界に課せられる「リージョナルローテーション」要件向け。たとえば、金融サービス規制では、ディザスタリカバリ手順が定期的に実施されるように、Tier-0 システムを別の地域に数か月間切り替えることが求められる場合があります。
+ マルチリージョンの「follow-the-sun」アプリケーション向け。たとえば、ある企業が、さまざまなタイムゾーンの営業時間に基づいて、さまざまなリージョンで低レイテンシーの書き込みを提供したいとします。
+ データ損失ゼロの方法として、フェイルオーバー後に元のプライマリリージョンにフェイルバックします。
**注記**
スイッチオーバーは、正常な Amazon DocumentDB グローバルクラスターでの使用向けに設計された機能です。予期しないシステム停止から回復するには、[Amazon DocumentDB グローバルクラスターの手動フェイルオーバーの実行](#manual-failover) の該当する手順に従ってください。
スイッチオーバーを実行するには、すべてのセカンダリリージョンがプライマリとまったく同じエンジンバージョンを実行している必要があります。リージョンのエンジンバージョンが一致しない場合、スイッチオーバーはブロックされます。保留中のアップグレードを確認して適用し、すべてのリージョンのエンジンバージョンが一致し、グローバルクラスターのスイッチオーバーがブロック解除されていることを確認してください。詳細については、「[グローバルクラスターのスイッチオーバーまたはフェイルオーバーのブロック解除](#unblocking-gc-so-fo)」を参照してください。
スイッチオーバー中、Amazon DocumentDB は、グローバルクラスターの既存のレプリケーショントポロジを維持しながら、プライマリクラスターを選択されたセカンダリリージョンにスイッチオーバーします。なお、Amazon DocumentDB は、すべてのセカンダリリージョンクラスターがプライマリリージョンクラスターと完全に同期されるまで待ってからスイッチオーバープロセスを開始します。次に、プライマリリージョンの DB クラスターは読み取り専用になり、選択したセカンダリ DB クラスターは、読み取り専用ノードの 1 つを、フルライターステータスに昇格させます。このノードをライターに昇格させると、そのセカンダリクラスターがプライマリクラスターの役割を引き受けることができます。プロセスの開始時にはすべてのセカンダリクラスターがプライマリと完全に同期されているため、新しいプライマリはデータを失うことなく Amazon DocumentDB グローバルクラスターのオペレーションを継続できます。プライマリクラスターと選択したセカンダリクラスターが新しいロールを引き受ける間、短時間データベースが使用できなくなります。
アプリケーションの可用性を最適化するには、この機能を使用する前に、次の操作を行うことをお勧めします。
+ この操作は、ピーク時以外の、プライマリクラスターへの書き込みが最小限である時間帯に実行してください。
+ 各アプリケーションをオフラインにして、Amazon DocumentDB グローバルクラスターのプライマリクラスターへの書き込みが送信されないようにします。
+ Amazon CloudWatch 上で `GlobalClusterReplicationLag` メトリクスを確認して、グローバルクラスター内のすべての Amazon DocumentDB セカンダリクラスターのラグタイムを確認します。このメトリクスは、セカンダリクラスターへのレプリケーションがプライマリクラスターに対してどのくらい遅れているかをミリ秒単位でを示します。この値は、Amazon DocumentDB がスイッチオーバーを完了するのにかかる時間と完全に比例します。したがって、遅延値が大きいほど、スイッチオーバーにかかる時間は長くなります。
Amazon DocumentDB 向け CloudWatch メトリクスの詳細については、「[Amazon DocumentDB のメトリクス](cloud_watch.md#cloud_watch-metrics_list)」を参照してください。
スイッチオーバー中、選択したセカンダリ DB クラスターは、プライマリとして新しいロールに昇格されます。ただし、プライマリ DB クラスターのさまざまな設定オプションは継承されません。構成の不一致は、パフォーマンスの問題、ワークロードの非互換性、およびその他の異常な動作につながる可能性があります。このような問題を回避するには、Amazon DocumentDB グローバルクラスター間の次のような相違点を解消しておくことをお勧めします。
+ **新しいプライマリ向けに Amazon DocumentDB のクラスターパラメータグループを構成する (必要な場合)** — Amazon DocumentDB グローバルクラスター内の各クラスターごとに、Amazon DocumentDB クラスターパラメータグループを構成できます。つまり、セカンダリ DB クラスターを昇格してプライマリロールを引き継ぐ場合、セカンダリからのパラメータグループは、プライマリとは異なる設定になることがあります。その場合は、プロモートされたセカンダリ DB クラスターのパラメータグループを、プライマリクラスターの設定に適合するように変更します。この方法については、「[Amazon DocumentDB クラスターパラメータグループの管理](cluster_parameter_groups.md)」を参照してください。
+ **各種モニタリングツールやオプションを構成する (Amazon CloudWatch Events やアラームなど)** - グローバルクラスターに必要なログ機能、アラームなどを使用して、昇格されたクラスターの設定を行います。パラメータグループと同様に、スイッチオーバープロセス中にこれらの機能の設定がプライマリから継承されることはありません。レプリケーションラグなどの一部の CloudWatch メトリクスは、プライマリリージョンのみで使用できます。そのため、スイッチオーバーによってメトリクスの表示方法やアラームの設定方法が変わり、定義済みのダッシュボードを変更する必要が生じる場合があります。詳細については、「[Amazon DocumentDB のモニタリング](monitoring_docdb.md)」を参照してください。
**注記**
通常、ロールスイッチオーバーには数分かかることがあります。
スイッチオーバープロセスが完了すると、昇格された Amazon DocumentDB クラスターはグローバルクラスターへの書き込みオペレーションを処理できるようになります。
AWS マネジメントコンソール または を使用してAmazon DocumentDB グローバルクラスターを切り替えることができます AWS CLI。
------
#### [ Using the AWS マネジメントコンソール ]
**Amazon DocumentDB グローバルクラスターでスイッチオーバーを実行する**
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。
1. ナビゲーションペインで **[Clusters]** (クラスター) を選択してください。
1. スイッチオーバーしたい Amazon DocumentDB グローバルクラスターを検索して選択します。
![\[イメージ: グローバルクラスターが選択されたクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. **[アクション]** メニューから **[スイッチオーバーまたはフェイルオーバーする]** を選択します。
1. 表示されるダイアログボックスで、**[スイッチオーバー]** を選択し、**[新しいプライマリクラスター]** フィールドのドロップダウンリストからセカンダリクラスターを選択します。
![\[イメージ: セカンダリクラスターが選択されたクラスタースイッチオーバーダイアログ。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. **[確認]** を選択します。
プライマリクラスターのステータスが「**スイッチオーバー中**」に変わります。この状態になるまでには約 3 分かかります。この間、すべてのリージョンクラスターのステータスは「**変更中**」と表示されます。すべてのリージョンが同期され、新しいプライマリが昇格されると、すべてのステータスフィールドの表示が「**利用可能**」となり、トランザクションを処理できるようになります。
1. 完了すると、元のプライマリクラスターはセカンダリクラスターになります。選択したセカンダリクラスターがプライマリクラスターになります。
![\[イメージ: 新しいプライマリクラスターを示すクラスターテーブル。\]](http://docs.aws.amazon.com/ja_jp/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Amazon DocumentDB グローバルクラスターでスイッチオーバーを実行する**
[https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html) CLI コマンドを実行して、Amazon DocumentDB グローバルクラスターをスイッチオーバーします。コマンドを使用して、次のオプションの値を渡します。
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
次の例では*ユーザー入力プレースホルダー*をユーザー自身の情報で置き換えます。
Linux、macOS、Unix の場合:
```
aws docdb switchover-global-cluster \
--region region_of_primary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote
```
Windows の場合:
```
aws docdb switchover-global-cluster ^
--region region_of_primary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote
```
------
## グローバルクラスターのスイッチオーバーまたはフェイルオーバーのブロック解除
グローバルクラスターのすべてのリージョンクラスターが同じエンジンバージョンにあるわけではない場合、グローバルクラスターのスイッチオーバーとフェイルオーバーはブロックされます。バージョンが一致しない場合、スイッチオーバーまたはフェイルオーバーを呼び出すと、次のエラーが表示されることがあります。指定されたターゲット DB クラスターは、ソース DB クラスターとは異なるパッチレベルでエンジンバージョンを実行しています。最新の更新を確実に実行してグローバルクラスターを正常な状態に保つために、最新のエンジンバージョンを定期的に適用することをお勧めします。
このエラーを解決するには、まずすべてのセカンダリリージョンを更新し、次に保留中のメンテナンスアクション項目を適用してプライマリリージョンを同じエンジンバージョンに更新してください。保留中のメンテナンスアクション項目を表示し、問題を修正するために必要な変更を適用するには、次のいずれかのタブの手順を実行します。
------
#### [ Using the AWS マネジメントコンソール ]
グローバルクラスターのスイッチオーバーまたはフェイルオーバーのブロックを解除するには、クラスターに対して保留中のメンテナンスアクションがあるかどうかを判断し、適用する必要があります。メンテナンスアクションを表示して適用するには、次の手順に従います。
1. にサインインし AWS マネジメントコンソール、[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) で Amazon DocumentDB コンソールを開きます。
1. ナビゲーションペインで **[Clusters]** (クラスター) を選択してください。
1. **クラスター** テーブルで、**クラスター識別子** 列でグローバルクラスターを見つけます。グローバルクラスターで、指定されたグローバルクラスターの各セカンダリクラスターとプライマリクラスターを書き留め、それぞれに対して次の手順を実行します。
1. 各セカンダリクラスターについて:
1. クラスターで更新が使用可能な場合、**[使用可能]**、**[必須]**、または **[次のウィンドウ]** として **メンテナンス** 列に示されます。
1. アクションを実行するには、クラスターを選択してその詳細を表示し、次に **[メンテナンス & バックアップ]** を選択します。**[保留中のメンテナンス]** 項目が表示されます。
1. **[説明]** で、「新しいメンテナンス更新が利用可能」と示されている場合は、それを選択し、**[今すぐ適用]** を選択します。
1. プライマリクラスターの場合:
1. クラスターで更新が使用可能な場合、**[使用可能]**、**[必須]**、または **[次のウィンドウ]** として **メンテナンス** 列に示されます。
1. アクションを実行するには、クラスターを選択してその詳細を表示し、次に **[メンテナンス & バックアップ]** を選択します。**[保留中のメンテナンス]** 項目が表示されます。
1. **[説明]** で、「新しいメンテナンス更新が利用可能」と示されている場合は、それを選択し、**[今すぐ適用]** を選択します。
------
#### [ Using the AWS CLI ]
グローバルクラスターのスイッチオーバーまたはフェイルオーバーのブロックを解除するには、クラスターに対して保留中のメンテナンスアクションがあるかどうかを判断し、適用する必要があります。まずメンテナンスアクションをセカンダリクラスターで表示して適用し、次にグローバルクラスターのプライマリクラスターで適用するには、次の手順に従います。
1. まず各セカンダリリージョンのリージョンクラスターで以下を実行し、次にプライマリリージョンのリージョンクラスターで以下を実行します。
1. `--resource-identifier` オプションを使用して [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) CLI コマンドを実行し、Amazon DocumentDB リージョンクラスターで使用可能なメンテナンスアクションがあるかどうかを確認します。
次の例では*ユーザー入力プレースホルダー*をユーザー自身の情報で置き換えます。
Linux、macOS、Unix の場合:
```
aws docdb describe-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Windows の場合:
```
aws docdb describe-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
結果は以下のようになります。
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2025-04-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2025-06-18T03:01:00Z",
"AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
"OptInStatus": "pending"
}
]
}
]
}
```
1. メンテナンスアクションが必要な場合は、次のオプションを使用して [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html) CLI コマンドを実行します。
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
次の例では*ユーザー入力プレースホルダー*をユーザー自身の情報で置き換えます。
Linux、macOS、Unix の場合:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
--apply-action system-update \
--opt-in-type immediate \
--region us-east-1
```
Windows の場合:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
--apply-action system-update ^
--opt-in-type immediate ^
--region us-east-1
```
1. メンテナンスアクションが完了したら、 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) コマンドを再度実行して、クラスターに対して保留中の他のアクションがないことを確認します。
必要な結果は次のとおりです。
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
グローバルクラスターのスイッチオーバーまたはフェイルオーバーのブロックを解除するには、クラスターに対して保留中のメンテナンスアクションがあるかどうかを判断し、適用する必要があります。次の API を使用して、メンテナンスアクションを表示および適用します。
1. まず各セカンダリリージョンのリージョンクラスターで以下を実行し、次にプライマリリージョンのリージョンクラスターで以下を実行します。
1. [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html) API を呼び出して、Amazon DocumentDB グローバルクラスターで使用可能なメンテナンスアクションがあるかどうかを確認します。
1. [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html) API を呼び出して変更を適用します。
------