# Aurora Serverless v2 を使用する DB クラスターの作成
Aurora Serverless v2 DB インスタンスを追加できる Aurora クラスターを作成するには、[Amazon Aurora DB クラスターの作成](Aurora.CreateInstance.md) と同じ手順に従います。Aurora Serverless v2 では、クラスターはプロビジョン済みクラスターと交換可能です。一部の DB インスタンスで Aurora Serverless v2 を使用し、一部の DB インスタンスではプロビジョン済みクラスターを持てます。
**Topics**
+ [Aurora Serverless v2 DB クラスターの設定](#aurora-serverless-v2.create-settings)
+ [Aurora Serverless v2 DB クラスターの作成](#aurora-serverless-v2.create-cluster)
+ [Aurora Serverless v2 ライター DB インスタンスの作成](#aurora-serverless-v2-adding-writer)
## Aurora Serverless v2 DB クラスターの設定
クラスターの初期設定が、「[Aurora Serverless v2 の要件と制限](aurora-serverless-v2.requirements.md)」に記載されている要件を満たしていることを確認します。次の設定を行い、Aurora Serverless v2 DB インスタンスをクラスターに作成できるようにします。
**AWS リージョン**
Aurora Serverless v2 DB インスタンスが利用可能な AWS リージョン でクラスターを作成します。利用可能なリージョンの詳細については、「[Aurora Serverless v2 でサポートされているリージョンと Aurora DB エンジン](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md)」を参照してください。
**DB エンジンバージョン**
Aurora Serverless v2 と互換性のあるエンジンバージョンを選択します。Aurora Serverless v2 のバージョンの要件の詳細については、「[Aurora Serverless v2 の要件と制限](aurora-serverless-v2.requirements.md)」を参照してください。
**DB インスタンスクラス**
AWS マネジメントコンソール を使用してクラスターを作成する場合は、ライター DB インスタンスの DB インスタンスクラスを同時に選択します。**[Serverless]** (サーバーレス) DB インスタンスクラスを選択します。その DB インスタンスクラスを選択した場合は、ライター DB インスタンスの容量範囲も指定します。この容量範囲は、そのクラスターに追加される他のすべての Aurora Serverless v2 DB インスタンスにも適用されます。
DB インスタンスクラスに **[サーバーレス]** の選択肢がない場合は、[Aurora Serverless v2 でサポートされているリージョンと Aurora DB エンジン](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md) に対してサポートされている DB エンジンのバージョンを選択していることを確認してください。
AWS CLI または Amazon RDS API を使用する場合、DB インスタンスクラスに指定するパラメータは `db.serverless` です。
**容量範囲**
クラスター内のすべての DB インスタンスに適用される Aurora 容量単位 (ACU) の最小値と最大値を入力します。このオプションは、DB インスタンスクラスに **[Serverless]** (サーバーレス) を選択した場合、**[Create cluster]** (クラスターの作成) と **[Add reader]** (リーダーの追加) のコンソールページの両方で利用できます。
さまざまな DB エンジンバージョンの許容容量範囲については、「[Aurora Serverless v2 の容量](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity)」を参照してください。
最小値と最大値の ACU フィールドが表示されない場合は、ライター DB インスタンスに**[サーバーレス]** インスタンスクラスが選択されていることを確認してください。
最初にプロビジョン済み DB インスタンスでクラスターを作成する場合は、最小と最大の ACU を指定しません。この場合、後でクラスターを変更して、その設定を追加できます。また、Aurora Serverless v2 リーダー DB インスタンスをクラスター追加することができます。そのプロセスの一部として、容量範囲を指定します。
クラスターの容量範囲を指定するまで、AWS CLI または RDS API を使用して、クラスターに Aurora Serverless v2 DB インスタンスを追加することはできません。Aurora Serverless v2 DB インスタンスを追加しようとした場合、エラーが発生します。AWS CLI または RDS API の手順では、容量範囲は `ServerlessV2ScalingConfiguration` 属性で表されます。
複数のリーダー DB インスタンスを含むクラスターの場合は、各 Aurora Serverless v2 リーダー DB インスタンスのフェイルオーバーの優先度によって、その DB インスタンスのスケールアップとスケールダウンに重要な役割を果たします。最初にクラスターを作成するときに、優先度を指定することはできません。2 番目以降のリーダー DB インスタンスをクラスターに追加する場合は、この特性に注意してください。詳細については、「[Aurora Serverless v2 リーダーの昇格階層の選択](aurora-serverless-v2-administration.md#aurora-serverless-v2-choosing-promotion-tier)」を参照してください。
## Aurora Serverless v2 DB クラスターの作成
AWS マネジメントコンソール、AWS CLI、または RDS API を使用して Aurora Serverless v2 DB クラスターを作成できます。
### コンソール
**Aurora Serverless v2 ライターを使用してクラスターを作成するには**
1. AWS マネジメントコンソール にサインインし、Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。
1. ナビゲーションペインで、**データベース**を選択します。
1. **[データベースの作成]** を選択します。表示されたページで、以下のオプションを選択します。
+ **[エンジンタイプ]** として、**[Aurora (MySQL 互換)]** または **[Aurora (PostgreSQL 互換)]** を選択します。
+ **[バージョン]** では、[Aurora Serverless v2 でサポートされているリージョンと Aurora DB エンジン](Concepts.Aurora_Fea_Regions_DB-eng.Feature.ServerlessV2.md) でサポートされているバージョンのいずれかを選択します。
1. **[DB インスタンスクラス]** では、**[サーバーレス v2]** を選択します。
1. **[容量設定]** では、デフォルトの範囲をそのまま使用できます。または、最小と最大のキャパシティーユニット数に、それぞれ他の値を指定することもできます。最小 0 ACU から 最大 256 ACU まで、0.5 ACU 単位で選択できます。
Aurora Serverless v2 の容量単位の詳細については、「[Aurora Serverless v2 の容量](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity)」および「[Aurora Serverless v2 でのパフォーマンスとスケーリング](aurora-serverless-v2.setting-capacity.md)」を参照してください。
選択するエンジンとバージョンに応じて、上限は 128 ACU、下限は 0.5 ACU、またはその両方になります。Aurora エンジンとバージョンの各組み合わせの制限の詳細については、「[Aurora Serverless v2 の容量](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity)」を参照してください。
![\[Aurora Serverless v2 のインスタンス構成設定。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/serverless_v2_screencaps/serverless_v2_capacity_setting_incl_nonzero_minimum.png)
最小容量 0 ACU を選択すると、Aurora Serverless v2 の自動一時停止と再開機能が有効になります。その場合、Aurora Serverless v2 DB インスタンスが自動的に一時停止する前に、データベース接続がない状態で待機する時間を追加で選択できます。自動一時停止および再開機能の詳細については、「[Aurora Serverless v2 の自動一時停止と再開によるゼロ ACU へのスケーリング](aurora-serverless-v2-auto-pause.md)」を参照してください。
![\[下限が 0 ACUの場合の Aurora Serverless v2 の容量設定。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/serverless_v2_screencaps/serverless_v2_capacity_setting_incl_zero_minimum.png)
1. 「[Aurora DB クラスターの設定](Aurora.CreateInstance.md#Aurora.CreateInstance.Settings)」の説明に従い、他の DB クラスター設定を選択します。
1. **[データベースの作成]** を選択して、Aurora Serverless v2 DB インスタンスで Aurora DB クラスター (別名: プライマリ DB インスタンス) を作成します。
### CLI
AWS CLI を使用して Aurora Serverless v2 と互換性のある DB クラスターを作成するには、「[Amazon Aurora DB クラスターの作成](Aurora.CreateInstance.md)」にある CLI の手順に従います。`create-db-cluster` コマンドに次のパラメータを含めます:
+ --region *AWS\$1Region\$1where\$1Aurora Serverless v2\$1instances\$1are\$1available*
+ --engine-version *serverless\$1v2\$1compatible\$1engine\$1version*
+ --serverless-v2-scaling-configuration MinCapacity=*minimum\$1capacity*,MaxCapacity=*maximum\$1capacity*
以下の例は、DB クラスター Aurora Serverless v2 の作成を示しています。
```
aws rds create-db-cluster \
--db-cluster-identifier my-serverless-v2-cluster \
--region eu-central-1 \
--engine aurora-mysql \
--engine-version 8.0.mysql_aurora.3.04.1 \
--serverless-v2-scaling-configuration MinCapacity=1,MaxCapacity=4 \
--master-username myuser \
--manage-master-user-password
```
**注記**
AWS CLI を使用して Aurora Serverless v2 DB クラスターを作成すると、出力のエンジンモードには `serverless` ではなく `provisioned` が表示されます。`serverless` エンジンモードについては、「Aurora Serverless v1」を参照してください。
この例では、管理パスワードを生成して Secrets Manager で管理する `--manage-master-user-password` オプションを指定しています。詳細については、「[Amazon Aurora および AWS Secrets Manager によるパスワード管理](rds-secrets-manager.md)」を参照してください。または、`--master-password` オプションを使用して、自分でパスワードを指定して管理することもできます。
Aurora Serverless v2 のバージョンの要件の詳細については、「[Aurora Serverless v2 の要件と制限](aurora-serverless-v2.requirements.md)」を参照してください。容量範囲に許可される番号と、数字の意味については、「[Aurora Serverless v2 の容量](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity)」および「[Aurora Serverless v2 でのパフォーマンスとスケーリング](aurora-serverless-v2.setting-capacity.md)」を参照してください。
既存のクラスターに容量設定が指定されているかどうかを確認するには、`ServerlessV2ScalingConfiguration` 属性 を `describe-db-clusters` コマンドの出力でチェックします。この属性は、以下の例のようになります。
```
"ServerlessV2ScalingConfiguration": {
"MinCapacity": 1.5,
"MaxCapacity": 24.0
}
```
**ヒント**
クラスターの作成時に最小および最大 ACU を指定しない場合は、後で `modify-db-cluster` コマンドを使用してその設定を追加できます。これを行うまでは、Aurora Serverless v2 DB インスタンスをクラスターに追加できません。`db.serverless` DB インスタンスを追加しようとした場合、エラーが発生します。
### API
RDS API を使用して Aurora Serverless v2 DB インスタンスと互換性のある DB クラスターを作成するには、「[Amazon Aurora DB クラスターの作成](Aurora.CreateInstance.md)」にある API の手順に従います。以下の設定を選択します。`CreateDBCluster` オペレーションに以下のパラメータが含まれていることを確認してください。
```
EngineVersion serverless_v2_compatible_engine_version
ServerlessV2ScalingConfiguration with MinCapacity=minimum_capacity and MaxCapacity=maximum_capacity
```
Aurora Serverless v2 のバージョンの要件の詳細については、「[Aurora Serverless v2 の要件と制限](aurora-serverless-v2.requirements.md)」を参照してください。容量範囲に許可される番号と、数字の意味については、「[Aurora Serverless v2 の容量](aurora-serverless-v2.how-it-works.md#aurora-serverless-v2.how-it-works.capacity)」および「[Aurora Serverless v2 でのパフォーマンスとスケーリング](aurora-serverless-v2.setting-capacity.md)」を参照してください。
既存のクラスターに容量設定が指定されているかどうかを確認するには、`ServerlessV2ScalingConfiguration` 属性 を `DescribeDBClusters` オペレーションの出力でチェックします。この属性は、以下の例のようになります。
```
"ServerlessV2ScalingConfiguration": {
"MinCapacity": 1.5,
"MaxCapacity": 24.0
}
```
**ヒント**
クラスターの作成時に最小および最大 ACU を指定しない場合は、後で `ModifyDBCluster` オペレーションを使用してその設定を追加できます。これを行うまでは、Aurora Serverless v2 DB インスタンスをクラスターに追加できません。`db.serverless` DB インスタンスを追加しようとした場合、エラーが発生します。
## Aurora Serverless v2 ライター DB インスタンスの作成
Aurora クラスターの作成時に Aurora Serverless v2 容量範囲を指定しますが、クラスター内の DB インスタンスごとに Aurora Serverless v2 を使用するかプロビジョンドを使用するかを選択できます。DB クラスターですぐに Aurora Serverless v2 の使用を開始するには、`db.serverless` インスタンスクラスを使用するライター DB インスタンスを追加します。コンソールでは、通常、DB クラスターを作成するワークフローの一部としてこの選択を行います。そのため、この手順は主に CLI を使用してセットアップを行う場合に適用されます。
### コンソール
AWS マネジメントコンソール を使用してDB クラスターを作成する場合は、ライター DB インスタンスのプロパティを同時に指定します。Aurora Serverless v2 を使用してライター DB インスタンスを作成するには、**サーバーレス** DB インスタンスクラスを選択します。
次に、Aurora 容量単位 (ACU) の最小値と最大値を指定し、クラスターの容量範囲を設定します。クラスター内の各 Aurora Serverless v2 DB インスタンスには、これらの最小値と最大値が適用されます。その手順と、最小容量設定と最大容量設定の重要性については、「[Aurora Serverless v2 DB クラスターの作成](#aurora-serverless-v2.create-cluster)」を参照してください。
クラスターを最初に作成するときに Aurora Serverless v2 DB インスタンスを作成しない場合、後で 1 つまたは複数の Aurora Serverless v2 DB インスタンスを追加できます。そのためには、「[Aurora Serverless v2 リーダーの追加](aurora-serverless-v2-administration.md#aurora-serverless-v2-adding-reader)」および「[プロビジョン済みライターまたはリーダーを Aurora Serverless v2 に変換する](aurora-serverless-v2-administration.md#aurora-serverless-v2-converting-from-provisioned)」の手順に従います。容量範囲は、クラスターに最初の Aurora Serverless v2 DB インスタンス容量を追加したときに指定します。「[Aurora Serverless v2 クラスターの容量設定](aurora-serverless-v2-administration.md#aurora-serverless-v2-setting-acus)」の手順に従って、容量範囲を後で変更できます。
### CLI
AWS CLI を使用して DB クラスター Aurora Serverless v2 を作成するとき、[create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) コマンドを使用して書き込み DB インスタンスを明示的に追加します。次のパラメータを含めます。
+ `--db-instance-class db.serverless`
以下の例は、書き込み DB インスタンス Aurora Serverless v2 の作成を示しています。
```
aws rds create-db-instance \
--db-cluster-identifier my-serverless-v2-cluster \
--db-instance-identifier my-serverless-v2-instance \
--db-instance-class db.serverless \
--engine aurora-mysql
```