# 使用适用于 PostgreSQL 的可信语言扩展的要求
<a name="PostgreSQL_trusted_language_extension-requirements"></a>

以下是设置和使用 TLE 开发套件的要求。
+ ** Aurora PostgreSQL 版本** – 仅在 Aurora PostgreSQL 版本 14.5 及更高的版本上支持可信语言扩展。
  + 如果您需要升级 Aurora PostgreSQL 数据库集群，请参阅[升级 Amazon Aurora PostgreSQL 数据库集群](USER_UpgradeDBInstance.PostgreSQL.md)。
  + 如果您还没有运行 PostgreSQL 的 Aurora 数据库集群，则可以创建一个。有关更多信息，请参阅 [创建 Aurora PostgreSQL 数据库集群并连接到该集群](CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.md)。
+ **需要 `rds_superuser` 权限** - 要设置和配置 `pg_tle` 扩展，您的数据库用户角色必须具有 `rds_superuser` 角色的权限。默认情况下，此角色被授予 `postgres` 用户，此用户创建 Aurora PostgreSQL 数据库集群 
+ **需要自定义数据库参数组** – 您的 Aurora PostgreSQL 数据库集群必须使用自定义数据库参数组进行配置。为 Aurora PostgreSQL 数据库集群的写入器实例使用自定义数据库参数组。
  + 如果未使用自定义数据库参数组配置您的 Aurora PostgreSQL 数据库集群，则应创建一个参数组并将其与 Aurora PostgreSQL 数据库集群的写入器实例相关联。有关步骤的简短摘要，请参阅 [创建和应用自定义数据库参数组](#PostgreSQL_trusted_language_extension-requirements-create-custom-params)。
  + 如果已经使用自定义数据库参数组配置了 Aurora PostgreSQL 数据库集群，则可以设置可信语言扩展。有关更多信息，请参阅 [在 Aurora PostgreSQL 数据库集群中设置可信语言扩展](PostgreSQL_trusted_language_extension-setting-up.md)。

## 创建和应用自定义数据库参数组
<a name="PostgreSQL_trusted_language_extension-requirements-create-custom-params"></a>

使用以下步骤创建自定义数据库参数组，并将 Aurora PostgreSQL 数据库集群配置为使用该参数组。

### 控制台
<a name="PostgreSQL_trusted_language_extension-requirements-custom-parameters.CON"></a>

**创建自定义数据库参数组并将其与您的 Aurora PostgreSQL 数据库集群一起使用**

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（数据库参数组）。
   + 对于 **Group name**（组名称），在操作上下文中为参数组指定一个有意义的名称。
   + 对于 **Description**（描述），输入有用的描述，以便团队中的其他人可以轻松找到它。

1. 选择**创建**。您的自定义数据库参数组是在您的 AWS 区域中创建的。现在，您可以按照以下步骤修改 Aurora PostgreSQL 数据库集群以使用它。

1. 从 Amazon RDS 菜单中选择 **Databases**（数据库）。

1. 从列出的列表中选择要与 TLE 结合使用的 Aurora PostgreSQL 数据库集群，然后选择 **Modify**（修改）。

1. 在 Modify DB cluster settings（修改数据库集群设置）页面中，找到 **Database options**（数据库选项），然后使用选择器选择您的自定义数据库参数组。

1. 选择 **Continue**（继续）以保存更改。

1. 选择 **Apply immediately**（立即应用），这样您就可以继续将 Aurora PostgreSQL 数据库集群设置为使用 TLE。

要继续为系统设置可信语言扩展，请参阅 [在 Aurora PostgreSQL 数据库集群中设置可信语言扩展](PostgreSQL_trusted_language_extension-setting-up.md)。

有关使用数据库集群和数据库参数组的更多信息，请参阅 [Amazon Aurora 数据库集群的数据库集群参数组](USER_WorkingWithDBClusterParamGroups.md)。

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

在使用 CLI 命令时，您可以通过将您的 AWS CLI 配置为使用默认 AWS 区域来避免指定 `--region` 参数。有关更多信息，请参阅《AWS Command Line Interface 用户指南》**中的[配置基础知识](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config)。

**创建自定义数据库参数组并将其与您的 Aurora PostgreSQL 数据库集群一起使用**

1. 使用 [create-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) AWS CLI 命令为您的 AWS 区域创建一个基于 aurora-postgresql14 的自定义数据库参数组。请注意，在此步骤中，您将创建数据库参数组，以应用于 Aurora PostgreSQL 数据库集群的写入器实例。

   对于 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 区域中可用，因此您可以修改 Aurora PostgreSQL 数据库集群的写入器实例以使用它。

1. 使用 [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) AWS CLI 命令将自定义数据库参数组应用于 Aurora PostgreSQL 数据库集群的写入器实例。此命令立即重启活动实例。

   对于 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
   ```

要继续为系统设置可信语言扩展，请参阅 [在 Aurora PostgreSQL 数据库集群中设置可信语言扩展](PostgreSQL_trusted_language_extension-setting-up.md)。

有关更多信息，请参阅 [Amazon Aurora 数据库实例的数据库参数组](USER_WorkingWithDBInstanceParamGroups.md)。