# AWS リージョン の Amazon Aurora Global Database への追加
<a name="aurora-global-database-attaching"></a>

 次の手順を使用して、既存のグローバルデータベースにセカンダリクラスターを追加できます。この手順を使用して最初のセカンダリ AWS リージョンを追加することで、スタンドアロン Aurora DB クラスターからグローバルデータベースを作成することもできます。

Aurora Global Database には、プライマリ Aurora DB クラスターとは異なる AWS リージョン に 1 つ以上のセカンダリ Aurora DB クラスターが必要です。Aurora Global Database には、最大 10 つのセカンダリ DB クラスターをアタッチできます。新しいセカンダリ DB クラスターごとに次の手順を繰り返します。Aurora Global Database に追加する各セカンダリ DB クラスターで、プライマリ DB クラスターに許容された Aurora レプリカの数を、1 つずつ減らします。

例えば、Aurora Global Database に 10 のセカンダリリージョンがある場合、プライマリ DB クラスターが持てる Aurora レプリカの数は 15 ではなく 5 です。詳細については、「[Amazon Aurora Global Database の構成要件](aurora-global-database.configuration.requirements.md)」を参照してください。

プライマリ DB クラスター内の Aurora レプリカ (リーダーインスタンス) の数によって、追加できるセカンダリ DB クラスターの数が決まります。プライマリクラスターのリーダーインスタンスの数に、セカンダリクラスターの数を加えた合計が 15 を超えることはできません。例えば、プライマリクラスターにリーダーインスタンスが 14 あり、セカンダリクラスターが 1 つある場合、グローバルデータベースにこれ以上セカンダリクラスターを追加できません。

**注記**  
Aurora MySQL バージョン 3 では、セカンダリクラスターを作成するときに、`lower_case_table_names` の値がプライマリクラスターの値と一致していることを確認します。この設定は、サーバーが識別子の大文字と小文字の区別を処理する方法に影響するデータベースパラメータです。データベースパラメータの詳細については、「[Amazon Aurora のパラメータグループ](USER_WorkingWithParamGroups.md)」を参照してください。  
セカンダリクラスターを作成する際は、プライマリとセカンダリで同じ DB エンジンのバージョンを使用することをお勧めします。必要に応じて、プライマリをセカンダリと同じバージョンにアップグレードします。詳細については、「[マネージドクロスリージョンスイッチオーバーまたはフェイルオーバーに対するパッチレベルの互換性](aurora-global-database-upgrade.md#aurora-global-database-upgrade.minor.incompatibility)」を参照してください。

## コンソール
<a name="aurora-global-database-attach.console"></a>

**Aurora Global Database に AWS リージョン を追加するには**

1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. AWS マネジメントコンソール のナビゲーションペインで、[**データベース**] を選択します。

1. セカンダリ Aurora DB クラスターを必要とする Aurora Global Database を選択します。プライマリ Aurora DB クラスターが `Available` であることを確認します。

1.  **[アクション]** で、**[AWS リージョンを追加]** を選択します。  
![[アクション] メニューの [AWS リージョンを追加] が選択された、プロビジョニングされた DB クラスターのスクリーンショット。](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-global-db-create-apg-5-add-region.png)

1. **[Add a region]** (リージョンの追加) ページで、セカンダリ AWS リージョン を選択します。

   同じ Aurora Global Database では、既にセカンダリ Aurora DB クラスターが存在する AWS リージョン を選択することはできません。また、プライマリ Aurora DB クラスターと同じリージョンにすることはできません。
**注記**  
Babelfish for Aurora PostgreSQL グローバルデータベースは、Babelfish の設定を制御するパラメータがセカンダリリージョンで有効になっている場合にのみ, セカンダリリージョンで機能します。詳細については、[Babelfish の DB クラスターパラメータグループ設定](babelfish-configuration.md)を参照してください。  
![Aurora グローバルデータベースの [リージョンの追加] ページ。](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-global-db-create-apg-6-add-region.png)

1. 新しい AWS リージョンのセカンダリ Aurora クラスターの残りのフィールドに入力してください。これらは、Aurora DB クラスターインスタンスと同じ設定オプションですが、以下のオプションは Aurora MySQL - ベースの Aurora Global Database にのみ適用されます。
   + リードレプリカの書き込み転送を有効にする - このオプションの設定では、Aurora Global Database のセカンダリ DB クラスターが書き込み操作をプライマリクラスターに転送します。詳細については、「[Amazon Aurora Global Database の書き込み転送を使用する](aurora-global-database-write-forwarding.md)」を参照してください。  
![セカンダリクラスターが Aurora Global Database に追加されたことを示すスクリーンショット。](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-global-database-enable-write-forwarding.png)

1. **[AWS リージョンを追加]** を選択します。

Aurora Global Database にリージョンを追加すると、スクリーンショットに示すように、それらのリージョンが AWS マネジメントコンソール の[**データベース**] に一覧表示されます。

![セカンダリクラスターが Aurora Global Database に追加されたことを示すスクリーンショット。](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/aurora-global-db-apg-complete.png)


## AWS CLI
<a name="aurora-global-database-attach.cli"></a>

**セカンダリ AWS リージョン を Aurora Global Database に追加するには**

 CLI を使用してグローバルデータベースにセカンダリクラスターを追加するには、既にグローバルクラスターコンテナオブジェクトを保有している必要があります。`create-global-cluster` コマンドをまだ実行していない場合は、「[Amazon Aurora Global Database の作成](aurora-global-database-creating.md)」の CLI の手順を参照してください。

1. Aurora Global Database の名前 (`[create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html)`) を指定して、`--global-cluster-identifier` CLI コマンドを使用します。他のパラメータでは、以下の操作を行います。

1. `--region` で、Aurora プライマリリージョンのものとは異なる AWS リージョン を選択します。

1. `--engine` および `--engine-version` パラメータの特定の値を選択します。これらの値は、Aurora Global Database のプライマリ Aurora DB クラスターの値と同じです。

1. 暗号化されたクラスターの場合は、暗号化の `--source-region` としてプライマリ AWS リージョン を指定します。

次の例では、新しい Aurora DB クラスターを作成し、それを読み取り専用のセカンダリ Aurora DB クラスターとして Aurora Global Database にアタッチします。最後のステップでは、Aurora DB インスタンスを新しい Aurora DB クラスターに追加します。

Linux、macOS、Unix の場合:

```
aws rds --region {{secondary_region}} \
  create-db-cluster \
    --db-cluster-identifier {{secondary_cluster_id}} \
    --global-cluster-identifier {{global_database_id}} \
    --engine {{aurora-mysql | aurora-postgresql}} \
    --engine-version {{version}}

aws rds --region {{secondary_region}} \
  create-db-instance \
    --db-instance-class {{instance_class}} \
    --db-cluster-identifier {{secondary_cluster_id}} \
    --db-instance-identifier {{db_instance_id}} \
    --engine {{aurora-mysql | aurora-postgresql}}
```

Windows の場合:

```
aws rds --region {{secondary_region}} ^
  create-db-cluster ^
    --db-cluster-identifier {{secondary_cluster_id}} ^
    --global-cluster-identifier {{global_database_id_id}} ^
    --engine {{aurora-mysql | aurora-postgresql}} ^
    --engine-version {{version}}

aws rds --region {{secondary_region}} ^
  create-db-instance ^
    --db-instance-class {{instance_class}} ^
    --db-cluster-identifier {{secondary_cluster_id}} ^
    --db-instance-identifier {{db_instance_id}} ^
    --engine {{aurora-mysql | aurora-postgresql}}
```

## RDS API
<a name="aurora-global-database-attach.api"></a>

 RDS API を使用して新しい AWS リージョン を Aurora Global Database に追加するには、[CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) オペレーションを実行します。`GlobalClusterIdentifier` パラメータを使用して、既存のグローバルデータベースの識別子を指定します。