# Trusted Language Extensions for PostgreSQL を使用するための要件
<a name="PostgreSQL_trusted_language_extension-requirements"></a>

TLE 開発キットをセットアップして使用するための要件は次のとおりです。
+ ** Aurora PostgreSQL バージョン ** – Trusted Language Extensions は、Aurora PostgreSQL バージョン 14.5 以降のバージョンでのみサポートされています。
  + Aurora PostgreSQL DB クラスター、をアップグレードする必要がある場合は、「[Amazon Aurora PostgreSQL DB クラスターのアップグレード](USER_UpgradeDBInstance.PostgreSQL.md)」「」を参照してください。
  + PostgreSQL を実行している Aurora DB クラスター をまだ持っていない場合は作成できます。詳細については、「[Aurora PostgreSQL DB クラスターの作成と接続](CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.md)」を参照してください。
+ **`rds_superuser` 権限が必要です** - `pg_tle` 拡張機能をセットアップおよび設定するには、データベースユーザーロールに `rds_superuser` ロールのアクセス許可が必要です。デフォルトでは、このロールは Aurora PostgreSQL DB クラスターを作成する `postgres` ユーザーに付与されます。
+ **カスタム DB パラメータグループが必要です** – Aurora PostgreSQL DB クラスター には、カスタム DB パラメータグループを設定する必要があります。Aurora PostgreSQL DB クラスターのライターインスタンスに、カスタム DB パラメータグループを使用します。
  + Aurora PostgreSQL DB クラスター がカスタム DB パラメータグループで構成されていない場合は、カスタム DB パラメータグループを作成して Aurora PostgreSQL DB クラスターのライターインスタンスに関連付ける必要があります。ステップの簡単な概要については、「[カスタム DB パラメータグループの作成と適用](#PostgreSQL_trusted_language_extension-requirements-create-custom-params)」を参照してください。
  + Aurora PostgreSQL DB クラスター が、カスタム DB パラメータグループを使用して既に設定されている場合は、Trusted Language Extensions をセットアップできます。詳細については、「[Aurora PostgreSQL DB クラスター に Trusted Language Extensions を設定する](PostgreSQL_trusted_language_extension-setting-up.md)」を参照してください。

## カスタム DB パラメータグループの作成と適用
<a name="PostgreSQL_trusted_language_extension-requirements-create-custom-params"></a>

以下のステップを使用してカスタム DB パラメータグループを作成し、それを使用するように Aurora PostgreSQL DB クラスター を設定します。

### コンソール
<a name="PostgreSQL_trusted_language_extension-requirements-custom-parameters.CON"></a>

**カスタム DB パラメータグループを作成して、Aurora PostgreSQL DB クラスター で使用するには**

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

1. Amazon RDS メニューから [Parameter groups] (パラメータグループ) を選択します。

1. **[パラメータグループの作成]** を選択します。

1. **[Parameter group details]** (パラメータグループの詳細) ページで、次の情報を入力します。
   + **[Parameter group family]** (パラメータグループファミリー) で、[aurora-postgresql14.] を選択します
   + **[Type]** (タイプ) で、[DB Parameter Group] (DB パラメータグループ) を選択します。
   + **[Group name]** (グループ名) には、パラメータグループに操作の内容に合ったわかりやすい名前を付けます。
   + **[Description]** (説明) には、チームの他のメンバーが簡単に見つけられるように、わかりやすい説明を入力します。

1. **[作成]** を選択します。カスタム DB パラメータグループは AWS リージョン で作成されます。次のステップに従って、Aurora PostgreSQL DB クラスター を使用するように変更できるようになりました。

1. Amazon RDS メニューから **[Databases]** (データベース) を選択します。

1. 一覧から TLE で使用する Aurora PostgreSQL DB クラスター を選択し、**[Modify]** (変更) を選択します。

1. DB クラスター設定の変更ページで、**[Database options]** (データベースオプション) を見つけ、セレクターを使用してカスタム DB パラメータグループを選択します。

1. **[Continue]** (続行) を選択して、変更を保存します。

1. **[Apply immediately]** (すぐに適用) を選択すると、引き続き Aurora PostgreSQL DB クラスター を TLE を使用するようにセットアップできます。

Trusted Language Extensions のシステム設定を継続するには、「[Aurora PostgreSQL DB クラスター に Trusted Language Extensions を設定する](PostgreSQL_trusted_language_extension-setting-up.md)」を参照してください。

DB クラスターと DB パラメータグループの操作の詳細については、「[Amazon Aurora DB クラスターの DB クラスターパラメータグループ](USER_WorkingWithDBClusterParamGroups.md)」を参照してください。

### AWS CLI
<a name="PostgreSQL_trusted_language_extension-requirements-custom-parameters-CLI"></a>

AWS CLI をデフォルト AWS リージョン に設定することで、CLI コマンドを使用するときに `--region` 引数を指定しなくても済みます。詳細については、*AWS Command Line Interface ユーザーガイド*の「[設定の基本](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)」を参照してください。

**カスタム DB パラメータグループを作成して、Aurora PostgreSQL DB クラスター で使用するには**

1. [create-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) AWS CLI コマンドを使用して、AWS リージョン の aurora-postgresql14 をベースにしたカスタム DB パラメータグループを作成してください。このステップでは、Aurora PostgreSQL DB クラスターのライターインスタンスに適用する DB パラメータグループを作成することに注意してください。

   Linux、macOS、Unix の場合:

   ```
   aws rds create-db-parameter-group \
     --region {{aws-region}} \
     --db-parameter-group-name {{custom-params-for-pg-tle}} \
     --db-parameter-group-family aurora-postgresql14 \
     --description "My custom DB parameter group for Trusted Language Extensions"
   ```

   Windows の場合:

   ```
   aws rds create-db-parameter-group ^
     --region {{aws-region}} ^
     --db-parameter-group-name {{custom-params-for-pg-tle}} ^
     --db-parameter-group-family aurora-postgresql14 ^
     --description "My custom DB parameter group for Trusted Language Extensions"
   ```

   AWS リージョン でカスタム DB パラメータグループを使用できるため、Aurora PostgreSQL DB クラスター のライターインスタンスを変更してそれを使用できます。

1. [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLI コマンドを使用して、カスタム DB パラメータグループを Aurora PostgreSQL DB クラスターのライターインスタンスに適用します。このコマンドは、アクティブなインスタンスを直ちに再起動します。

   Linux、macOS、Unix の場合:

   ```
   aws rds modify-db-instance \
     --region {{aws-region}} \
     --db-instance-identifier {{your-writer-instance-name}} \
     --db-parameter-group-name {{custom-params-for-pg-tle}} \
     --apply-immediately
   ```

   Windows の場合:

   ```
   aws rds modify-db-instance ^
     --region {{aws-region}} ^
     --db-instance-identifier {{your-writer-instance-name}} ^
     --db-parameter-group-name {{custom-params-for-pg-tle}} ^
     --apply-immediately
   ```

Trusted Language Extensions のシステム設定を継続するには、「[Aurora PostgreSQL DB クラスター に Trusted Language Extensions を設定する](PostgreSQL_trusted_language_extension-setting-up.md)」を参照してください。

詳細については、「[Amazon Aurora DB インスタンスの DB パラメータグループ](USER_WorkingWithDBInstanceParamGroups.md)」を参照してください。