翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# クイックスタートガイド: グローバルクラスター
**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 クラスターのスナップショットを復元することで、グローバルクラスターの開始ポイントとして使用することができます。これを行うには、スナップショットを復元し、新しいクラスターを作成する必要があります。これは、グローバルクラスタのプライマリクラスターとして機能します。次に、復元したクラスターを別のリージョンに追加して、グローバルクラスターに変換します。