

# DB クラスターの作成
<a name="limitless-create-cluster"></a>

Aurora PostgreSQL Limitless Database を使用する Aurora PostgreSQL DB クラスターを作成するには、次の手順に従います。

AWS マネジメントコンソールまたは AWS CLI のいずれかを使用して、Aurora PostgreSQL Limitless Database を使用する DB クラスターを作成できます。プライマリ DB クラスターと DB シャードグループを作成します。

## コンソール
<a name="limitless-create-cluster.CON"></a>

AWS マネジメントコンソールを使用してプライマリ DB クラスターを作成する場合、DB シャードグループも同じ手順で作成されます。

**コンソールを使用して DB クラスターを作成するには**

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

1. [**データベースの作成**] を選択します。

   **[データベースの作成]** ページが表示されます。

1. **[エンジンタイプ]** として、**[Aurora (PostgreSQL 互換)]** を選択します。

1. **[バージョン]** で、次のいずれかを選択します。
   + **Aurora PostgreSQL with Limitless Database (PostgreSQL 16.4 互換)**
   + **Aurora PostgreSQL with Limitless Database (PostgreSQL 16.6 互換)**

1. **Aurora PostgreSQL Limitless Database** の場合:  
![\[Aurora PostgreSQL Limitless Database コンソールの設定と、シャーディングおよびディストリビューションパラメータの設定オプション。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/limitless_create_database.png)

   1. **[DB シャードグループ識別子]** を入力します。
**重要**  
DB シャードグループを作成した後は、DB クラスター識別子または DB シャードグループ識別子を変更することはできません。

   1. **[DB シャードグループのキャパシティ範囲]** では以下を行います。

      1. **[最小キャパシティ (ACU)]** を入力します。16 ACU 以上の値を使用します。

         開発環境の場合、デフォルト値は 16 ACU です。本番環境の場合、デフォルト値は 24 ACU です。

      1. **[最大キャパシティ (ACU)]** を入力します。16 ACU 以上、6144 ACU 以下の値を使用します。

         開発環境の場合、デフォルト値は 64 ACU です。本番環境の場合、デフォルト値は 384 ACU です。

      詳細については、「[DB シャードグループの最大容量と、作成されたルーターとシャードの数との相関性](limitless-cluster.md#limitless-capacity-mapping)」を参照してください。

   1. **[DB シャードグループのデプロイ]** では、DB シャードグループのスタンバイを作成するかどうかを選択します。
      + **コンピューティングの冗長性なし** — 各シャードのスタンバイなしで DB シャードグループを作成します。これは、デフォルト値です。
      + **単一のフェイルオーバーターゲットを使用したコンピューティングの冗長性** — 別のアベイラビリティーゾーン (AZ) に 1 つのコンピューティングスタンバイを持つ DB シャードグループを作成します。
      + **2 つのフェイルオーバーターゲットを使用したコンピューティングの冗長性** – 2 つの異なる AZ に 2 つのコンピューティングスタンバイを持つ DB シャードグループを作成します。
**注記**  
コンピューティングの冗長性をゼロ以外の値に設定すると、シャード DB インスタンスの合計数は 2 倍または 3 倍になります。これらの追加の DB インスタンスは、コンピューティングスタンバイであり、ライターインスタンスと同じ容量にスケールアップ/スケールダウンされます。スタンバイの容量範囲は個別に設定しません。したがって、ACU の使用量と請求は、それに応じて 2 倍および 3 倍になります。コンピューティングの冗長性で発生した ACU の正確な使用量については、[DBShardGroup メトリクス](limitless-monitoring.cw.md#limitless-monitoring.cw.DBShardGroup) の `DBShardGroupComputeRedundancyCapacity` メトリクスを参照してください。

   1. DB シャードグループをパブリックアクセス可能にするかどうかを選択します。
**注記**  
DB シャードグループの作成後にこの設定を変更することはできません。

1. **[接続]** で以下を行います。

   1. (オプション) **[EC2 コンピューティングリソースに接続する]** を選択し、既存の EC2 インスタンスを選択するか、新しいインスタンスを作成します。
**注記**  
EC2 インスタンスに接続する場合、DB シャードグループをパブリックアクセス可能にすることはできません。

   1. **[ネットワークタイプ]** で、**[IPv4]** または **[デュアルスタックモード]** を選択します。

   1. **[仮想プライベートクラウド (VPC)]** と **[DB サブネットグループ]** を選択するか、デフォルト設定を使用します。
**注記**  
米国東部 (バージニア北部) リージョンで Limitless Database DB クラスターを作成する場合は、DB サブネットグループに `us-east-1e` アベイラビリティーゾーン (AZ) を含めないでください。リソースの制限のため、Aurora Serverless v2 および Limitless Database は `us-east-1e` AZ ではサポートされていません。

   1. **[VPC セキュリティグループ (ファイアウォール)]** を選択するか、デフォルト設定を使用します。

1. **[データベース認証]** では、**[パスワード認証]** または **[パスワードと IAM データベース認証]** を選択します。

1. **[モニタリング]** では、**[Performance Insights をオンにする]** と **[拡張モニタリングの有効化]** チェックボックスがオンになっていることを確認します。

   Performance Insights では、少なくとも 1 か月の保持期間を選択します。

1. ページの下部の **[追加設定]** を展開します。

1. **[ログのエクスポート]** では、**[PostgreSQL ログ]** チェックボックスがオンになっていることを確認します。

1. 必要に応じて他の設定を指定します。詳細については、「[Aurora DB クラスターの設定](Aurora.CreateInstance.md#Aurora.CreateInstance.Settings)」を参照してください。

1. **[データベースの作成]** を選択します。

プライマリ DB クラスターと DB シャードグループが作成されると、**[データベース]** ページに表示されます。

![\[Aurora PostgreSQL Limitless Database のプライマリ DB クラスターと DB シャードグループ。\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/images/limitless_cluster_164.png)


## CLI
<a name="limitless-create-CLI"></a>

AWS CLI を使用して Aurora PostgreSQL Limitless Database を使用する DB クラスターを作成する場合、次のタスクを実行します。

1. [プライマリ DB クラスターを作成する](#limitless-create-CLI.cluster).

1. [DB シャードグループを作成する](#limitless-create-CLI.shard-group).

### プライマリ DB クラスターを作成する
<a name="limitless-create-CLI.cluster"></a>

DB クラスターを作成するには、以下のパラメータが必要です。
+ `--db-cluster-identifier` - DB クラスターの名前。
+ `--engine` – DB クラスターは `aurora-postgresql` DB エンジンを使用する必要があります。
+ `--engine-version` – DB クラスターは以下の DB エンジンバージョンのいずれかを使用する必要があります。
  + `16.4-limitless`
  + `16.6-limitless`
+ `--storage-type` – DB クラスターは `aurora-iopt1` DB クラスターストレージ設定を使用する必要があります。
+ `--cluster-scalability-type` – Aurora DB クラスターのスケーラビリティモードを指定します。`limitless` に設定すると、クラスターは Aurora PostgreSQL Limitless Database として動作します。`standard` (デフォルト) に設定すると、クラスターは通常の DB インスタンスの作成を使用します。
**注記**  
DB クラスターの作成後にこの設定を変更することはできません。
+ `--master-username` – DB クラスターのマスターユーザーの名前。
+ `--master-user-password` – マスターユーザーのパスワード。
+ `--enable-performance-insights` – Performance Insights を有効にする必要があります。
+ `--performance-insights-retention-period` – Performance Insights の保持期間は 31 日以上である必要があります。
+ `--monitoring-interval` – DB クラスターの拡張モニタリングメトリクスを収集するポイント間の間隔 (秒単位)。この値を `0` にすることはできません。
+ `--monitoring-role-arn` – RDS が拡張モニタリングメトリクスを Amazon CloudWatch Logs に送信することを許可する IAM ロールの Amazon リソースネーム (ARN)。
+ `--enable-cloudwatch-logs-exports` – CloudWatch Logs に `postgresql` ログをエクスポートする必要があります。

以下のパラメータはオプションです。
+ `--db-subnet-group-name` - DB クラスターに関連付ける DB サブネットグループ。これにより、DB クラスターに関連付けられた VPC も決定されます。
**注記**  
米国東部 (バージニア北部) リージョンで Limitless Database DB クラスターを作成する場合は、DB サブネットグループに `us-east-1e` アベイラビリティーゾーン (AZ) を含めないでください。リソースの制限のため、Aurora Serverless v2 および Limitless Database は `us-east-1e` AZ ではサポートされていません。
+ `--vpc-security-group-ids` – DB クラスターに関連付ける VPC セキュリティグループのリスト。
+ `--performance-insights-kms-key-id` – Performance Insights データを暗号化するための AWS KMS key 識別子。KMS キーを指定しない場合、AWS アカウントのデフォルトキーが使用されます。
+ `--region` – DB クラスターを作成する AWS リージョン。Aurora PostgreSQL Limitless Database をサポートするリージョンである必要があります。

デフォルトの VPC および VPC セキュリティグループを使用するには、`--db-subnet-group-name` および `--vpc-security-group-ids` オプションを省略します。

**プライマリ DB クラスターを作成するには**
+ 

  ```
  aws rds create-db-cluster \
      --db-cluster-identifier my-limitless-cluster \
      --engine aurora-postgresql \
      --engine-version 16.6-limitless \
      --storage-type aurora-iopt1 \
      --cluster-scalability-type limitless \
      --master-username myuser \
      --master-user-password mypassword \
      --db-subnet-group-name mysubnetgroup \
      --vpc-security-group-ids sg-c7e5b0d2 \
      --enable-performance-insights \
      --performance-insights-retention-period 31 \
      --monitoring-interval 5 \
      --monitoring-role-arn arn:aws:iam::123456789012:role/EMrole \
      --enable-cloudwatch-logs-exports postgresql
  ```

詳細については、「[create-db-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rds/create-db-cluster.html)」を参照してください。

### DB シャードグループを作成する
<a name="limitless-create-CLI.shard-group"></a>

次に、先ほど作成した DB クラスターに DB シャードグループを作成します。以下のパラメータは必須です。
+ `--db-shard-group-identifier` – DB シャードグループの名前。

  DB シャードグループ識別子には次の制約があります。
  + 作成する AWS アカウントと AWS リージョンで一意である必要があります。
  + 1～63 の英数字、またはハイフンを含む必要があります。
  + 1 字目は文字である必要があります。
  + 文字列の最後にハイフンを使用したり、ハイフンを 2 つ続けて使用したりすることはできません。
  + 
**重要**  
DB シャードグループを作成した後は、DB クラスター識別子または DB シャードグループ識別子を変更することはできません。
+ `--db-cluster-identifier` – DB シャードグループを作成する DB クラスターの名前。
+ `--max-acu` – DB シャードグループの最大容量。16～6144 ACU である必要があります。6144 ACU を超える容量制限については、AWS にお問い合わせください。

  ルーターとシャードの初期数は、DB シャードグループの作成時に設定した最大容量によって決まります。最大容量が大きいほど、DB シャードグループで作成されるルーターとシャードの数も大きくなります。詳細については、「[DB シャードグループの最大容量と、作成されたルーターとシャードの数との相関性](limitless-cluster.md#limitless-capacity-mapping)」を参照してください。

以下のパラメータはオプションです。
+ `--compute-redundancy` – DB シャードグループのスタンバイを作成するかどうか。このパラメータには以下の値があります。
  + `0` – 各シャードのスタンバイなしで DB シャードグループを作成します。これは、デフォルト値です。
  + `1` – 別のアベイラビリティーゾーン (AZ) に 1 つのコンピューティングスタンバイを持つ DB シャードグループを作成します。
  + `2` – 2 つの異なる AZ に 2 つのコンピューティングスタンバイを持つ DB シャードグループを作成します。
**注記**  
コンピューティングの冗長性をゼロ以外の値に設定すると、シャードの合計数は 2 倍または 3 倍になります。これにより、追加のコストが発生します。  
コンピューティングスタンバイのノードは、ライターと同じ容量にスケールアップ/スケールダウンされます。スタンバイの容量範囲は個別に設定しません。
+ `--min-acu` – DB シャードグループの最小容量。デフォルト値の 16 ACU 以上である必要があります。
+ `--publicly-accessible|--no-publicly-accessible` – パブリックにアクセス可能な IP アドレスを DB シャードグループに割り当てるかどうか。DB シャードグループへのアクセスは、クラスターで使用されるセキュリティグループによって制御されます。

  デフォルトは `--no-publicly-accessible` です。
**注記**  
DB シャードグループの作成後にこの設定を変更することはできません。

**DB シャードグループを作成するには**
+ 

  ```
  aws rds create-db-shard-group \
      --db-shard-group-identifier my-db-shard-group \
      --db-cluster-identifier my-limitless-cluster \
      --max-acu 1000
  ```