

# Requisitos para usar Trusted Language Extensions para PostgreSQL
<a name="PostgreSQL_trusted_language_extension-requirements"></a>

A seguir são apresentados os requisitos para configurar e usar o kit de desenvolvimento TLE.
+ ** Versões do Aurora PostgreSQL**: o Trusted Language Extensions só é compatível com o Aurora PostgreSQL versão 14.5 e versões posteriores.
  + Se você precisar atualizar seu cluster de banco de dados do Aurora PostgreSQL, consulte [Como atualizar os clusters de banco de dados de Amazon Aurora MySQL](USER_UpgradeDBInstance.PostgreSQL.md). 
  + Se você ainda não tem um cluster de banco de dados do Aurora, que execute o PostgreSQL, você pode criar um . Para ter mais informações, consulte [Criar um cluster de banco de dados do Aurora PostgreSQL e se conectar a ele](CHAP_GettingStartedAurora.CreatingConnecting.AuroraPostgreSQL.md).  
+ **Requer privilégios `rds_superuser`**: para instalar e configurar a extensão `pg_tle`, sua função de usuário do banco de dados deve ter as permissões da função `rds_superuser`. Por padrão, essa função é concedida ao usuário `postgres` que cria o cluster de banco de dados do Aurora PostgreSQL. 
+ **Requer um grupo de parâmetros de banco de dados personalizado**: seu cluster de banco de dados do Aurora PostgreSQL deve ser configurado com um grupo de parâmetros de banco de dados personalizado. Use o grupo de parâmetros de banco de dados personalizado para a instância de gravador de seu cluster de banco de dados do Aurora PostgreSQL. 
  + Se seu cluster de banco de dados do Aurora PostgreSQL não estiver configurado com um grupo de parâmetros de banco de dados personalizado, você deverá criar um e associá-lo à instância de gravador de seu cluster de banco de dados do Aurora PostgreSQL. Para obter um breve resumo das etapas, consulte [Criar e aplicar um grupo de parâmetros de banco de dados personalizado](#PostgreSQL_trusted_language_extension-requirements-create-custom-params).
  + Se seu cluster de banco de dados do Aurora PostgreSQL já estiver configurado usando um grupo de parâmetros de banco de dados, você poderá configurar o Trusted Language Extensions. Para obter detalhes, consulte [Configurar o Trusted Language Extensions em seu cluster de banco de dados do Aurora PostgreSQL](PostgreSQL_trusted_language_extension-setting-up.md).

## Criar e aplicar um grupo de parâmetros de banco de dados personalizado
<a name="PostgreSQL_trusted_language_extension-requirements-create-custom-params"></a>

Use as etapas a seguir para criar um grupo de parâmetros de banco de dados personalizado e configurar seu cluster de banco de dados do Aurora PostgreSQL para usá-lo. 

### Console
<a name="PostgreSQL_trusted_language_extension-requirements-custom-parameters.CON"></a>

**Como criar um grupo de parâmetros de banco de dados personalizado e usá-lo com o cluster de banco de dados do Aurora PostgreSQL**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Selecione Parameter groups (Grupos de parâmetros) no menu do Amazon RDS 

1. Escolha **Criar grupo de parâmetros**.

1. Na página **Parameter group details** (Detalhes do grupo de parâmetros), insira as informações a seguir.
   + Em **Parameter group family** (Família de grupos de parâmetros), selecione aurora-postgres14. 
   + Em **Type** (Tipo), selecione DB Parameter Group (Grupo de parâmetros de banco de dados).
   + Em **Group name** (Nome do grupo), forneça ao seu grupo de parâmetros um nome significativo no contexto de suas operações.
   + Em **Description** (Descrição), insira uma descrição útil para que outras pessoas de sua equipe possam encontrá-lo facilmente.

1. Escolha **Criar**. Seu grupo de parâmetros de banco de dados personalizado é criado em sua Região da AWS. Agora você pode modificar seu cluster de banco de dados do Aurora PostgreSQL para usá-lo seguindo as próximas etapas.

1. Selecione **Databases** (Bancos de dados) no menu do Amazon RDS.

1. Selecione o cluster de banco de dados do Aurora PostgreSQL que você deseja usar com o TLE dentre as opções listadas e, depois, selecione **Modify** (Modificar). 

1. Na página Modify DB cluster settings (Modificar configurações do cluster de banco de dados), encontre **Database options** (Opções de banco de dados) e use o seletor para selecionar seu grupo de parâmetros de banco de dados personalizado. 

1. Selecione **Continue** (Continuar) para salvar a alteração.

1. Selecione **Apply immediately** (Aplicar imediatamente) para que você possa continuar configurando o cluster de banco de dados do Aurora PostgreSQL para usar o TLE.

Para continuar configurando seu sistema para Trusted Language Extensions, consulte [Configurar o Trusted Language Extensions em seu cluster de banco de dados do Aurora PostgreSQL](PostgreSQL_trusted_language_extension-setting-up.md).

Para obter mais informações sobre como trabalhar com grupos de parâmetros de banco de dados e cluster de banco de dados, consulte [Grupos de parâmetros do cluster de banco de dados para clusters de banco de dados do Amazon Aurora](USER_WorkingWithDBClusterParamGroups.md). 

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

Você pode evitar especificar o argumento `--region` ao usar comandos da CLI configurando sua AWS CLI com sua Região da AWS padrão. Para obter mais informações, consulte [Conceitos básicos de configuração da ](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) no *Guia do usuário do AWS Command Line Interface*. 

**Como criar um grupo de parâmetros de banco de dados personalizado e usá-lo com o cluster de banco de dados do Aurora PostgreSQL**

1. Use o comando [create-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html) da AWS CLI para criar um grupo de parâmetros de banco de dados personalizado com base em aurora-postgresql14 para sua Região da AWS. Observe que nesta etapa você cria um grupo de parâmetros de banco de dados para aplicar à instância do gravador de seu cluster de banco de dados do Aurora PostgreSQL. 

   Para Linux, macOS ou 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"
   ```

   Para 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"
   ```

   Seu grupo de parâmetros de banco de dados personalizado está disponível em sua Região da AWS, para que você possa modificar a instância do gravador de seu cluster de banco de dados do Aurora PostgreSQL para usá-lo. 

1. Use o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da AWS CLI para aplicar seu grupo de parâmetros de banco de dados personalizado à instância do gravador de seu cluster de banco de dados do Aurora PostgreSQL. Esse comando reinicia imediatamente a instância ativa.

   Para Linux, macOS ou 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
   ```

   Para 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
   ```

Para continuar configurando seu sistema para Trusted Language Extensions, consulte [Configurar o Trusted Language Extensions em seu cluster de banco de dados do Aurora PostgreSQL](PostgreSQL_trusted_language_extension-setting-up.md).

Para ter mais informações, consulte [Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon Aurora](USER_WorkingWithDBInstanceParamGroups.md) . 