# Configurar uma instância de banco de dados do Amazon RDS
Esta seção mostra como configurar a instância de banco de dados do Amazon RDS. Antes de criar uma instância de banco de dados, decida sobre a classe de instância de banco de dados que executará a instância de banco de dados. Além disso, decida em que local a instância de banco de dados será executada escolhendo uma região da AWS. Depois, crie a instância de banco de dados.
Você pode configurar uma instância de banco de dados com um grupo de opções e um grupo de parâmetros de banco de dados.
+ Um *grupo de opções* pode especificar recursos, chamados de opções, que estão disponíveis para uma determinada instância de banco de dados do Amazon RDS.
+ Um *grupo de parâmetros de banco de dados* atua como um contêiner para valores de configuração de mecanismo que são aplicados a uma ou mais instâncias de bancos de dados.
As opções e parâmetros disponíveis dependem do mecanismo de banco de dados e da versão do mecanismo de banco de dados. Você pode especificar um grupo de opções e um grupo de parâmetros de banco de dados ao criar uma instância de banco de dados. Você também pode modificar uma instância de banco de dados para especificá-los.
**Topics**
+ [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md)
+ [Criar recursos do Amazon RDS com o AWS CloudFormation](creating-resources-with-cloudformation.md)
+ [Conectar a uma instância de banco de dados do Amazon RDS](CHAP_CommonTasks.Connect.md)
+ [Trabalhar com grupos de opções](USER_WorkingWithOptionGroups.md)
+ [Grupos de parâmetros para Amazon RDS](USER_WorkingWithParamGroups.md)
+ [Criar um cache do Amazon ElastiCache usando as configurações da instância de banco de dados do Amazon RDS](creating-elasticache-cluster-with-RDS-settings.md)
+ [Migração automática de bancos de dados do EC2 para o Amazon RDS usando o AWS Database Migration Service](USER_DMS_migration.md)
+ [Tutorial: criar uma instância de banco de dados do MySQL com um grupo de parâmetros personalizadoe um novo grupo de opções](tutorial-creating-custom-OPG.md)
# Criar uma instância de banco de dados do Amazon RDS
O bloco de construção básico do Amazon RDS é a instância de banco de dados, onde você cria os bancos de dados. Você escolhe as características específicas do mecanismo da instância de banco de dados ao criá-la. Você também escolhe a capacidade de armazenamento, CPU, memória e assim por diante, da instância AWS em que o servidor de banco de dados é executado.
**Topics**
+ [Pré-requisitos da instância de banco de dados](#USER_CreateDBInstance.Prerequisites)
+ [Criar uma instância de banco de dados](#USER_CreateDBInstance.Creating)
+ [Configurações para instâncias de banco de dados](USER_CreateDBInstance.Settings.md)
## Pré-requisitos da instância de banco de dados
**Importante**
É necessário concluir as tarefas em [Configuração do ambiente do Amazon RDS](CHAP_SettingUp.md) antes de criar uma instância de banco de dados do Amazon RDS.
Veja a seguir os pré-requisitos para a criação de um cluster de banco de dados do .
**Topics**
+ [Configurar a rede para a instância de banco de dados](#USER_CreateDBInstance.Prerequisites.VPC)
+ [Pré-requisitos adicionais](#USER_CreateDBInstance.Prerequisites.Additional)
### Configurar a rede para a instância de banco de dados
Só é possível criar uma instância de banco de dados do Amazon RDS em uma nuvem privada virtual (VPC) com base no serviço da Amazon VPC. Além disso, ele deve estar em uma Região da AWS que tenha pelo menos duas zonas de disponibilidade. O grupo de sub-redes do banco de dados escolhido para a instância de banco de dados deve incluir pelo menos duas zonas de disponibilidade. Essa configuração garante que você possa configurar uma implantação multi-AZ ao criar a instância de banco de dados ou migrar facilmente para uma no futuro.
Para configurar a conectividade entre sua nova instância de banco de dados e uma instância do Amazon EC2 na mesma VPC, faça isso durante a criação da instância. Para se conectar à instância de banco de dados usando recursos que não sejam instâncias do EC2 na mesma VPC, configure as conexões de rede manualmente.
**Topics**
+ [Configurar a conectividade automática de rede com uma instância do EC2](#USER_CreateDBInstance.Prerequisites.VPC.Automatic)
+ [Configurar a rede manualmente](#USER_CreateDBInstance.Prerequisites.VPC.Manual)
#### Configurar a conectividade automática de rede com uma instância do EC2
Ao criar uma instância de banco de dados do RDS, use o Console de gerenciamento da AWS para configurar a conectividade entre uma instância do EC2 e a nova instância de banco de dados. Quando você faz isso, o RDS configura suas definições de VPC e rede automaticamente. A instância de banco de dados é criada na mesma VPC da instância do EC2 para que esta possa acessar a instância de banco de dados.
Confira a seguir os requisitos para conectar uma instância do EC2 à instância de banco de dados:
+ A instância do EC2 deve existir na Região da AWS antes da criação da instância de banco de dados.
Se não houver nenhuma instância do EC2 na Região da AWS, o console fornecerá um link para que você crie uma.
+ O usuário que está criando a instância de banco de dados deve ter permissões para realizar as seguintes operações:
+ `ec2:AssociateRouteTable`
+ `ec2:AuthorizeSecurityGroupEgress`
+ `ec2:AuthorizeSecurityGroupIngress`
+ `ec2:CreateRouteTable`
+ `ec2:CreateSubnet`
+ `ec2:CreateSecurityGroup`
+ `ec2:DescribeInstances`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:DescribeRouteTables`
+ `ec2:DescribeSecurityGroups`
+ `ec2:DescribeSubnets`
+ `ec2:ModifyNetworkInterfaceAttribute`
+ `ec2:RevokeSecurityGroupEgress`
Usar essa opção cria uma instância de banco de dados privada. A instância de banco de dados usa um grupo de sub-redes de banco de dados somente com sub-redes privadas para restringir o acesso aos recursos da VPC.
Para conectar uma instância do EC2 à instância de banco de dados, escolha **Connect to an EC2 compute resource** (Conectar-se a um recurso de computação do EC2) na seção **Connectivity** (Conectividade) da página **Create database** (Criar banco de dados).
![\[Conectar uma instância do EC2\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/ec2-set-up-connection-create.png)
Quando você escolhe **Connect to an EC2 compute resource** (Conectar-se a um recurso de computação do EC2), o RDS define as opções a seguir automaticamente. Você não pode alterar essas configurações, a menos que opte por não configurar a conectividade com uma instância do EC2 escolhendo **Don't connect to an EC2 compute resource** (Não conectar a um recurso de computação do EC2).
****
| Opção do console | Configuração automática |
| --- | --- |
| **Tipo de rede** | O RDS define o tipo de rede como **IPv4**. No momento, o modo de pilha dupla não é compatível quando você configura uma conexão entre uma instância do EC2 e a instância de banco de dados. |
| **Nuvem privada virtual (VPC)** | O RDS define a VPC como aquela associada à instância do EC2. |
| **Grupo de sub-rede de banco de dados** | O RDS requer um grupo de sub-redes de banco de dados com uma sub-rede privada na mesma zona de disponibilidade da instância do EC2. Se existir um grupo de sub-redes de banco de dados que atenda a esse requisito, o RDS usará o grupo de sub-redes de banco de dados existente. Por padrão, essa opção está definida como Automatic setup (Configuração automática). Quando você escolhe **Automatic setup** (Configuração automática) e não há nenhum grupo de sub-redes de banco de dados que atenda a esse requisito, ocorre a ação a seguir. O RDS usa três sub-redes privadas disponíveis em três zonas de disponibilidade, das quais uma é a mesma da instância do EC2. Se não houver uma sub-rede privada disponível em uma zona de disponibilidade, o RDS criará uma sub-rede privada na zona de disponibilidade. O RDS cria o grupo de sub-redes de banco de dados.Quando houver uma sub-rede privada disponível, o RDS usará a tabela de rotas associada a ela e adicionará todas as sub-redes que criar a essa tabela de rotas. Quando não houver nenhuma sub-rede privada disponível, o RDS criará uma tabela de rotas sem acesso ao gateway da Internet e adicionará as sub-redes que criar à tabela de rotas.O RDS também permite que você use grupos de sub-redes de banco de dados existentes. Selecione **Choose existing** (Selecionar existente) se quiser usar um grupo de sub-redes de banco de dados existente de sua escolha. |
| **Acesso público** | O RDS escolhe **No** (Não) para que a instância de banco de dados não fique acessível ao público. Por motivos de segurança, é uma prática recomendada manter o banco de dados privado e garantir que ele não seja acessado pela Internet. |
| **Grupo de segurança da VPC (firewall)** | O RDS cria um grupo de segurança associado à instância de banco de dados. O grupo de segurança é chamado de `rds-ec2-n`, em que `n` é um número. Esse grupo de segurança inclui uma regra de entrada com o grupo de segurança da VPC do EC2 (firewall) como origem. Esse grupo de segurança associado à instância de banco de dados permite que a instância do EC2 acesse a respectiva instância. O RDS também cria um grupo de segurança associado à instância do EC2. O grupo de segurança é chamado de `ec2-rds-n`, em que `n` é um número. Esse grupo de segurança inclui uma regra de saída no grupo de segurança da VPC da instância de banco de dados como origem. Esse grupo de segurança permite que a instância do EC2 envie tráfego à instância de banco de dados. Para adicionar outro novo grupo de segurança, escolha **Create new** (Criar novo) e digite o nome do novo grupo de segurança. Para adicionar grupos de segurança existentes, escolha **Choose existing** (Escolher existente) e selecione os grupos de segurança que deseja adicionar. |
| **Zona de disponibilidade** | Quando você escolher **Single DB instance** (Instância de banco de dados única) em **Availability & durability** (Disponibilidade e durabilidade) (implantação single-AZ), o RDS escolherá a zona de disponibilidade da instância do EC2. Quando você escolher **Multi-AZ DB instance** (Instância de banco de dados multi-AZ) em **Availability & durability** (Disponibilidade e durabilidade) (implantação de instância de banco de dados multi-AZ), o RDS escolherá a zona de disponibilidade da instância do EC2 para uma instância de banco de dados da implantação. O RDS escolhe aleatoriamente uma zona de disponibilidade diferente para a outra instância de banco de dados. A instância de banco de dados primária ou a réplica de espera é criada na mesma zona de disponibilidade da instância do EC2. Quando você escolhe **Multi-AZ DB instance** (Instância de banco de dados multi-AZ), existe a possibilidade de custos entre zonas de disponibilidade se a instância de banco de dados e a instância do EC2 estiverem em zonas de disponibilidade diferentes. |
Para ter mais informações sobre essas configurações, consulte [Configurações para instâncias de banco de dados](USER_CreateDBInstance.Settings.md).
Se você alterar essas configurações depois da criação da instância de banco de dados, as alterações poderão afetar a conexão entre a instância do EC2 e a instância de banco de dados.
#### Configurar a rede manualmente
Para se conectar à instância de banco de dados usando recursos que não sejam instâncias do EC2 na mesma VPC, configure as conexões de rede manualmente. Se você usar o Console de gerenciamento da AWS para criar a instância de banco de dados, o Amazon RDS poderá criar automaticamente uma VPC para você. Como alternativa, você pode usar a VPC existente ou criar uma VPC para sua instância de banco de dados. Com qualquer abordagem, sua VPC requer pelo menos uma sub-rede de cada em pelo menos duas zonas de disponibilidade para você usá-la com uma instância de banco de dados do RDS.
Por padrão, o Amazon RDS cria automaticamente a instância de banco de dados em uma zona de disponibilidade para você. Para escolher uma zona de disponibilidade específica, altere a configuração **Availability & durability** (Disponibilidade e durabilidade) para **Single DB instance** (Instância de banco de dados única). Essa ação exibe uma configuração de **Availability Zone** (Zona de disponibilidade) que permite escolher entre as zonas de disponibilidade em sua VPC. No entanto, se você escolher uma implantação multi-AZ, o RDS escolherá automaticamente a zona de disponibilidade da instância de banco de dados primária ou gravadora, e a configuração **Availability Zone** (Zona de disponibilidade) não será exibida.
Em alguns casos, você pode não ter uma VPC padrão ou não ter criado uma VPC. Nesses casos, o Amazon RDS pode criar automaticamente uma VPC para você ao criar uma instância de bancos de dados utilizando o console. Caso contrário, faça o seguinte:
+ Crie uma VPC com com no mínimo uma sub-rede em pelo menos duas das zonas de disponibilidade na Região da AWS em que você deseja implantar a instância de banco de dados. Para obter mais informações, consulte [Trabalhar com uma instância de banco de dados em uma VPC](USER_VPC.WorkingWithRDSInstanceinaVPC.md#Overview.RDSVPC.Create) e [Tutorial: Criar uma VPC para usar com uma instância de banco de dados (somente IPv4)](CHAP_Tutorials.WebServerDB.CreateVPC.md).
+ Especifique um grupo de segurança da VPC que autorize conexões à sua instância de banco de dados. Para obter mais informações, consulte [Fornecer acesso à instância de banco de dados na VPC criando um grupo de segurança](CHAP_SettingUp.md#CHAP_SettingUp.SecurityGroup) e [Controlar acesso com grupos de segurança](Overview.RDSSecurityGroups.md).
+ Especifique um grupo de sub-rede de banco de dados do RDS que defina pelo menos duas sub-redes na VPC as quais possam ser usadas pela instância de banco de dados. Para obter mais informações, consulte [Trabalhar com grupos de sub-redes de banco de dados](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets).
Se você quiser se conectar a um recurso que não esteja na mesma VPC que a instância de banco de dados, veja os cenários apropriados em [Cenários para acessar uma instância de banco de dados em uma VPC](USER_VPC.Scenarios.md).
### Pré-requisitos adicionais
Antes de criar a instância de banco de dados, considere os seguintes pré-requisitos adicionais:
+ Se você estiver se conectando à AWS utilizando credenciais do AWS Identity and Access Management (IAM), sua conta da AWS deverá ter determinadas políticas do IAM. Elas concedem as permissões necessárias para realizar operações do Amazon RDS. Para obter mais informações, consulte [Gerenciamento de identidade e acesso no Amazon RDS](UsingWithRDS.IAM.md).
Para utilizar o IAM para acessar o console do RDS, faça login no Console de gerenciamento da AWS com suas credenciais de usuário do IAM. Depois, acesse o console do Amazon RDS em [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
+ Para personalizar os parâmetros de configuração de sua instância de banco de dados, especifique um grupo de parâmetros de banco de dados com as configurações de parâmetro necessárias. Para obter informações sobre como criar ou modificar um grupo de parâmetros de banco de dados, consulte [Grupos de parâmetros para Amazon RDS](USER_WorkingWithParamGroups.md).
**Importante**
Se você estiver usando o modelo BYOL para o Amazon RDS para Db2, antes de criar uma instância de banco de dados, primeiro crie um grupo de parâmetros personalizado que contenha o IBM Site ID e o IBM Customer ID. Para obter mais informações, consulte [Traga a sua própria licença (BYOL) para o Db2](db2-licensing.md#db2-licensing-options-byol).
+ Determine o número de porta de TCP/IP a ser especificado para sua instância de banco de dados. Em algumas empresas, os firewalls bloqueiam conexões com as portas padrão para instâncias de banco de dados do RDS. Se o firewall da sua empresa bloquear a porta padrão, escolha outra porta para a instância de banco de dados. As portas padrão para os mecanismos de banco de dados do Amazon RDS são:
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html)
Para o RDS para SQL Server, as seguintes portas são reservadas, e não é possível usá-las ao criar uma instância de banco de dados: `1234, 1434, 3260, 3343, 3389, 47001,` e `49152-49156`.
## Criar uma instância de banco de dados
Você pode criar e modificar uma instância de banco de dados do Amazon RDS usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.
**nota**
Em relação ao RDS para Db2, recomendamos configurar os itens necessários para o modelo de licença antes de criar uma instância de banco de dados do RDS para Db2. Para obter mais informações, consulte [Opções de licenciamento do Amazon RDS para Db2](db2-licensing.md).
### Console
É possível criar uma instância de banco de dados usando o Console de gerenciamento da AWS com a opção **Easy Create** (Criação fácil) habilitada ou não. Com a **Easy create** (Criação fácil) habilitada, você especifica apenas o tipo de mecanismo de banco de dados, o tamanho da instância de banco de dados e o identificador da instância de banco de dados. A **Easy create** (Criação fácil) usa a configuração padrão para outras opções de configuração. Com a **Easy create** (Criação fácil) desabilitada, você especifica mais opções de configuração ao criar um banco de dados, incluindo as de disponibilidade, segurança, backups e manutenção.
**nota**
No procedimento a seguir, a opção **Standard Create** (Criação padrão) está habilitada e **Easy Create** (Criação fácil) não está habilitada. Este procedimento usa o Microsoft SQL Server como exemplo.
Para obter exemplos que usam a **Easy Create** (Criação fácil) para orientar você a criar e conectar a instâncias de banco de dados de exemplo para cada mecanismo, consulte [Conceitos básicos do Amazon RDS](CHAP_GettingStarted.md).
**Como criar uma instância de banco de dados**
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. No canto superior direito do console do Amazon RDS, escolha a região da AWS na qual você deseja criar a instância de banco de dados.
1. No painel de navegação, escolha **Databases (Bancos de dados)**.
1. Selecione **Criar banco de dados** e escolha **Criação padrão**.
1. Em **Tipo de mecanismo**, selecione IBM Db2, MariaDB, Microsoft SQL Server, MySQL, Oracle ou PostgreSQL.
O **Microsoft SQL Server** é exibido aqui.
![\[Seleção do mecanismo\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/create-instance-sqlserver.png)
1. Em **Tipo de gerenciamento de banco de dados**, se você estiver usando Oracle ou SQL Server, escolha **Amazon RDS** ou **Amazon RDS Custom**.
O **Amazon RDS** é exibido aqui. Para saber mais sobre o RDS Custom, consulte [Amazon RDS Custom](rds-custom.md).
1. Para **Edição**, se você estiver usando Db2, Oracle ou SQL Server, selecione a edição do mecanismo de banco de dados que deseja usar.
O MySQL tem apenas uma opção para a edição e MariaDB e PostgreSQL não têm opções.
1. Em **Version (Versão)**, escolha a versão do mecanismo.
1. Em **Templates (Modelos)**, escolha o modelo que corresponde ao seu caso de uso. Se você escolher **Production (Produção)**, as seguintes opções serão pré-selecionadas em uma etapa posterior:
+ Opção de failover **multi-AZ**
+ Opção de armazenamento **Provisioned IOPS** (IOPS provisionadas)
+ Opção **Enable deletion protection (Habilitar proteção contra exclusão)**
Recomendamos essas características para qualquer ambiente de produção.
**nota**
As escolhas de modelo variam de acordo com a edição.
1. Na seção **Settings** (Configurações), abra **Credential Settings** (Configurações de credencial). Faça o seguinte:
1. (Opcional) Altere o valor **Master username** (Nome de usuário primário).
1. Escolha uma das seguintes opções de gerenciamento de credenciais:
+ **Gerenciado no AWS Secrets Manager**
Em **Selecionar a chave de criptografia**, escolha uma chave do KMS que o Secrets Manager cria ou uma chave que você criou.
**nota**
Recomendamos o AWS Secrets Manager como a técnica mais segura para gerenciar credenciais. Aplicam-se cobranças adicionais. Para obter mais informações, consulte [Gerenciamento de senhas com Amazon RDS e AWS Secrets Manager](rds-secrets-manager.md).
+ **Autogerenciado**
Para especificar uma senha, desmarque a caixa de seleção **Gerar uma senha automaticamente** se ela estiver marcada. Insira a mesma senha em **Senha primária** e **Confirmar senha**.
1. (Opcional) Configure uma conexão com um recurso de computação para essa instância de banco de dados.
Você pode configurar a conectividade entre uma instância do Amazon EC2 e a nova instância de banco de dados durante a criação da instância. Para obter mais informações, consulte [Configurar a conectividade automática de rede com uma instância do EC2](#USER_CreateDBInstance.Prerequisites.VPC.Automatic).
1. Na seção **Conectividade** em **Grupo de segurança da VPC (firewall)**, se você selecionar **Criar**, um grupo de segurança da VPC será criado com uma regra de entrada que permite que o endereço IP do computador local acesse o banco de dados.
1. Nas seções restantes, especifique suas configurações de instância de banco de dados. Para obter informações sobre cada configuração, consulte [Configurações para instâncias de banco de dados](USER_CreateDBInstance.Settings.md).
1. Escolha **Create database (Criar banco de dados)**.
Se você optar por usar uma senha gerada automaticamente, o botão **View credential details (Ver detalhes da credencial)** será exibido na página **Databases (Bancos de dados)**.
Para exibir o nome de usuário mestre e a senha da instância de banco de dados, escolha **View credential details (Ver detalhes da credencial)**.
Para se conectar à instância de banco de dados como o usuário mestre, use o nome de usuário e a senha exibidos.
**Importante**
Você não pode visualizar a senha do usuário principal novamente. Caso você não a registre, talvez seja necessário alterá-la. Se for necessário alterar a senha do usuário mestre depois que a instância de banco de dados estiver disponível, modifique a instância de banco de dados para fazer isso. Para obter mais informações sobre a modificação de uma instância de banco de dados , consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
1. Em **Databases (Bancos de dados)**, escolha o nome da nova instância de banco de dados.
No console do RDS, os detalhes para a nova instância de banco de dados são exibidos. A instância de banco de dados fica com o status **Creating (Criando)** até que esteja criada e pronta para uso. Quando o status muda para **Available (Disponível)**, você pode se conectar à instância de banco de dados. Dependendo da classe da instância de banco de dados e do armazenamento alocado, pode levar alguns minutos até que a nova instância fique disponível.
![\[Meus detalhes de instâncias de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/SQLSvr-Launch05.png)
### AWS CLI
**nota**
Se quiser usar a licença do Db2 por meio do AWS Marketplace, é necessário primeiro assinar o AWS Marketplace e cadastrar-se na IBM usando o Console de gerenciamento da AWS. Para obter mais informações, consulte [Assinar ofertas do Db2 Marketplace e cadastrá-las na IBM](db2-licensing.md#db2-marketplace-subscribing-registering).
Para criar uma instância de banco de dados utilizando a AWS CLI, chame o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) com os seguintes parâmetros:
+ `--db-instance-identifier`
+ `--db-instance-class`
+ `--vpc-security-group-ids`
+ `--db-subnet-group`
+ `--engine`
+ `--master-username`
+ `--master-user-password` ou `--manage-master-user-password`
+ `--allocated-storage`
+ `--backup-retention-period`
Para obter informações sobre cada configuração, consulte [Configurações para instâncias de banco de dados](USER_CreateDBInstance.Settings.md).
Este exemplo usa o Microsoft SQL Server.
**Example**
Para Linux, macOS ou Unix:
```
1. aws rds create-db-instance \
2. --engine sqlserver-se \
3. --db-instance-identifier mymsftsqlserver \
4. --allocated-storage 250 \
5. --db-instance-class db.t3.large \
6. --vpc-security-group-ids mysecuritygroup \
7. --db-subnet-group mydbsubnetgroup \
8. --master-username masterawsuser \
9. --manage-master-user-password \
10. --backup-retention-period 3
```
Para Windows:
```
1. aws rds create-db-instance ^
2. --engine sqlserver-se ^
3. --db-instance-identifier mydbinstance ^
4. --allocated-storage 250 ^
5. --db-instance-class db.t3.large ^
6. --vpc-security-group-ids mysecuritygroup ^
7. --db-subnet-group mydbsubnetgroup ^
8. --master-username masterawsuser ^
9. --manage-master-user-password ^
10. --backup-retention-period 3
```
O comando gerará uma saída semelhante à seguinte:
```
1. DBINSTANCE mydbinstance db.t3.large sqlserver-se 250 sa creating 3 **** n 10.50.2789
2. SECGROUP default active
3. PARAMGRP default.sqlserver-se-14 in-sync
```
### API do RDS
**nota**
Se quiser usar a licença do Db2 por meio do AWS Marketplace, é necessário primeiro assinar o AWS Marketplace e cadastrar-se na IBM usando o Console de gerenciamento da AWS. Para obter mais informações, consulte [Assinar ofertas do Db2 Marketplace e cadastrá-las na IBM](db2-licensing.md#db2-marketplace-subscribing-registering).
Para criar uma instância de banco de dados utilizando a API do Amazon RDS, chame a operação [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) com os seguintes parâmetros.
Para obter informações sobre cada configuração, consulte [Configurações para instâncias de banco de dados](USER_CreateDBInstance.Settings.md).
# Configurações para instâncias de banco de dados
Na tabela a seguir, veja detalhes sobre as configurações que você escolhe ao criar uma instância de banco de dados. A tabela também exibe os mecanismos de banco de dados para cada configuração compatível.
É possível criar uma instância de banco de dados utilizando o console, o comando [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) da CLI ou a operação da API [CreateDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html) do RDS.
****
| Configuração do console | Descrição da configuração | Opção da CLI e parâmetro da API do RDS | Mecanismos de banco de dados com suporte |
| --- | --- | --- | --- |
| **Armazenamento alocado** | O valor de armazenamento a ser alocado para a sua instância de banco de dados (em gigabytes). Em alguns casos, alocar uma quantidade de armazenamento para a instância de banco de dados maior do que o tamanho do banco de dados pode melhorar a performance de E/S. Para obter mais informações, consulte [Armazenamento de instâncias de banco de dados do Amazon RDS](CHAP_Storage.md). | **Opção da CLI:** `--allocated-storage` **Parâmetro da API:** `AllocatedStorage` | Tudo |
| Configurações de arquitetura | Se você escolher **Use multitenant architecture (Usar arquitetura multilocatário)**, o RDS for Oracle criará um banco de dados de contêiner (CDB). Se você não escolher essa opção, o RDS for Oracle criará um não CDB. Um não CDB usa a arquitetura Oracle tradicional. Um não CDB não pode conter bancos de dados conectáveis (PDBs). O Oracle Database 21c usa somente arquitetura CDB. O Oracle Database 19c pode usar arquitetura CDB ou não CDB. Versões anteriores do Oracle Database 19c usam somente não CDB. Para obter mais informações, consulte [Visão geral dos CDBs RDS para Oracle](Oracle.Concepts.CDBs.md). | **Opção da CLI:** Oracle Multilocatário Oracle Multilocatário `--engine oracle-ee` (tradicional) `--engine oracle-se2` (tradicional) **Parâmetro da API:** `Engine` | Oracle |
| Configuração de arquitetura | Essas configurações são válidas somente quando você escolhe a **arquitetura multilocatária Oracle** para configurações de **arquitetura**. Escolha uma das seguintes opções: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Independentemente da configuração escolhida, seu CDB contém um único PDB inicial. Na configuração de vários locatários, você pode criar mais PDBs posteriormente usando as APIs do RDS. Para obter mais informações, consulte [Visão geral dos CDBs RDS para Oracle](Oracle.Concepts.CDBs.md). | **Opção da CLI:** Configuração de locação múltipla Configuração de locatário único **Parâmetro da API:** `MultiTenant` | Oracle |
| Atualização da versão secundária automática | Selecione **Habilitar o upgrade automático da versão secundária** para permitir que a instância de banco de dados receba automaticamente atualizações da versão do mecanismo de banco de dados secundário preferencial quando elas forem disponibilizadas. Esse é o comportamento padrão. O Amazon RDS executa atualizações automáticas de versões secundárias na janela de manutenção. Se você não selecionar **Habilitar o upgrade automático da versão secundária**, a instância de banco de dados não será atualizada automaticamente quando novas versões secundárias forem disponibilizadas. Para obter mais informações, consulte [Atualizar automaticamente a versão do mecanismo espelho](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.AutoMinorVersionUpgrades). | **Opção da CLI:** `--auto-minor-version-upgrade` `--no-auto-minor-version-upgrade` **Parâmetro da API:** `AutoMinorVersionUpgrade` | Tudo |
| Zona de disponibilidade | A zona de disponibilidade da sua instância de banco de dados. Use o valor padrão de **No Preference (Sem preferência)**, a menos que você queira especificar uma zona de disponibilidade. Para obter mais informações, consulte [Regiões, zonas de disponibilidade e Local Zones](Concepts.RegionsAndAvailabilityZones.md). | **Opção da CLI:** `--availability-zone` **Parâmetro da API:** `AvailabilityZone` | Tudo |
| **AWS KMS key** | Disponível apenas quando **Encryption** (Criptografia) estiver definido como **Enable encryption** (Habilitar criptografia). Selecione a AWS KMS key a ser usada para criptografar esta instância de banco de dados. Para obter mais informações, consulte [Criptografar recursos do Amazon RDS](Overview.Encryption.md). | **Opção da CLI:** `--kms-key-id` **Parâmetro da API:** `KmsKeyId` | Tudo |
| AWS License Manager Configuração da | Insira um nome para uma configuração da licença da AWS License Manager. O nome deve ter 100 caracteres ou menos e incluir apenas a-z, A-Z e 0-9. Para obter mais informações, consulte [Integração com o AWS License Manager](db2-licensing.md#db2-lms-integration). | **Opção da CLI:** Para obter mais informações, consulte [AWS License Manager CLI](db2-licensing.md#db2-lms-integration.cli). **Parâmetro da API:** Para obter mais informações, consulte [AWS License ManagerAPI](db2-licensing.md#db2-lms-integration.api). | Db2 |
| Backup replication (Replicação de backup | Selecione **Habilitar a replicação em outra região da AWS** para criar backups em uma região adicional para recuperação de desastres. Em seguida, escolha a **Destination Region (Região de destino)** para os backups adicionais. | Não disponível ao criar uma instância de banco de dados. Para obter informações sobre como ativar backups entre regiões usando a AWS CLI ou a API do RDS, consulte [Habilitar backups automatizados entre regiões para o Amazon RDS](AutomatedBackups.Replicating.Enable.md). | Db2 Oracle PostgreSQL SQL Server |
| Período de retenção de backup | O número de dias que você deseja que os backups automáticos da sua instância de banco de dados fiquem retidos. Para instâncias de banco de dados incomuns, defina esse valor como **1** ou maior. Para obter mais informações, consulte [Introdução aos backups](USER_WorkingWithAutomatedBackups.md). | **Opção da CLI:** `--backup-retention-period` **Parâmetro da API:** `BackupRetentionPeriod` | Tudo |
| Destino de backup | Escolha **Nuvem AWS** para armazenar backups automatizados e snapshots manuais na região da AWS principal: Escolha **Outposts (on-premises)** para armazená-los localmente no seu Outpost. Essa configuração de opção se aplica somente ao RDS on Outposts. Para obter mais informações, consulte [Criar instâncias de banco de dados para o Amazon RDS on AWS Outposts](rds-on-outposts.creating.md). | **Opção da CLI:** `--backup-target` **Parâmetro da API:** `BackupTarget` | MySQL, PostgreSQL, SQL Server |
| Janela de backup | O período durante o qual o Amazon RDS faz um backup automático da sua instância de banco de dados. A menos que você tenha um horário específico no qual deseja que o backup do banco de dados seja feito, use o padrão **No Preference (Sem preferência)**. Para obter mais informações, consulte [Introdução aos backups](USER_WorkingWithAutomatedBackups.md). | **Opção da CLI:** `--preferred-backup-window` **Parâmetro da API:** `PreferredBackupWindow` | Tudo |
| **Autoridade certificadora** | A autoridade de certificação (CA) para o certificado do servidor usado pela instância de banco de dados. Para obter mais informações, consulte [Usar SSL/TLS para criptografar uma conexão com uma instância ou um cluster de banco de dados](UsingWithRDS.SSL.md). | **Opção da CLI:** `--ca-certificate-identifier` **Parâmetro da API do RDS:** `CACertificateIdentifier` | Tudo |
| Character set (Conjunto de caracteres | O conjunto de caracteres da sua instância de banco de dados. O valor padrão **AL32UTF8** para o conjunto de caracteres de banco de dados Unicode 5.0 UTF-8 Universal. Você não pode alterar o conjunto de caracteres de banco de dados depois de criar a instância de banco de dados. Em uma configuração de locatário único, um conjunto de caracteres de banco de dados não padrão afeta apenas o PDB, não o CDB. Para obter mais informações, consulte [Configuração de locatário único da arquitetura CDB](Oracle.Concepts.CDBs.md#Oracle.Concepts.single-tenant). O conjunto de caracteres de banco de dados é diferente do conjunto de caracteres nacional, que é chamado de conjunto de caracteres NCHAR. Ao contrário do conjunto de caracteres de banco de dados, o conjunto de caracteres NCHAR especifica a codificação para colunas de tipos de dados NCHAR (NCHAR, NVARCHAR2 e NCLOB) sem afetar os metadados do banco de dados. Para obter mais informações, consulte [Conjuntos de caracteres do RDS for Oracle](Appendix.OracleCharacterSets.md). | **Opção da CLI:** `--character-set-name` **Parâmetro da API:** `CharacterSetName` | Oracle |
| Agrupamento | Um agrupamento em nível de servidor para a sua instância de banco de dados. Para obter mais informações, consulte [Agrupamento no nível do servidor para o Microsoft SQL Server](Appendix.SQLServer.CommonDBATasks.Collation.md#Appendix.SQLServer.CommonDBATasks.Collation.Server). | **Opção da CLI:** `--character-set-name` **Parâmetro da API:** `CharacterSetName` | SQL Server |
| Copiar tags para snapshots | Essa opção copia qualquer tag da instância de banco de dados para um snapshot de banco de dados quando você cria um snapshot. Para obter mais informações, consulte [Marcar recursos do do Amazon RDS](USER_Tagging.md). | **Opção da CLI:** `--copy-tags-to-snapshot` `--no-copy-tags-to-snapshot` **Parâmetro da API do RDS:** `CopyTagsToSnapshot` | Tudo |
| Autenticação de banco de dados | A opção de autenticação de banco de dados que você deseja usar. Selecione **Password authentication (Autenticação de senha)** para autenticar usuários de banco de dados somente com senhas de banco de dados. Selecione **Password and IAM DB authentication** (Senha e autenticação de banco de dados do IAM) para autenticar usuários de banco de dados com senhas de banco de dados e credenciais de usuário por meio de perfis e usuários. Para obter mais informações, consulte [Autenticação do banco de dados do IAMpara MariaDB, MySQL e PostgreSQL](UsingWithRDS.IAMDBAuth.md). Esta opção é compatível somente com MySQL e PostgreSQL. Escolha **Password and Kerberos authentication (Senha e autenticação Kerberos)** para autenticar usuários de banco de dados com senhas de banco de dados e a autenticação Kerberos pelo AWS Managed Microsoft AD criado com o Directory Service. Depois, escolha o diretório ou selecione **Create a new Directory (Criar um diretório)**. Para obter mais informações, consulte um dos seguintes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) | ***IAM:*** **Opção da CLI:** `--enable-iam-database-authentication` `--no-enable-iam-database-authentication` **Parâmetro da API do RDS:** `EnableIAMDatabaseAuthentication` ***Kerberos:*** **Opção da CLI:** `--domain` `--domain-iam-role-name` **Parâmetro da API do RDS:** `Domain` `DomainIAMRoleName` | Varia por tipo de autenticação |
| Tipo de gerenciamento de banco de dados | Escolha **Amazon RDS** se não precisar personalizar seu ambiente. Escolha **Amazon RDS Custom** se quiser personalizar o banco de dados, o sistema operacional e a infraestrutura. Para obter mais informações, consulte [Amazon RDS Custom](rds-custom.md). | Para a CLI e a API, especifique o tipo de mecanismo de banco de dados. | Oracle SQL Server |
| Porta de banco de dados | A porta pela qual você deseja acessar a instância de banco de dados. A porta padrão é exibida. Os firewalls em algumas empresas bloqueiam conexões com as portas padrão do MariaDB, MySQL e PostgreSQL. Se o firewall da sua empresa bloquear a porta padrão, insira outra porta para a instância de banco de dados. | **Opção da CLI:** `--port` **Parâmetro da API do RDS:** `Port` | Tudo |
| DB engine version (Versão do mecanismo de banco de dados | A versão do mecanismo de banco de dados que você deseja usar. | **Opção da CLI:** `--engine-version` **Parâmetro da API do RDS:** `EngineVersion` | Tudo |
| Classe da instância de banco de dados | A configuração da sua instância de banco de dados. Por exemplo, uma classe de instância de banco de dados **db.t3.small** tem 2 GiB de memória, 2 vCPUs, 1 núcleo virtual, uma ECU variável e uma capacidade de E/S moderada. Se possível, escolha uma classe de instância de banco de dados grande o suficiente para um conjunto de trabalho de consulta típico pode ser sustentado na memória. Quando os conjuntos de trabalho são mantidos na memória o sistema pode evitar a gravação em disco, o que aprimora a performance. Para obter mais informações, consulte [Classes de instâncias de banco de dados do ](Concepts.DBInstanceClass.md). No RDS para Oracle, você pode selecionar **Include additional memory configurations** (Incluir configurações de memória adicionais). Essas configurações são otimizadas para uma alta proporção de memória para vCPU. Por exemplo, **db.r5.6xlarge.tpc2.mem4x** é uma instância de banco de dados db.r5.8x que tem dois threads por núcleo (tpc2) e quatro vezes a memória de uma instância de banco de dados db.r5.6xlarge padrão. Para obter mais informações, consulte [Classes de instância de banco de dados do RDS para Oracle](Oracle.Concepts.InstanceClasses.md). | **Opção da CLI:** `--db-instance-class` **Parâmetro da API do RDS:** `DBInstanceClass` | Tudo |
| Identificador de instância de banco de dados | O nome da sua instância de banco de dados. Nomeie suas instâncias de banco de dados da mesma forma que nomeia seus servidores no local. O identificador da instância do banco de dados pode conter até 63 caracteres alfanuméricos e deve ser exclusivo para a conta na região da AWS que você escolher. | **Opção da CLI:** `--db-instance-identifier` **Parâmetro da API do RDS:** `DBInstanceIdentifier` | Tudo |
| Grupo de parâmetros de banco de dados | Um parameter group para a sua instância de banco de dados. Você pode escolher um grupo de parâmetros padrão ou criar o seu próprio grupo personalizado de parâmetros. Se você estiver usando o modelo BYOL para RDS para Db2, antes de criar uma instância de banco de dados, primeiro crie um grupo de parâmetros personalizado que contenha o IBM Site ID e o IBM Customer ID. Para obter mais informações, consulte [Traga a sua própria licença (BYOL) para o Db2](db2-licensing.md#db2-licensing-options-byol). Para obter mais informações, consulte [Grupos de parâmetros para Amazon RDS](USER_WorkingWithParamGroups.md). | **Opção da CLI:** `--db-parameter-group-name` **Parâmetro da API do RDS:** `DBParameterGroupName` | Tudo |
| Grupo de sub-redes de banco de dados | O grupo de sub-redes de banco de dados que você deseja usar para o cluster de banco de dados. Selecione Choose existing (Selecionar existente) para usar um grupo de sub-redes de banco de dados existente. Depois, escolha o grupo de sub-redes necessário na lista suspensa Existing DB subnet groups (Grupos de sub-redes de banco de dados existentes).Escolha **Automatic setup** (Configuração automática) para permitir que o RDS selecione um grupo de sub-redes de banco de dados compatível. Se não existir nenhum, o RDS criará um grupo de sub-redes para o cluster.Para obter mais informações, consulte [Trabalhar com grupos de sub-redes de banco de dados](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets). | **Opção da CLI:** `--db-subnet-group-name` **Parâmetro da API do RDS:** `DBSubnetGroupName` | Tudo |
| Volume de registro dedicado | Use um volume de log dedicado (DLV) para armazenar registros de transações do banco de dados em um volume de armazenamento separado do volume que contém as tabelas do banco de dados. Para obter mais informações, consulte [Usando um volume de registro dedicado (DLV)](USER_PIOPS.dlv.md). | **Opção da CLI:** `--dedicated-log-volume` **Parâmetro da API do RDS:** `DedicatedLogVolume` | Tudo |
| Proteção contra exclusão | Selecione **Enable deletion protection (Habilitar proteção contra exclusão)** para impedir que sua instância de banco de dados seja excluída. Por padrão, se você criar uma instância de banco de dados de produção com o Console de gerenciamento da AWS, a proteção contra exclusão será habilitada. Para obter mais informações, consulte [Excluir uma instância de banco de dados](USER_DeleteInstance.md). | **Opção da CLI:** `--deletion-protection` `--no-deletion-protection` **Parâmetro da API do RDS:** `DeletionProtection` | Tudo |
| Criptografia | Selecione **Enable Encryption (Habilitar criptografia)** para habilitar a criptografia em repouso para essa instância de banco de dados. Para obter mais informações, consulte [Criptografar recursos do Amazon RDS](Overview.Encryption.md). | **Opção da CLI:** `--storage-encrypted` `--no-storage-encrypted` **Parâmetro da API do RDS:** `StorageEncrypted` | Tudo |
| Monitoramento avançado | Selecione **Enable enhanced monitoring (Habilitar o monitoramento avançado)** para habilitar a coleta de métricas em tempo real do sistema operacional em que a instância de banco de dados é executada. Para obter mais informações, consulte [Monitorar métricas do SO com o monitoramento avançado](USER_Monitoring.OS.md). | **Opções da CLI:** `--monitoring-interval` `--monitoring-role-arn` **Parâmetros da API do RDS:** `MonitoringInterval` `MonitoringRoleArn` | Tudo |
| Tipo de mecanismo | Escolha o mecanismo de banco de dados a ser usado para essa instância de banco de dados. | **Opção da CLI:** `--engine` **Parâmetro da API do RDS:** `Engine` | Tudo |
| Nome do banco de dados inicial | O nome do banco de dados na sua instância de banco de dados. Se você não fornecer um nome, o Amazon RDS não criará um banco de dados na instância de banco de dados (exceto Oracle e PostgreSQL). O nome não pode ser uma palavra reservada pelo mecanismo de banco de dados e tem outras restrições dependendo do mecanismo de banco de dados. Db2: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) MariaDB e MySQL: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Oracle: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) PostgreSQL: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) | **Opção da CLI:** `--db-name` **Parâmetro da API do RDS:** `DBName` | Todos, exceto o SQL Server |
| License (Licença | Valores válidos para o modelo de licença: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) | **Opção da CLI:** `--license-model` **Parâmetro da API do RDS:** `LicenseModel` | Tudo |
| **Exportações de log** | Os tipos de arquivos de log de bancos de dados a serem publicados no Amazon CloudWatch Logs. Para obter mais informações, consulte [Publicação de logs de banco de dados no Amazon CloudWatch Logs](USER_LogAccess.Procedural.UploadtoCloudWatch.md). | **Opção da CLI:** `--enable-cloudwatch-logs-exports` **Parâmetro da API do RDS:** `EnableCloudwatchLogsExports` | Tudo |
| Janela de manutenção | A janela de 30 minutos na qual as modificações pendentes da sua instância de banco de dados serão aplicadas. Se o período não for relevante, selecione **No Preference (Sem preferência)**. Para obter mais informações, consulte [Janela de manutenção do Amazon RDS](USER_UpgradeDBInstance.Maintenance.md#Concepts.DBMaintenance). | **Opção da CLI:** `--preferred-maintenance-window` **Parâmetro da API do RDS:** `PreferredMaintenanceWindow` | Tudo |
| Gerenciar credenciais principais no AWS Secrets Manager | Selecione **Gerenciar credenciais principais no AWS Secrets Manager** para gerenciar a senha do usuário principal em um segredo no Secrets Manager. Opcionalmente, selecione uma chave do KMS a ser usada para proteger o segredo. Escolha entre uma das chaves do KMS da sua conta ou insira a chave de uma conta distinta. Para obter mais informações, consulte [Gerenciamento de senhas com Amazon RDS e AWS Secrets Manager](rds-secrets-manager.md). | **Opção da CLI:** `--manage-master-user-password \| --no-manage-master-user-password` `--master-user-secret-kms-key-id` **Parâmetro da API do RDS:** `ManageMasterUserPassword` `MasterUserSecretKmsKeyId` | Tudo |
| Senha principal | A senha da conta de usuário principal. A senha tem o seguinte número de caracteres ASCII imprimíveis (excluindo `/`, `"`, um espaço e `@`) dependendo do mecanismo de banco de dados: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) | **Opção da CLI:** `--master-user-password` **Parâmetro da API do RDS:** `MasterUserPassword` | Tudo |
| Nome do usuário principal | O nome que você usa como o nome de usuário principal para fazer login na instância de banco de dados com todos os privilégios do banco de dados. Observe as seguintes restrições: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Não é possível alterar o nome de usuário principal depois que a instância de banco de dados está criada. Para o Db2, recomendamos usar o mesmo nome de usuário principal do nome da instância do Db2 autogerenciado. Para ter mais informações sobre os privilégios concedidos ao usuário primário, consulte [Privilégios da conta de usuário mestre](UsingWithRDS.MasterAccounts.md). | **Opção da CLI:** `--master-username` **Parâmetro da API do RDS:** `MasterUsername` | Tudo |
| Microsoft SQL Server Windows Authentication | **Enable Microsoft SQL Server Windows authentication (Habilitar a autenticação do Microsoft SQL Server Windows)** e **Browse Directory (Procurar no diretório)** para escolher o diretório no qual deseja permitir que usuários autorizados do domínio autentiquem esta instância do SQL Server usando a Autenticação do Windows. | **Opções da CLI:** `--domain` `--domain-iam-role-name` **Parâmetros da API do RDS:** `Domain` `DomainIAMRoleName` | SQL Server |
| implantação multi-AZ | **Create a standby instance (Criar uma instância em espera)** para criar uma réplica secundária passiva da instância de banco de dados em outra zona de disponibilidade para oferece suporte a failover. Recomendamos o multi-AZ para workloads de produção a fim de manter a alta disponibilidade. Para desenvolvimento e teste, você pode selecionar **Do not create a standby instance (Não criar uma instância em espera)**. Para obter mais informações, consulte [Configurar e gerenciar uma implantação multi-AZ para o Amazon RDS](Concepts.MultiAZ.md). | **Opção da CLI:** `--multi-az` `--no-multi-az` **Parâmetro da API do RDS:** `MultiAZ` | Tudo |
| Conjunto de caracteres nacionais (NCHAR) | O conjunto de caracteres nacionais para sua instância de banco de dados, comumente chamado de conjunto de caracteres NCHAR. Você pode definir o conjunto de caracteres nacionais como AL16UTF16 (padrão) ou UTF-8. Você não pode alterar o conjunto de caracteres nacionais depois de criar a instância de banco de dados. O conjunto de caracteres nacionais é diferente do conjunto de caracteres de banco de dados. Ao contrário do conjunto de caracteres de banco de dados, o conjunto de caracteres nacionais especifica a codificação apenas para as colunas de tipos de dados NCHAR (NCHAR, NVARCHAR2 e NCLOB) sem afetar os metadados do banco de dados. Para obter mais informações, consulte [Conjuntos de caracteres do RDS for Oracle](Appendix.OracleCharacterSets.md). | **Opção da CLI:** `--nchar-character-set-name` **Parâmetro da API:** `NcharCharacterSetName` | Oracle |
| Tipo de rede | Os protocolos de endereçamento IP compatíveis com a instância de banco de dados. **IPv4** (o padrão) para especificar que os recursos podem se comunicar com a instância de banco de dados somente por meio do protocolo de endereçamento Internet Protocol versão 4 (IPv4). **Modo de pilha dupla** para especificar que os recursos podem se comunicar com a instância de banco de dados por IPv4, Internet Protocol versão 6 (IPv6) ou ambos. Use o modo de pilha dupla se você tiver algum recurso que precise se comunicar com sua instância de banco de dados pelo protocolo de endereçamento IPv6. Além disso, associe um bloco CIDR IPv6 a todas as sub-redes no grupo de sub-redes de banco de dados especificado. Para obter mais informações, consulte [Endereçamento IP do Amazon RDS](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.IP_addressing). | **Opção da CLI:** `--network-type` **Parâmetro da API do RDS:** `NetworkType` | Tudo |
| Grupo de opções | Um grupo de opções para a sua instância de banco de dados. Você pode escolher um grupo de opções padrão ou criar o seu próprio grupo personalizado de opções. Para obter mais informações, consulte [Trabalhar com grupos de opções](USER_WorkingWithOptionGroups.md). | **Opção da CLI:** `--option-group-name` **Parâmetro da API do RDS:** `OptionGroupName` | Tudo |
| Performance Insights | Selecione **Enable Performance Insights (Habilitar Performance Insights)** para monitorar a carga da instância de banco de dados do para que você possa analisar e solucionar problemas relacionados à performance do banco de dados. Escolha um período de retenção para determinar a quantidade de histórico de dados do Performance Insights que deve ser mantida. A configuração de retenção é **Padrão (7 dias)**. Para reter seus dados de performance por mais tempo, especifique entre 1 e 24 meses. Para obter mais informações sobre os períodos de retenção, consulte [Preços e retenção de dados para o Performance Insights](USER_PerfInsights.Overview.cost.md). Escolha uma chave do KMS a ser usada para proteger a chave usada para criptografar esse volume de banco de dados. Escolha entre uma das chaves do KMS da sua conta ou insira a chave de uma conta distinta. Para obter mais informações, consulte [Monitorar a carga de banco de dados com o Performance Insights no Amazon RDS](USER_PerfInsights.md). | **Opções da CLI:** `--enable-performance-insights` `--no-enable-performance-insights` `--performance-insights-retention-period` `--performance-insights-kms-key-id` **Parâmetros da API do RDS:** `EnablePerformanceInsights` `PerformanceInsightsRetentionPeriod` `PerformanceInsightsKMSKeyId` | Todos, exceto o Db2 |
| **Provisioned IOPS (IOPS provisionadas** | As IOPS provisionadas (operações de E/S por segundo) para a instância de banco de dados. Essa configuração estará disponível somente se você escolher uma das seguintes opções para **Storage type** (Tipo de armazenamento): [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Para obter mais informações, consulte [Armazenamento de instâncias de banco de dados do Amazon RDS](CHAP_Storage.md). | **Opção da CLI:** `--iops` **Parâmetro da API do RDS:** `Iops` | Tudo |
| Acesso público | **Yes (Sim)** para fornecer à instância de banco de dados um endereço IP público, o que significa que ela é acessível fora da VPC. Para ser acessível publicamente, a instância de banco de dados também deve estar em uma sub-rede pública na VPC. **No (Não)** para tornar a instância de banco de dados acessível apenas a partir da VPC. Para obter mais informações, consulte [Ocultar uma instância de banco de dados em uma VPC da Internet](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Hiding). Para se conectar a uma instância de banco de dados de fora de sua VPC, a instância de banco de dados deve estar acessível publicamente. Além disso, o acesso deve ser concedido usando as regras de entrada do grupo de segurança da instância de banco de dados. Além disso, outros requisitos devem ser atendidos. Para obter mais informações, consulte [Não é possível conectar-se à instância de banco de dados do Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting). Se sua instância de banco de dados não estiver acessível ao público, use uma conexão AWS Site-to-Site VPN ou uma conexão do Direct Connect para acessá-la de uma rede privada. Para obter mais informações, consulte [Privacidade do tráfego entre redes](inter-network-traffic-privacy.md). | **Opção da CLI:** `--publicly-accessible` `--no-publicly-accessible` **Parâmetro da API do RDS:** `PubliclyAccessible` | Tudo |
| Suporte estendido do RDS | Selecione **Habilitar Suporte estendido do RDS** para permitir que as versões principais do mecanismo compatíveis continuem funcionando após a data de término do suporte padrão do RDS. Quando você cria uma instância de banco de dados, o Amazon RDS usa como padrão o Suporte estendido do RDS. Para evitar a criação de uma instância de banco de dados após a data de fim do suporte padrão do RDS e para evitar cobranças pelo Suporte estendido do RDS, desabilite essa configuração. As instâncias de banco de dados existentes não incorrerão em cobranças até a data de início dos preços do Suporte estendido do RDS. Para obter mais informações, consulte [Suporte estendido do Amazon RDS com Amazon RDS](extended-support.md). | **Opção da CLI:** `--engine-lifecycle-support` **Parâmetro da API do RDS:** `EngineLifecycleSupport` | MySQL PostgreSQL |
| **RDS Proxy** | Selecione **Create an RDS Proxy** (Criar um RDS Proxy) para criar um proxy para sua instância de banco de dados. O Amazon RDS cria automaticamente um perfil do IAM e um segredo do Secrets Manager para o proxy. Para obter mais informações, consulte [Amazon RDS Proxy](rds-proxy.md). | Não disponível ao criar uma instância de banco de dados. | MariaDB MySQL PostgreSQL |
| Storage autoscaling (Autoscaling do armazenamento | **Enable storage autoscaling (Habilitar o autoscaling do armazenamento)** para permitir que o Amazon RDS aumente automaticamente o armazenamento quando necessário para evitar que a instância de banco de dados seja executada sem espaço de armazenamento. Use **Maximum storage threshold (Limite máximo de armazenamento)** para definir o limite máximo para o Amazon RDS aumentar automaticamente o armazenamento da instância de banco de dados. O padrão é de 1.000 GiB. Para obter mais informações, consulte [Gerenciar a capacidade automaticamente com a escalabilidade automática de armazenamento do Amazon RDS](USER_PIOPS.Autoscaling.md). | **Opção da CLI:** `--max-allocated-storage` **Parâmetro da API do RDS:** `MaxAllocatedStorage` | Tudo |
| **Storage throughput (Throughput de armazenamento** | O valor do throughput de armazenamento da instância de banco de dados. Essa configuração estará disponível somente se você escolher **General purpose SSD (gp3)** (SSD de uso geral (gp3)) para **Storage type** (Tipo de armazenamento). Para obter mais informações, consulte [Armazenamento gp3 (recomendado)](CHAP_Storage.md#gp3-storage). | **Opção da CLI:** `--storage-throughput` **Parâmetro da API do RDS:** `StorageThroughput` | Tudo |
| Tipo de armazenamento | O tipo de armazenamento da sua instância de banco de dados. Se você selecionar **General Purpose SSD (gp3)** (SSD de uso geral (gp3)), poderá provisionar IOPS provisionadas adicionais e throughput de armazenamento em **Advanced settings** (Configurações avançadas). Se você selecionar **SSD de IOPS provisionadas (io1)** ou **SSD de IOPS provisionadas (io2)**, insira o valor **IOPS provisionadas**. Para obter mais informações, consulte [Tipos de armazenamento do Amazon RDS](CHAP_Storage.md#Concepts.Storage). | **Opção da CLI:** `--storage-type` **Parâmetro da API do RDS:** `StorageType` | Tudo |
| Volumes de armazenamento adicionais | Você pode adicionar até três volumes de armazenamento extras à sua instância de banco de dados do RDS para Oracle ou do RDS para SQL Server. Você pode configurar cada volume adicional para usar os tipos de armazenamento gp3 ou io2. Você também pode especificar diferentes configurações de armazenamento alocado, IOPS e throughput para otimizar seus requisitos de workload. Especifique os nomes dos volumes como `rdsdbdata2`, `rdsdbdata3` ou `rdsdbdata4`. O armazenamento combinado entre os volumes primário e adicional não pode exceder 256 TiB. | **Opção da CLI:** `--additional-storage-volumes` **Parâmetro da API do RDS:** `AdditionalStorageVolumes` | Oracle e SQL Server |
| Grupo de sub-redes | Um grupo de sub-redes de banco de dados a ser associado a essa instância de banco de dados. Para obter mais informações, consulte [Trabalhar com grupos de sub-redes de banco de dados](USER_VPC.WorkingWithRDSInstanceinaVPC.md#USER_VPC.Subnets). | **Opção da CLI:** `--db-subnet-group-name` **Parâmetro da API do RDS:** `DBSubnetGroupName` | Tudo |
| Nome do banco de dados do inquilino | O nome do seu PDB inicial na configuração multilocatária da arquitetura Oracle. Essa configuração estará disponível somente se você escolher Configuração **multilocatária para configuração de** **arquitetura**. O nome do banco de dados do inquilino deve ser diferente do nome do seu CDB, que é nomeado. `RDSCDB` Não é possível mudar o nome de uma pilha. | **Opção da CLI:** `--db-name` **Parâmetro da API do RDS:** `DBName` | Oracle |
| Nome de usuário principal do banco de dados do inquilino | O nome que você usa como o nome de usuário primário para fazer login no cluster de banco de dados com todos os privilégios do banco de dados. Essa configuração estará disponível somente se você escolher Configuração **multilocatária para configuração de** **arquitetura**. Observe as seguintes restrições: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) Você não pode fazer o seguinte: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html) | **Opção da CLI:** `--master-username` **Parâmetro da API do RDS:** `MasterUsername` | Oracle |
| Senha mestre do banco de dados do inquilino | A senha da conta de usuário principal do banco de dados de locatários (PDB). Essa configuração estará disponível somente se você escolher Configuração **multilocatária para configuração de** **arquitetura**. A senha tem de 8 a 30 caracteres ASCII imprimíveis, excluindo,, um espaço `/` e. `"` `@` | **Opção da CLI:** `--master-password` **Parâmetro da API do RDS:** `MasterPassword` | Oracle |
| Conjunto de caracteres do banco de dados do inquilino | O conjunto de caracteres do banco de dados inicial do inquilino. Essa configuração estará disponível somente se você escolher Configuração **multilocatária para configuração de** **arquitetura**. Somente instâncias de CDB do RDS para Oracle são suportadas. O valor padrão **AL32UTF8** para o conjunto de caracteres de banco de dados Unicode 5.0 UTF-8 Universal. Você pode escolher um conjunto de caracteres do banco de dados do inquilino que seja diferente do conjunto de caracteres do CDB. Para obter mais informações, consulte [Conjuntos de caracteres do RDS for Oracle](Appendix.OracleCharacterSets.md). | **Opção da CLI:** `--character-set-name` **Parâmetro da API do RDS:** `CharacterSetName` | Oracle |
| Conjunto de caracteres nacionais do banco de dados do inquilino | O conjunto de caracteres nacionais para sua instância de banco de dados, comumente chamado de conjunto de caracteres NCHAR. Essa configuração estará disponível somente se você escolher Configuração **multilocatária para configuração de** **arquitetura**. Somente instâncias de CDB do RDS para Oracle são suportadas. Você pode definir o conjunto de caracteres nacionais como **AL16UTF16** (padrão) ou **UTF-8**. Não é possível alterar o conjunto de caracteres nacionais depois de criar o banco de dados. O conjunto de caracteres nacionais é diferente do conjunto de caracteres de banco de dados. O conjunto de caracteres nacionais especifica a codificação somente para colunas que usam o tipo de `NCHAR` dados (`NCHAR`,`NVARCHAR2`, e`NCLOB`) e não afeta os metadados do banco de dados. Para obter mais informações, consulte [Conjuntos de caracteres do RDS for Oracle](Appendix.OracleCharacterSets.md). | **Opção da CLI:** `--nchar-character-set-name` **Parâmetro da API:** `NcharCharacterSetName` | Oracle |
| Fuso horário | O fuso horário da sua instância de banco de dados. Se você não escolher um fuso horário, a instância de banco de dados usará o fuso horário padrão. Não é possível alterar o fuso horário depois que a instância de banco de dados é criada. Para obter mais informações, consulte [Fuso horário local para instâncias de banco de dados do Amazon RDS para Db2](db2-time-zone.md) e [Fuso horário local para instâncias de banco de dados do Microsoft SQL Server](SQLServer.Concepts.General.TimeZone.md). | **Opção da CLI:** `--timezone` **Parâmetro da API do RDS:** `Timezone` | Db2 SQL Server RDS Custom para SQL Server: |
| Nuvem privada virtual (VPC) | Uma VPC baseada no serviço da Amazon VPC para associar a essa instância de banco de dados. Para obter mais informações, consulte [Amazon VPC e Amazon RDS](USER_VPC.md). | Para a CLI e a API, especifique os IDs do grupo de segurança da VPC. | Tudo |
| Grupo de segurança da VPC (firewall) | O grupo de segurança a ser associado à instância de banco de dados. Para obter mais informações, consulte [Visão geral dos grupos de segurança de VPC](Overview.RDSSecurityGroups.md#Overview.RDSSecurityGroups.VPCSec). | **Opção da CLI:** `--vpc-security-group-ids` **Parâmetro da API do RDS:** `VpcSecurityGroupIds` | Tudo |
# Criar recursos do Amazon RDS com o AWS CloudFormation
O Amazon RDS é integrado ao AWS CloudFormation, um serviço que ajuda você a modelar e configurar os recursos da AWS para que você possa passar menos tempo criando e gerenciando os recursos e a infraestrutura. Você cria um modelo que descreve todos os recursos AWS desejados (como instâncias de banco de dados e grupos de parâmetros de banco de dados), e o CloudFormation provisiona e configura esses recursos para você.
Ao usar o CloudFormation, você poderá reutilizar o modelo para configurar os recursos do RDS de forma repetida e consistente. Descreva seus recursos uma vez e, depois, provisione os mesmos recursos repetidamente em várias contas e regiões da AWS.
## RDS e modelos do CloudFormation
[Modelos do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html) são arquivos de texto formatados em JSON ou YAML. Esses modelos descrevem os atributos que você deseja provisionar nas suas pilhas CloudFormation. Se não estiver familiarizado com o JSON ou o YAML, é possível usar o CloudFormation Designer para ajudar a começar a usar os modelos do CloudFormation. Para obter mais informações, consulte [O que é o CloudFormation Designer?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/working-with-templates-cfn-designer.html) no *Guia do usuário do AWS CloudFormation*.
O RDS é compatível com a criação de recursos no CloudFormation. Para obter mais informações, incluindo exemplos de modelos JSON e YAML para esses recursos, consulte [Referência de tipo de recurso do RDS](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_RDS.html) no *Guia do usuário do AWS CloudFormation*.
## Saiba mais sobre o CloudFormation
Para saber mais sobre o CloudFormation, consulte os seguintes recursos:
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+ [AWS CloudFormation Guia do usuário do](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
+ [CloudFormation Referência de API do](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html)
+ [AWS CloudFormation Guia do Usuário da Interface de Linha de Comando](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html)
# Conectar a uma instância de banco de dados do Amazon RDS
Antes de se conectar a uma instância de banco de dados, você deve criar a instância de banco de dados. Para obter mais informações, consulte [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md). Depois que o Amazon RDS provisionar sua instância de banco de dados, use qualquer aplicação ou utilitário cliente padrão para o mecanismo de banco de dados se conectar à instância de banco de dados. Na string de conexão, especifique o endereço DNS do endpoint de instância de banco de dados como o parâmetro de host. Além disso, especifique o número da porta do endpoint da instância de banco de dados como o parâmetro da porta.
Para ter mais detalhes sobre como encontrar informações de conexão para uma instância de banco de dados do Amazon RDS ou cenários para acessar uma instância de banco de dados em uma VPC, consulte os tópicos a seguir.
+ [Localizando as informações de conexão para uma instância de Amazon RDS banco de dados](CHAP_CommonTasks.Connect.EndpointAndPort.md)
+ [Cenários para acessar uma instância de banco de dados em uma VPC](CHAP_CommonTasks.Connect.ScenariosForAccess.md)
# Localizando as informações de conexão para uma instância de Amazon RDS banco de dados
As informações de conexão de uma instância de banco de dados incluem seu endpoint, porta e um usuário de banco de dados válido, como o usuário mestre. Por exemplo, para uma instância de banco de dados MySQL, suponha que o valor do endpoint seja `mydb.123456789012.us-east-1.rds.amazonaws.com`. Nesse caso, o valor da porta é `3306`, e o usuário do banco de dados é `admin`. Com essas informações, você especifica os seguintes valores em uma string de conexão:
+ Para o host, nome de host ou nome DNS, especifique `mydb.123456789012.us-east-1.rds.amazonaws.com`.
+ Para a porta, especifique `3306`.
+ Para usuário, especifique `admin`.
O endpoint é exclusivo para cada instância de banco de dados e os valores da porta e do usuário podem variar. A seguinte lista mostra a porta mais comum para cada mecanismo de banco de dados:
+ Db2: 50000
+ MariaDB – 3306
+ Microsoft SQL Server – 1433
+ MySQL – 3306
+ Oracle – 1521
+ PostgreSQL – 5432
Para se conectar a uma instância de banco de dados, use qualquer cliente para um mecanismo de banco de dados. Por exemplo, você pode usar o utilitário mysql para se conectar a uma instância de banco de dados MariaDB ou MySQL. Você pode usar o Microsoft SQL Server Management Studio para se conectar a uma instância de banco de dados SQL Server. Você pode usar o Oracle SQL Developer para se conectar a uma instância de banco de dados Oracle. Da mesma forma, você pode usar uma instância local do utilitário de linha de comando psql para se conectar a uma instância de banco de dados do PostgreSQL.
Para encontrar as informações de conexão de uma instância de banco de dados, use o Console de gerenciamento da AWS Você também pode usar o comando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) da AWS Command Line Interface (AWS CLI) ou a operação [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) da API do RDS.
## Console
**Para encontrar as informações de conexão de uma instância de banco de dados no Console de gerenciamento da AWS**
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. No painel de navegação, escolha **Bancos de dados** para exibir uma lista de suas instâncias de banco de dados.
1. Escolha o nome da instância de banco de dados para mostrar os detalhes.
1. Na guia **Connectivity & security (Conectividade e segurança)**, copie o endpoint. Além disso, anote o número da porta. Você precisará do endpoint e do número da porta para conectar-se à instância de banco de dados.
![\[O endpoint e a porta de uma instância de banco de dados\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/endpoint-port.png)
1. Se você precisar encontrar o nome de usuário mestre, escolha a guia **Configuração** e visualize o valor do nome de **usuário mestre** .
## AWS CLI
Para encontrar as informações de conexão de uma instância de banco de dados usando o AWS CLI, chame o comando [describe-db-instances](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-instances.html) . Na chamada, consulte o ID da instância de banco de dados, o endpoint, a porta e o nome de usuário mestre.
Para Linux, macOS ou Unix:
```
aws rds describe-db-instances \
--query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```
Para Windows:
```
aws rds describe-db-instances ^
--query "*[].[DBInstanceIdentifier,Endpoint.Address,Endpoint.Port,MasterUsername]"
```
Sua saída deve ser similar à seguinte.
```
[
[
"mydb",
"mydb.123456789012.us-east-1.rds.amazonaws.com",
3306,
"admin"
],
[
"myoracledb",
"myoracledb.123456789012.us-east-1.rds.amazonaws.com",
1521,
"dbadmin"
],
[
"mypostgresqldb",
"mypostgresqldb.123456789012.us-east-1.rds.amazonaws.com",
5432,
"postgresadmin"
]
]
```
## API do RDS
Para localizar as informações de conexão de uma instância de banco de dados usando a Amazon RDS API, chame a operação [DescribeDBInstances](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBInstances.html) . Na saída, encontre os valores para o endereço do endpoint, a porta do endpoint e o nome do usuário mestre.
# Cenários para acessar uma instância de banco de dados em uma VPC
Usando o Amazon Virtual Private Cloud (Amazon VPC) você pode executar recursos da AWS, como instâncias de bancos de dados do Amazon RDS, em uma nuvem privada virtual (VPC). Ao usar uma Amazon VPC, você tem controle sobre o ambiente de rede virtual. É possível escolher seu próprio intervalo de endereços IP, criar sub-redes e configurar o roteamento e listas de controle de acesso.
Um grupo de segurança da VPC controla o acesso a uma instância de banco de dados dentro de uma VPC. Cada regra de grupo de segurança de VPC permite que uma origem específica acesse uma instância de banco de dados em uma VPC que esteja associada a esse grupo de segurança de VPC. A origem pode ser uma gama de endereços (por exemplo, 203.0.113.0/24) ou outro grupo de segurança da VPC. Ao especificar um grupo de segurança de VPC como origem, você permite o tráfego recebido de todas as instâncias (geralmente servidores de aplicativos) que usam o grupo de segurança de VPC de origem.
Antes de tentar se conectar à sua instância de banco de dados, configure a VPC para o caso de uso. Estes são alguns cenários comuns para acessar uma instância de banco de dados em uma VPC:
+ **Uma instância de banco de dados em uma VPC acessada por uma instância Amazon EC2 na mesma VPC** – Um uso comum de uma instância de banco de dados em uma VPC é compartilhar dados com um servidor de aplicações que estiver sendo executada em uma instância do EC2 na mesma VPC. A instância do EC2 pode executar um servidor Web com uma aplicação que interaja com a instância de banco de dados.
+ **Uma instância de banco de dados em uma VPC acessada por uma instância do EC2 em uma VPC diferente**: em alguns casos, sua instância de banco de dados está em uma VPC diferente da instância do EC2 que você está usando para acessá-la. Nesse caso, você pode usar o emparelhamento de VPC para acessar a instância de banco de dados.
+ **Uma instância de banco de dados em uma VPC acessada por uma aplicação cliente pela Internet**: para acessar uma instância de banco de dados em uma VPC de uma aplicação cliente pela Internet, configure uma VPC com uma única sub-rede pública. Não há nenhum gateway da Internet para permitir comunicação pela Internet.
Para se conectar a uma instância de banco de dados de fora de sua VPC, a instância de banco de dados deve estar acessível publicamente. Além disso, o acesso deve ser concedido usando as regras de entrada do grupo de segurança da instância de banco de dados, e os outros requisitos devem ser atendidos. Para ter mais informações, consulte [Não é possível conectar-se à instância de banco de dados do Amazon RDS](CHAP_Troubleshooting.md#CHAP_Troubleshooting.Connecting).
+ **Uma instância de banco de dados em uma VPC acessada por uma rede privada**: se sua instância de banco de dados não estiver acessível ao público, você poderá usar uma das seguintes opções para acessá-la de uma rede privada:
+ Uma conexão do AWS Site-to-Site VPN.
+ Uma conexão do Direct Connect.
+ Uma conexão do AWS Client VPN.
Para ter mais informações, consulte [Cenários para acessar uma instância de banco de dados em uma VPC](USER_VPC.Scenarios.md).
## Conectar-se a instâncias de banco de dados com os drivers da AWS
O pacote de drivers da AWS foram projetados para comportar tempos mais rápidos de transição e de failover, além de autenticação com o AWS Secrets Manager, o AWS Identity and Access Management (IAM) e identidades federadas. Os drivers da AWS dependem do monitoramento do status da instância de banco de dados e do conhecimento da topologia da instância para determinar a nova instância primária. Essa abordagem reduz os tempos de transição e de failover para segundos de um dígito, em comparação com dezenas de segundos para drivers de código aberto.
A tabela a seguir lista os recursos aceitos para cada um dos drivers. Como novos recursos do serviço são introduzidos, o objetivo do pacote de drivers da AWS é ter suporte integrado para esses recursos do serviço.
| Recurso | [AWS Driver JDBC da](https://github.com/awslabs/aws-advanced-jdbc-wrapper) | [AWS Driver Python da](https://github.com/awslabs/aws-advanced-python-wrapper) | [AWS Driver ODBC da para MySQL](https://github.com/aws/aws-mysql-odbc) |
| --- | --- | --- | --- |
| Suporte a failover | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheFailoverPlugin.md) | [Sim](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFailoverPlugin.md) | [Sim](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/UsingTheAwsDriver.md#failover-process) |
| Monitoramento aprimorado de failover | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheHostMonitoringPlugin.md) | [Sim](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheHostMonitoringPlugin.md) | [Sim](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/HostMonitoring.md#enhanced-failure-monitoring) |
| Divisão de leituras/gravações | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) | [Sim](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheReadWriteSplittingPlugin.md) | Não |
| Conexão de metadados do driver | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheDriverMetadataConnectionPlugin.md) | N/D | N/D |
| Telemetria | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/Telemetry.md) | [Sim](https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/Telemetry.md) | Não |
| Secrets Manager | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) | [Sim](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheAwsSecretsManagerPlugin.md) | [Sim](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/UsingTheAwsDriver.md#secrets-manager-authentication) |
| Autenticação do IAM | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) | [Sim](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheIamAuthenticationPlugin.md) | [Sim](https://github.com/aws/aws-mysql-odbc/blob/main/docs/using-the-aws-driver/UsingTheAwsDriver.md#iam-authentication) |
| Identidades federadas (AD FS) | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) | [Sim](https://github.com/awslabs/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/using-plugins/UsingTheFederatedAuthenticationPlugin.md) | Não |
| Identidade federada (Okta) | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/using-plugins/UsingTheFederatedAuthPlugin.md) | Não | Não |
| Clusters de banco de dados multi-AZ | [Sim](https://github.com/awslabs/aws-advanced-jdbc-wrapper/blob/main/docs/using-the-jdbc-driver/SupportForRDSMultiAzDBCluster.md) | [Sim](https://github.com/aws/aws-advanced-python-wrapper/blob/main/docs/using-the-python-driver/SupportForRDSMultiAzDBCluster.md) | Não |
Para ter mais informações sobre os drivers da AWS, consulte o driver de linguagem correspondente para a instância de banco de dados do [RDS para MariaDB](MariaDB.Connecting.Drivers.md#MariaDB.Connecting.JDBCDriver), [RDS para MySQL](MySQL.Connecting.Drivers.md#MySQL.Connecting.JDBCDriver) ou [RDS para PostgreSQL](PostgreSQL.Connecting.JDBCDriver.md).
**nota**
Os únicos recursos compatíveis com o RDS para MariaDB são a autenticação com o AWS Secrets Manager, o AWS Identity and Access Management (IAM) e a identidade federada.
## Conectar-se a uma instância de banco de dados que está executando um mecanismo de banco de dados específico
Para saber como se conectar a uma instância de banco de dados que esteja executando um mecanismo de banco de dados específico, siga as instruções do mecanismo de banco de dados:
+ [RDS para Db2](USER_ConnectToDb2DBInstance.md)
+ [RDS para MariaDB](USER_ConnectToMariaDBInstance.md)
+ [RDS para SQL Server](USER_ConnectToMicrosoftSQLServerInstance.md)
+ [RDS para MySQL](USER_ConnectToInstance.md)
+ [RDS para Oracle](USER_ConnectToOracleInstance.md)
+ [RDS para PostgreSQL](USER_ConnectToPostgreSQLInstance.md)
## Gerenciar conexões com o RDS Proxy
Também é possível usar o Amazon RDS Proxy para gerenciar conexões com instâncias de banco de dados do RDS para MariaDB, do RDS para Microsoft SQL Server, do RDS para MySQL e do RDS para PostgreSQL. O RDS Proxy permite que as aplicações agrupem e compartilhem conexões de banco de dados para melhorar a escalabilidade. Para obter mais informações, consulte [Amazon RDS Proxy](rds-proxy.md).
## Opções de autenticação do banco de dados
Amazon RDS suporta as seguintes maneiras de autenticar usuários do banco de dados:
+ Com a **autenticação com senha,** –sua instância de banco de dados executa toda a administração de contas do usuário. Você cria usuários e especifica senhas com instruções SQL. As instruções SQL que você pode usar dependem do mecanismo de banco de dados.
+ **Autenticação de banco de dados do AWS Identity and Access Management (IAM)**: você não precisa usar uma senha ao se conectar a uma instância de banco de dados. Em vez disso, você usa um token de autenticação.
+ **Autenticação Kerberos** – Você usa autenticação externa de usuários de banco de dados usando Kerberos e Microsoft Active Directory. O Kerberos é um protocolo de autenticação de rede que usa tíquetes e criptografia de chave simétrica para eliminar a necessidade de transmitir senhas pela rede. O Kerberos foi integrado ao Active Directory e foi projetado para autenticar usuários em recursos de rede, como bancos de dados.
IAM autenticação de banco de dados e autenticação Kerberos estão disponíveis apenas para mecanismos de banco de dados específicos e versões.
Para obter mais informações, consulte [Autenticação de banco de dados com o Amazon RDS ](database-authentication.md).
## Conexões criptografadas
É possível usar o Security Socket Layer (SSL) ou o Transport Layer Security (TLS) na aplicação para criptografar uma conexão com a uma instância de banco de dados. Cada mecanismo de banco de dados tem seu próprio processo de implementação do SSL/TLS. Para obter mais informações, consulte [Usar SSL/TLS para criptografar uma conexão com uma instância ou um cluster de banco de dados](UsingWithRDS.SSL.md).
# Trabalhar com grupos de opções
Alguns mecanismos de banco de dados oferecem recursos adicionais que facilitam o gerenciamento de dados e de bancos de dados e oferecem segurança adicional ao seu banco de dados. O Amazon RDS usa grupos de opções para habilitar e configurar esses recursos. Um *grupo de opções* pode especificar recursos, chamados de opções, que estão disponíveis para uma determinada instância de banco de dados do Amazon RDS. Opções podem ter configurações que especificam como a opção funciona. Quando você associa uma instância de banco de dados a um grupo de opções, as opções e as configurações de opções especificadas são habilitadas para essa instância de banco de dados.
O Amazon RDS oferece suporte para os seguintes mecanismos de banco de dados:
****
| Mecanismo do banco de dados | Documentação relevante |
| --- | --- |
| `Db2` | [Opções para instâncias de banco de dados do RDS para Db2](Db2.Options.md) |
| `MariaDB` | [Opções para o mecanismo de banco de dados do MariaDB](Appendix.MariaDB.Options.md) |
| `Microsoft SQL Server` | [Opções para o mecanismo de banco de dados do Microsoft SQL Server](Appendix.SQLServer.Options.md) |
| `MySQL` | [Opções para instâncias de bancos de dados MySQL](Appendix.MySQL.Options.md) |
| `Oracle` | [Adição de opções a instâncias de banco de dados Oracle](Appendix.Oracle.Options.md) |
| `PostgreSQL` | O PostgreSQL não usa opções e grupos de opções. O PostgreSQL usa extensões e módulos para fornecer recursos adicionais. Para obter mais informações, consulte [Versões de extensões do PostgreSQL compatíveis](PostgreSQL.Concepts.General.FeatureSupport.Extensions.md). |
## Visão geral de grupos de opções
O Amazon RDS fornece um grupo de opções padrão vazio para cada nova instância de banco de dados. Não é possível modificar ou excluir esse grupo de opções padrão, mas qualquer novo grupo de opções que você criar derivará suas configurações do grupo de opções padrão. Para aplicar uma opção a uma instância de banco de dados, você deve fazer o seguinte:
1. Crie um novo grupo de opções, ou copie ou modifique um existente.
1. Adicionar uma ou mais opções ao grupo de opções.
1. Associe o grupo de opções à instância de banco de dados.
Para associar um grupo de opções a uma instância de banco de dados, modifique a instância de banco de dados. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
Tanto as instâncias de banco de dados quanto os snapshot de banco de dadoss podem ser associados a um grupo de opções. Em alguns casos, você pode restaurar a partir de um snapshot de banco de dados ou pode realizar uma restauração pontual time para uma instância de banco de dados. Nesses casos, o grupo de opções associado ao snapshot de banco de dados ou à instância de banco de dados está, por padrão, associado à instância de banco de dados restaurada. Você pode associar um grupo de opções diferente a uma instância de banco de dados restaurada. No entanto, o novo grupo de opções deve conter quaisquer opções persistentes ou permanentes que foram incluídas no grupo de opções original. As opções persistentes e permanentes estão descritas a seguir.
As opções exigem memória adicional para serem executadas em uma instância de banco de dados. Portanto, pode ser necessário iniciar uma instância maior para usá-las, dependendo do uso atual da sua instância de banco de dados. Por exemplo, o Oracle Enterprise Manager Database Control usa cerca de 300 MB de RAM. Se você habilitar essa opção para uma instância de banco de dados pequena, poderá encontrar problemas de performance devido a erros de memória insuficiente.
### Opções persistentes e permanentes
Dois tipos de opções, persistentes e permanentes, exigem consideração especial quando você as adiciona a um grupo de opções.
Ações persistentes não podem ser removidas de um grupo de opções enquanto instâncias de banco de dados estão associadas a esse grupo. Um exemplo de uma opção persistente é a opção TDE para o recurso TDE (Transparent Data Encryption) do Microsoft SQL Server. Você deve desassociar todas as instâncias de bancos de dados do grupo de opções para que uma opção persistente possa ser removida do grupo de opções. Em alguns casos, você pode restaurar ou realizar uma restauração pontual a partir de um snapshot de banco de dados. Nesses casos, se o grupo de opções associado a esse snapshot de banco de dados contiver uma opção persistente, você só poderá associar a instância de banco de dados restaurada a esse grupo de opções.
Opções permanentes, como a opção TDE para o TDE do Oracle Advanced Security, nunca podem ser removidas de um grupo de opções. Você pode alterar o grupo de opções de uma instância de banco de dados que esteja usando a opção permanente. No entanto, o grupo de opções associado à instância de banco de dados deve incluir a mesma opção permanente. Em alguns casos, você pode restaurar ou realizar uma restauração pontual a partir de um snapshot de banco de dados. Nesses casos, se o grupo de opções associado a esse snapshot de banco de dados contiver uma opção permanente, você só poderá associar a instância de banco de dados restaurada a um grupo de opções com essa opção permanente.
Para instâncias de banco de dados Oracle, você pode copiar snapshots de banco de dados compartilhados que tenham as opções `Timezone` ou `OLS` (ou ambas). Para fazer isso, especifique um grupo de opções de destino que inclua essas opções ao copiar o snapshot de banco de dados. A opção OLS é permanente e persistente apenas para instâncias de banco de dados Oracle executando o Oracle versão 12.2 ou superior. Para obter mais informações sobre essas opções, consulte [Fuso horário da Oracle](Appendix.Oracle.Options.Timezone.md) e [Oracle Label Security](Oracle.Options.OLS.md).
### Considerações de VPC
O grupo de opções associado à instância de banco de dados é vinculado à VPC da instância de banco de dados. Isso significa que você não poderá usar o grupo de opções atribuído a uma instância de banco de dados se tentar restaurar essa instância em uma VPC diferente. Se você restaurar uma instância de banco de dados para uma VPC diferente, poderá realizar um dos seguintes procedimentos:
+ Atribuir o grupo de opções padrão à instância de banco de dados.
+ Atribuir um grupo de opções vinculado a essa VPC.
+ Criar um novo grupo de opções e atribui-lo à instância de banco de dados.
Com opções persistentes ou permanentes, como o Oracle TDE, você deve criar um grupo de opções. Esse grupo de opções deve incluir a opção persistente ou permanente ao restaurar uma instância de banco de dados em uma VPC diferente.
Configurações de opções controlam o comportamento de uma opção. Por exemplo, a opção Oracle Advanced Security `NATIVE_NETWORK_ENCRYPTION` tem uma configuração que você pode usar para especificar o algoritmo de criptografia do tráfego de rede para e a partir da instância de banco de dados. Algumas configurações de opções são otimizadas para uso com o Amazon RDS e não podem ser alteradas.
### Opções mutuamente exclusivas
Algumas opções são mutuamente exclusivas. Você pode usar uma ou outro, mas não ambas ao mesmo tempo. As seguintes opções são mutuamente exclusivas:
+ [Oracle Enterprise Manager Database Express](Appendix.Oracle.Options.OEM_DBControl.md) e [Oracle Management Agent para Enterprise Manager Cloud Control](Oracle.Options.OEMAgent.md).
+ [Oracle Native Network Encryption](Appendix.Oracle.Options.NetworkEncryption.md) e [Oracle Secure Sockets Layer](Appendix.Oracle.Options.SSL.md).
## Criar um grupo de opções
Você pode criar um grupo de opções que obtenha suas configurações do grupo de opções padrão. Então, você adiciona uma ou mais opções ao novo grupo de opções. Ou, se você já possui um grupo de opções, pode copiar esse grupo com todas as suas opções em um novo grupo de opções. Para ter mais informações, consulte [Copiar um grupo de opções](#USER_WorkingWithOptionGroups.Copy).
Depois de criar um novo grupo de opções, ele não possui opções. Para saber como adicionar opções ao grupo de opções, consulte [Adicionar uma opção a um grupo de opções](#USER_WorkingWithOptionGroups.AddOption). Depois de adicionar as opções desejadas, você poderá então associar o grupo de opções a uma instância de banco de dados. Dessa forma, as opções ficam disponíveis na instância de banco de dados. Para obter informações sobre como associar um grupo de opções a uma instância de banco de dados, consulte a documentação do mecanismo em [Trabalhar com grupos de opções](#USER_WorkingWithOptionGroups).
### Console
Uma maneira de criar um grupo de opções é usando o Console de gerenciamento da AWS.
**Para criar um novo grupo de opções usando o console**
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. No painel de navegação, escolha **Option groups (Grupos de opções)**.
1. Escolha **Create group (Criar grupo)**.
1. Na janela **Create option group (Criar grupo de opções)**, faça o seguinte:
1. Em **Name (Nome)**, digite um nome para o grupo de opções que seja exclusivo na sua conta da AWS. O nome pode conter somente letras, números e hifens.
1. Em **Description (Descrição)**, digite uma breve descrição do grupo de opções. A descrição é usada para fins de exibição.
1. Em **Engine (Mecanismo)**, escolha o mecanismo de banco de dados desejado.
1. Em **Major engine version (Versão principal do mecanismo)**, escolha a versão principal do mecanismo de banco de dados desejado.
1. Escolha **Create (Criar)** para continuar. Para cancelar a operação, escolha **Cancel (Cancelar)**.
### AWS CLI
Para criar um grupo de opções, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/create-option-group.html) da `create-option-group` com os seguintes parâmetros obrigatórios.
+ `--option-group-name`
+ `--engine-name`
+ `--major-engine-version`
+ `--option-group-description`
**Example**
O exemplo a seguir cria um grupo de opções denominado `testoptiongroup`, que está associado ao mecanismo de banco de dados Oracle Enterprise Edition. A descrição está entre aspas.
Para Linux, macOS ou Unix:
```
aws rds create-option-group \
--option-group-name testoptiongroup \
--engine-name oracle-ee \
--major-engine-version 19 \
--option-group-description "Test option group for Oracle Database 19c EE"
```
Para Windows:
```
aws rds create-option-group ^
--option-group-name testoptiongroup ^
--engine-name oracle-ee ^-
--major-engine-version 19 ^
--option-group-description "Test option group for Oracle Database 19c EE"
```
### API do RDS
Para criar um grupo de opções, chame a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateOptionGroup.html) da API do Amazon RDS. Inclua os seguintes parâmetros:
+ `OptionGroupName`
+ `EngineName`
+ `MajorEngineVersion`
+ `OptionGroupDescription`
## Copiar um grupo de opções
Você pode usar a AWS CLI ou a API do Amazon RDS para copiar um grupo de opções. Copiar um grupo de opções pode ser conveniente. Um exemplo é quando há um grupo de opções e você deseja incluir a maioria de seus parâmetros e valores personalizados em um novo grupo de opções. Você também pode fazer uma cópia de um grupo de opções que costuma usar em um ambiente de produção e depois modificar essa cópia para testar outras configurações de opções.
**nota**
No momento, você não pode copiar um grupo de opções para uma região diferente da AWS.
### AWS CLI
Para copiar um grupo de opções, use o comando [copy-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-option-group.html) da AWS CLI. Inclua as seguintes opções necessárias:
+ `--source-option-group-identifier`
+ `--target-option-group-identifier`
+ `--target-option-group-description`
**Example**
O exemplo a seguir cria um grupo de opções denominado `new-option-group`, que é uma cópia local do grupo de opções `my-option-group`.
Para Linux, macOS ou Unix:
```
aws rds copy-option-group \
--source-option-group-identifier my-option-group \
--target-option-group-identifier new-option-group \
--target-option-group-description "My new option group"
```
Para Windows:
```
aws rds copy-option-group ^
--source-option-group-identifier my-option-group ^
--target-option-group-identifier new-option-group ^
--target-option-group-description "My new option group"
```
### API do RDS
Para copiar um grupo de opções, chame a operação [CopyOptionGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyOptionGroup.html) da API do Amazon RDS. Inclua os seguintes parâmetros necessários.
+ `SourceOptionGroupIdentifier`
+ `TargetOptionGroupIdentifier`
+ `TargetOptionGroupDescription`
## Adicionar uma opção a um grupo de opções
Você pode adicionar uma opção a um grupo de opções existente. Depois de ter adicionado as opções desejadas, você poderá então associar o grupo de opções com uma instância de banco de dados para que as opções se tornem disponíveis na instância de banco de dados. Para obter informações sobre como associar um grupo de opções a uma instância de banco de dados, consulte a documentação do mecanismo de banco de dados específico, listada em [Trabalhar com grupos de opções](#USER_WorkingWithOptionGroups).
As alterações do grupo de opções devem ser aplicadas imediatamente em dois casos:
+ Quando você adiciona uma opção que adiciona ou atualiza um valor de porta, como a opção `OEM`.
+ Quando você adiciona ou remove um grupo de opções com uma opção que inclui um valor de porta.
Nesses casos, escolha a opção **Apply Immediately (Aplicar imediatamente)** no console. Se preferir, inclua a opção `--apply-immediately` quando usar a AWS CLI ou definir o parâmetro `ApplyImmediately` como `true` ao usar a API do Amazon RDS. As opções que não incluem valores de porta podem ser aplicadas imediatamente ou podem ser aplicadas durante a próxima janela de manutenção da instância de banco de dados.
**nota**
Se você especificar um grupo de segurança como um valor para uma opção em um grupo de opções, gerencie o grupo de segurança modificando o grupo de opções. Não é possível alterar ou remover esse grupo de segurança modificando uma instância de banco de dados. Além disso, o grupo de segurança não aparece nos detalhes da instância de banco de dados no Console de gerenciamento da AWS ou na saída do comando AWS CLI da `describe-db-instances`.
### Console
Você pode usar o Console de gerenciamento da AWS para adicionar uma opção a um grupo de opções.
**Para adicionar uma opção a um grupo de opções usando o console**
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. No painel de navegação, escolha **Option groups (Grupos de opções)**.
1. Selecione o grupo de opções que você deseja modificar e escolha **Add Option (Adicionar opção)**.
![\[Grupo de opções do console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/optiongroup-addoption1.png)
1. Na janela **Add option (Adicionar opção)**, faça o seguinte:
1. Escolha a opção que você deseja adicionar. Talvez seja necessário fornecer valores adicionais, dependendo da opção que você selecionar. Por exemplo, ao escolher a opção `OEM`, também é necessário inserir um valor de porta e especificar um grupo de segurança.
1. Para habilitar a opção em todas as instâncias de banco de dados associadas assim que você a adicionar, em **Apply Immediately (Aplicar imediatamente)**, escolha **Yes (Sim)**. Se você escolher **No (Não)** (o padrão), a opção será habilitada para cada instância de banco de dados associada durante sua próxima janela de manutenção.
![\[Grupo de opções do console\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/optiongroup-addoption2.png)
1. Quando estiver satisfeito com as configurações, escolha **Add Option (Adicionar opção)**.
### AWS CLI
Para adicionar uma opção a um grupo de opções, execute o comando [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) da AWS CLI com a opção que você deseja adicionar. Para habilitar a nova opção imediatamente em todas as instâncias de bancos de dados associadas, inclua o parâmetro `--apply-immediately`. Por padrão, a opção é habilitada para cada instância de banco de dados associada durante sua próxima janela de manutenção. Inclua o seguinte parâmetro necessário:
+ `--option-group-name`
**Example**
O exemplo a seguir adiciona a opção `Timezone`, com a configuração `America/Los_Angeles`, a um grupo de opções denominado `testoptiongroup` e a habilita imediatamente.
Para Linux, macOS ou Unix:
```
aws rds add-option-to-option-group \
--option-group-name testoptiongroup \
--options "OptionName=Timezone,OptionSettings=[{Name=TIME_ZONE,Value=America/Los_Angeles}]" \
--apply-immediately
```
Para Windows:
```
aws rds add-option-to-option-group ^
--option-group-name testoptiongroup ^
--options "OptionName=Timezone,OptionSettings=[{Name=TIME_ZONE,Value=America/Los_Angeles}]" ^
--apply-immediately
```
A saída do comando é semelhante à seguinte:
```
...{
"OptionName": "Timezone",
"OptionDescription": "Change time zone",
"Persistent": true,
"Permanent": false,
"OptionSettings": [
{
"Name": "TIME_ZONE",
"Value": "America/Los_Angeles",
"DefaultValue": "UTC",
"Description": "Specifies the timezone the user wants to change the system time to",
"ApplyType": "DYNAMIC",
"DataType": "STRING",
"AllowedValues": "Africa/Cairo,...",
"IsModifiable": true,
"IsCollection": false
}
],
"DBSecurityGroupMemberships": [],
"VpcSecurityGroupMemberships": []
}...
```
**Example**
O exemplo a seguir adiciona a opção Oracle OEM a um grupo de opções. Ele também especifica uma porta personalizada e um par de grupos de segurança de VPC do Amazon EC2 a ser usado para essa porta.
Para Linux, macOS ou Unix:
```
aws rds add-option-to-option-group \
--option-group-name testoptiongroup \
--options OptionName=OEM,Port=5500,VpcSecurityGroupMemberships="sg-test1,sg-test2" \
--apply-immediately
```
Para Windows:
```
aws rds add-option-to-option-group ^
--option-group-name testoptiongroup ^
--options OptionName=OEM,Port=5500,VpcSecurityGroupMemberships="sg-test1,sg-test2" ^
--apply-immediately
```
A saída do comando é semelhante à seguinte:
```
OPTIONGROUP False oracle-ee 19 arn:aws:rds:us-east-1:1234567890:og:testoptiongroup Test Option Group testoptiongroup vpc-test
OPTIONS Oracle 12c EM Express OEM False False 5500
VPCSECURITYGROUPMEMBERSHIPS active sg-test1
VPCSECURITYGROUPMEMBERSHIPS active sg-test2
```
**Example**
O exemplo a seguir adiciona a opção Oracle `NATIVE_NETWORK_ENCRYPTION` a um grupo de opções e especifica as configurações de opções. Se nenhuma configuração de opção for especificada, os valores padrão serão usados.
Para Linux, macOS ou Unix:
```
aws rds add-option-to-option-group \
--option-group-name testoptiongroup \
--options '[{"OptionSettings":[{"Name":"SQLNET.ENCRYPTION_SERVER","Value":"REQUIRED"},{"Name":"SQLNET.ENCRYPTION_TYPES_SERVER","Value":"AES256,AES192,DES"}],"OptionName":"NATIVE_NETWORK_ENCRYPTION"}]' \
--apply-immediately
```
Para Windows:
```
aws rds add-option-to-option-group ^
--option-group-name testoptiongroup ^
--options "OptionSettings"=[{"Name"="SQLNET.ENCRYPTION_SERVER","Value"="REQUIRED"},{"Name"="SQLNET.ENCRYPTION_TYPES_SERVER","Value"="AES256\,AES192\,DES"}],"OptionName"="NATIVE_NETWORK_ENCRYPTION" ^
--apply-immediately
```
A saída do comando é semelhante à seguinte:
```
...{
"OptionName": "NATIVE_NETWORK_ENCRYPTION",
"OptionDescription": "Native Network Encryption",
"Persistent": false,
"Permanent": false,
"OptionSettings": [
{
"Name": "SQLNET.ENCRYPTION_TYPES_SERVER",
"Value": "AES256,AES192,DES",
"DefaultValue": "RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40",
"Description": "Specifies list of encryption algorithms in order of intended use",
"ApplyType": "STATIC",
"DataType": "STRING",
"AllowedValues": "RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40",
"IsModifiable": true,
"IsCollection": true
},
{
"Name": "SQLNET.ENCRYPTION_SERVER",
"Value": "REQUIRED",
"DefaultValue": "REQUESTED",
"Description": "Specifies the desired encryption behavior",
"ApplyType": "STATIC",
"DataType": "STRING",
"AllowedValues": "ACCEPTED,REJECTED,REQUESTED,REQUIRED",
"IsModifiable": true,
"IsCollection": false
},...
```
### API do RDS
Para adicionar uma opção a um grupo de opções usando a API do Amazon RDS, chame a operação [ModifyOptionGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html) com a opção que você deseja adicionar. Para habilitar a nova opção imediatamente em todas as instâncias de bancos de dados associadas, inclua o parâmetro `ApplyImmediately` e defina-o como `true`. Por padrão, a opção é habilitada para cada instância de banco de dados associada durante sua próxima janela de manutenção. Inclua o seguinte parâmetro necessário:
+ `OptionGroupName`
## Listar as opções e as configurações de opções para um grupo de opções
Você pode listar todas as opções e configurações de opções para um grupo de opções.
### Console
Você pode usar o Console de gerenciamento da AWS para listar todas as opções e configurações de opções para um grupo de opções.
**Para listar as opções e as configurações de opções para um grupo de opções**
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. No painel de navegação, escolha **Option groups (Grupos de opções)**.
1. Escolha o nome do grupo de opções para exibir seus detalhes. As opções e as configurações de opções no grupo de opções estão listadas.
### AWS CLI
Para listar as opções e as configurações de opções para um grupo de opções, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-option-groups.html) da `describe-option-groups`. Especifique o nome do grupo de opções cujas opções e configurações você deseja visualizar. Se você não especificar um nome de grupo de opções, todos os grupos de opções serão descritos.
**Example**
O exemplo a seguir lista as opções e as configurações de opções para todos os grupos de opções.
```
aws rds describe-option-groups
```
**Example**
O exemplo a seguir lista as opções e as configurações de opções para um grupo de opções denominado `testoptiongroup`.
```
aws rds describe-option-groups --option-group-name testoptiongroup
```
### API do RDS
Para listar as opções e as configurações de opções para um grupo de opções, use a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeOptionGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeOptionGroups.html) da API do Amazon RDS. Especifique o nome do grupo de opções cujas opções e configurações você deseja visualizar. Se você não especificar um nome de grupo de opções, todos os grupos de opções serão descritos.
## Modificar uma configuração de opção
Depois de adicionar uma opção que tenha configurações de opções modificáveis, você pode modificar as configurações a qualquer momento. Se você alterar opções ou configurações de opções em um grupo de opções, essas alterações serão aplicadas a todas as instâncias de bancos de dados associadas a esse grupo de opções. Para obter mais informações sobre quais configurações estão disponíveis para as várias opções, consulte a documentação do mecanismo específico em [Trabalhar com grupos de opções](#USER_WorkingWithOptionGroups).
As alterações do grupo de opções devem ser aplicadas imediatamente em dois casos:
+ Quando você adiciona uma opção que adiciona ou atualiza um valor de porta, como a opção `OEM`.
+ Quando você adiciona ou remove um grupo de opções com uma opção que inclui um valor de porta.
Nesses casos, escolha a opção **Apply Immediately (Aplicar imediatamente)** no console. Outra alternativa é incluir a opção `--apply-immediately` quando usar a AWS CLI ou definir o parâmetro `ApplyImmediately` como `true` ao usar a API do RDS. As opções que não incluem valores de porta podem ser aplicadas imediatamente ou podem ser aplicadas durante a próxima janela de manutenção da instância de banco de dados.
**nota**
Se você especificar um grupo de segurança como um valor para uma opção em um grupo de opções, gerencie o grupo de segurança modificando o grupo de opções. Não é possível alterar ou remover esse grupo de segurança modificando uma instância de banco de dados. Além disso, o grupo de segurança não aparece nos detalhes da instância de banco de dados no Console de gerenciamento da AWS ou na saída do comando AWS CLI da `describe-db-instances`.
### Console
Você pode usar o Console de gerenciamento da AWS para modificar uma configuração de opção.
**Para modificar uma configuração de opção usando o console**
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. No painel de navegação, escolha **Option groups (Grupos de opções)**.
1. Selecione o grupo de opções cuja opção você deseja modificar e escolha **Modify option (Modificar opção)**.
1. Na janela **Modify option (Modificar opção)**, em **Installed Options (Opções instaladas)**, escolha a opção cuja configuração você deseja modificar. Faça as alterações desejadas.
1. Para habilitar a opção assim que você a adicionar, em **Apply Immediately (Aplicar imediatamente)**, escolha **Yes (Sim)**. Se você escolher **No (Não)** (o padrão), a opção será habilitada para cada instância de banco de dados associada durante sua próxima janela de manutenção.
1. Quando estiver satisfeito com as configurações, escolha **Modify Option (Modificar opção)**.
### AWS CLI
Para modificar uma configuração de opção, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) da `add-option-to-option-group` com o grupo de opções e a opção que você deseja modificar. Por padrão, a opção é habilitada para cada instância de banco de dados associada durante sua próxima janela de manutenção. Para aplicar a alteração imediatamente a todas as instâncias de bancos de dados associadas, inclua o parâmetro `--apply-immediately`. Para modificar uma configuração de opção, use o argumento `--settings`.
**Example**
O exemplo a seguir modifica a porta usada pelo Oracle Enterprise Manager Database Control (OEM) em um grupo de opções denominado `testoptiongroup` e aplica imediatamente a alteração.
Para Linux, macOS ou Unix:
```
aws rds add-option-to-option-group \
--option-group-name testoptiongroup \
--options OptionName=OEM,Port=5432,DBSecurityGroupMemberships=default \
--apply-immediately
```
Para Windows:
```
aws rds add-option-to-option-group ^
--option-group-name testoptiongroup ^
--options OptionName=OEM,Port=5432,DBSecurityGroupMemberships=default ^
--apply-immediately
```
A saída do comando é semelhante à seguinte:
```
OPTIONGROUP False oracle-ee 19 arn:aws:rds:us-east-1:1234567890:og:testoptiongroup Test Option Group testoptiongroup
OPTIONS Oracle 12c EM Express OEM False False 5432
DBSECURITYGROUPMEMBERSHIPS default authorized
```
**Example**
O seguinte exemplo modifica a opção Oracle `NATIVE_NETWORK_ENCRYPTION` e altera as configurações de opções.
Para Linux, macOS ou Unix:
```
aws rds add-option-to-option-group \
--option-group-name testoptiongroup \
--options '[{"OptionSettings":[{"Name":"SQLNET.ENCRYPTION_SERVER","Value":"REQUIRED"},{"Name":"SQLNET.ENCRYPTION_TYPES_SERVER","Value":"AES256,AES192,DES,RC4_256"}],"OptionName":"NATIVE_NETWORK_ENCRYPTION"}]' \
--apply-immediately
```
Para Windows:
```
aws rds add-option-to-option-group ^
--option-group-name testoptiongroup ^
--options "OptionSettings"=[{"Name"="SQLNET.ENCRYPTION_SERVER","Value"="REQUIRED"},{"Name"="SQLNET.ENCRYPTION_TYPES_SERVER","Value"="AES256\,AES192\,DES\,RC4_256"}],"OptionName"="NATIVE_NETWORK_ENCRYPTION" ^
--apply-immediately
```
A saída do comando é semelhante à seguinte:
```
OPTIONGROUP False oracle-ee 19 arn:aws:rds:us-east-1:1234567890:og:testoptiongroup Test Option Group testoptiongroup
OPTIONS Oracle Advanced Security - Native Network Encryption NATIVE_NETWORK_ENCRYPTION False False
OPTIONSETTINGS RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40 STATIC STRING
RC4_256,AES256,AES192,3DES168,RC4_128,AES128,3DES112,RC4_56,DES,RC4_40,DES40 Specifies list of encryption algorithms in order of intended use
True True SQLNET.ENCRYPTION_TYPES_SERVER AES256,AES192,DES,RC4_256
OPTIONSETTINGS ACCEPTED,REJECTED,REQUESTED,REQUIRED STATIC STRING REQUESTED Specifies the desired encryption behavior False True SQLNET.ENCRYPTION_SERVER REQUIRED
OPTIONSETTINGS SHA1,MD5 STATIC STRING SHA1,MD5 Specifies list of checksumming algorithms in order of intended use True True SQLNET.CRYPTO_CHECKSUM_TYPES_SERVER SHA1,MD5
OPTIONSETTINGS ACCEPTED,REJECTED,REQUESTED,REQUIRED STATIC STRING REQUESTED Specifies the desired data integrity behavior False True SQLNET.CRYPTO_CHECKSUM_SERVER REQUESTED
```
### API do RDS
Para modificar uma configuração de opção, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html) da API do Amazon RDS com o grupo de opções e a opção que você deseja modificar. Por padrão, a opção é habilitada para cada instância de banco de dados associada durante sua próxima janela de manutenção. Para aplicar a alteração imediatamente a todas as instâncias de bancos de dados associadas, inclua o parâmetro `ApplyImmediately` e defina-o como `true`.
## Remover uma opção de um grupo de opções
Algumas opções podem ser removidas de um grupo de opções e outras não. Uma opção persistente não pode ser removida de um grupo de opções até que todas as instâncias de bancos de dados associadas a esse grupo de opções sejam desassociadas. Uma opção permanente nunca pode ser removida de um grupo de opções. Para obter mais informações sobre quais opções podem ser removidas, consulte a documentação do seu mecanismo específico, listada em [Trabalhar com grupos de opções](#USER_WorkingWithOptionGroups).
Se você remover todas as opções de um grupo de opções, o Amazon RDS não excluirá o grupo de opções. As instâncias de banco de dados associadas ao grupo de opções vazio continuam associadas a ele. Essas instâncias simplesmente não terão opções ativas. Alternativamente, para remover todas as opções de uma instância de banco de dados, você pode associar a instância de banco de dados ao grupo de opções padrão (vazio).
### Console
Você pode usar o Console de gerenciamento da AWS para remover uma opção de um grupo de opções.
**Para remover uma opção de um grupo de opções usando o console**
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. No painel de navegação, escolha **Option groups (Grupos de opções)**.
1. Selecione o grupo de opções cuja opção você deseja remover e escolha **Delete option (Excluir opção)**.
1. Na janela **Delete option (Excluir opção)**, faça o seguinte:
+ Marque a caixa de seleção para a opção que você deseja excluir.
+ Para que a exclusão entre em vigor assim que você a fizer, em **Apply immediately (Aplicar imediatamente)**, escolha **Yes (Sim)**. Se você escolher **No (Não)** (o padrão), a opção será excluída de cada instância de banco de dados associada durante a próxima janela de manutenção.
![\[Excluir grupo de opções\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/optiongroup-removeoption2.png)
1. Quando estiver satisfeito com as configurações, escolha **Yes, Delete (Sim, excluir)**.
### AWS CLI
Para remover uma opção de um grupo de opções, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/remove-option-from-option-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/remove-option-from-option-group.html) com a opção que você deseja excluir. Por padrão, a opção será removida de cada instância de banco de dados associada durante sua próxima janela de manutenção. Para aplicar a alteração imediatamente, inclua o parâmetro `--apply-immediately`.
**Example**
O exemplo a seguir remove a opção Oracle Enterprise Manager Database Control (OEM) de um grupo de opções chamado `testoptiongroup` e aplica imediatamente a alteração.
Para Linux, macOS ou Unix:
```
aws rds remove-option-from-option-group \
--option-group-name testoptiongroup \
--options OEM \
--apply-immediately
```
Para Windows:
```
aws rds remove-option-from-option-group ^
--option-group-name testoptiongroup ^
--options OEM ^
--apply-immediately
```
A saída do comando é semelhante à seguinte:
```
OPTIONGROUP testoptiongroup oracle-ee 19 Test option group
```
### API do RDS
Para remover uma opção de um grupo de opções, use a ação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyOptionGroup.html) da API do Amazon RDS. Por padrão, a opção será removida de cada instância de banco de dados associada durante sua próxima janela de manutenção. Para aplicar a alteração imediatamente, inclua o parâmetro `ApplyImmediately` e configure-o como `true`.
Inclua os seguintes parâmetros:
+ `OptionGroupName`
+ `OptionsToRemove.OptionName`
## Excluir um grupo de opções
Só será possível excluir um grupo de opções se ele atender aos seguintes critérios:
+ Ele não está associado a nenhum recurso do Amazon RDS. Um grupo de opções pode ser associado a uma instância de banco de dados, a um snapshot de banco de dados manual ou a um snapshot de banco de dados automatizado.
+ Ele não é um grupo de opções padrão.
Para identificar os grupos de opções usados pelas instâncias de banco de dados e snapshots de banco de dados, é possível usar os seguintes comandos da CLI:
```
aws rds describe-db-instances \
--query 'DBInstances[*].[DBInstanceIdentifier,OptionGroupMemberships[].OptionGroupName]'
aws rds describe-db-snapshots | jq -r '.DBSnapshots[] | "\(.DBInstanceIdentifier),\(.OptionGroupName)"' | sort | uniq
```
Se você tentar excluir um grupo de opções associado a um recurso do RDS, será retornado um erro semelhante ao seguinte.
```
An error occurred (InvalidOptionGroupStateFault) when calling the DeleteOptionGroup operation: The option group 'optionGroupName' cannot be deleted because it is in use.
```
**Para encontrar os recursos do Amazon RDS associados a um grupo de opções**
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. No painel de navegação, escolha **Option groups (Grupos de opções)**.
1. Escolha o nome do grupo de opções para mostrar seus detalhes.
1. Consulte a seção **Instâncias e snapshots associados** para conhecer os recursos do Amazon RDS associados.
Se uma instância de banco de dados estiver associada ao grupo de opções, modifique-a para usar um grupo de opções diferente. Para ter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
Se um snapshot de banco de dados manual estiver associado ao grupo de opções, modifique esse snapshot para usar um grupo de opções diferente. Faça isso usando o comando [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html) da AWS CLI.
**nota**
Não é possível modificar o grupo de opções de um snapshot de banco de dados automatizado.
### Console
Uma maneira de excluir um grupo de opções é usando o Console de gerenciamento da AWS.
**Para excluir um grupo de opções usando o console**
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. No painel de navegação, escolha **Option groups (Grupos de opções)**.
1. Escolha o grupo de opções.
1. Selecione **Delete group (Excluir grupo)**.
1. Na página de confirmação, escolha **Delete (Excluir)** para concluir a exclusão do grupo de opções ou escolha **Cancel (Cancelar)** para cancelar a exclusão.
### AWS CLI
Para excluir um grupo de opções, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-option-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-option-group.html) com o seguinte parâmetro necessário.
+ `--option-group-name`
**Example**
O exemplo a seguir exclui um grupo de opções denominado `testoptiongroup`.
Para Linux, macOS ou Unix:
```
aws rds delete-option-group \
--option-group-name testoptiongroup
```
Para Windows:
```
aws rds delete-option-group ^
--option-group-name testoptiongroup
```
### API do RDS
Para excluir um grupo de opções, chame a operação [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteOptionGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteOptionGroup.html) da API do Amazon RDS. Inclua o seguinte parâmetro:
+ `OptionGroupName`
# Grupos de parâmetros para Amazon RDS
*Database parameters* (Parâmetros do banco de dados) especifica como o banco de dados é configurado. Por exemplo, os parâmetros do banco de dados podem especificar a quantidade de recursos, como memória, a serem alocados para um banco de dados.
Você gerencia a configuração do banco de dados associando suas instâncias e seus clusters de banco de dados multi-AZ com grupos de parâmetros. O Amazon RDS define grupos de parâmetros com configurações padrão. Você também pode definir seus próprios grupos de parâmetros com configurações personalizadas.
**nota**
Alguns mecanismos de banco de dados oferecem recursos adicionais que você pode adicionar ao seu banco de dados como opções em um grupo de opções. Para obter informações sobre grupos de opções, consulte [Trabalhar com grupos de opções](USER_WorkingWithOptionGroups.md).
**Topics**
+ [Visão geral dos grupos de parâmetros](parameter-groups-overview.md)
+ [Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon RDS](USER_WorkingWithDBInstanceParamGroups.md)
+ [Trabalhar com grupos de parâmetros de clusters de banco de dados multi-AZ](USER_WorkingWithDBClusterParamGroups.md)
+ [Comparação de grupos de parâmetros de banco de dados](USER_WorkingWithParamGroups.Comparing.md)
+ [Especificação de parâmetros de banco de dados](USER_ParamValuesRef.md)
# Visão geral dos grupos de parâmetros
Um *grupo de parâmetros de banco de dados* atua como um contêiner para valores de configuração de mecanismo que são aplicados a uma ou mais instâncias de bancos de dados.
*Grupos de parâmetros de cluster de banco de dados* se aplicam somente a clusters de banco de dados multi-AZ. As configurações do grupo de parâmetros de um cluster de banco de dados multi-AZ se aplicam a todas as instâncias de banco de dados contidas no cluster. O grupo de parâmetros de banco de dados padrão do mecanismo e da versão do mecanismo de banco de dados é usado para cada instância de banco de dados contida no cluster de banco de dados.
**Topics**
+ [Grupos de parâmetros padrão e personalizados](#parameter-groups-overview.custom)
+ [Parâmetros estáticos e dinâmicos de instância de banco de dados](#parameter-groups-overview.db-instance)
+ [Parâmetros estáticos e dinâmicos de cluster de banco de dados](#parameter-groups-overview.maz)
+ [Parâmetros de conjunto de caracteres](#parameter-groups-overview.char-sets)
+ [Parâmetros e valores de parâmetros compatíveis](#parameter-groups-overview.supported)
## Grupos de parâmetros padrão e personalizados
Se você criar uma instância de banco de dados sem especificar um grupo de parâmetros de banco de dados, essa instância usará o grupo de parâmetros de banco de dados padrão. Da mesma forma, se você criar um cluster de banco de dados multi-AZ sem especificar um grupo de parâmetros de cluster de banco de dados, esse cluster usará um grupo de parâmetros de cluster de banco de dados padrão. Cada grupo de parâmetros de banco de dados padrão contém padrões de mecanismo de banco de dados e do sistema Amazon RDS com base no mecanismo, na classe de computação e no armazenamento alocado da instância.
Não é possível modificar as configurações de parâmetros de um grupo de parâmetros padrão. Em vez disso, você pode fazer o seguinte:
1. Crie um novo grupo de parâmetros.
1. Altere as configurações dos parâmetros desejados. Nem todos os parâmetros de mecanismo de banco de dados em um grupo de parâmetros podem ser modificados.
1. Modifique a instância de banco de dados ou o cluster de banco de dados para associar o novo grupo de parâmetros.
Ao associar um novo grupo de parâmetros de banco de dados a uma instância de banco de dados, a associação acontece imediatamente. Para obter informações sobre como modificar uma instância de banco de dados, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). Para obter informações sobre como modificar clusters de banco de dados multi-AZ, consulte [Modificar um cluster de banco de dados multi-AZ para o Amazon RDS](modify-multi-az-db-cluster.md).
**nota**
Se você modificou sua instância de banco de dados para usar um grupo de parâmetros personalizado, e iniciar a instância de banco de dados, o RDS reinicializará automaticamente a instância de banco de dados como parte do processo de inicialização. Para instâncias multi-AZ do RDS para SQL Server com a opção “Sempre ativa” ou “Espelhamento” habilitada, um failover é esperado quando a instância é reiniciada após o processo de inicialização.
O RDS aplica os parâmetros estáticos e dinâmicos modificados a um grupo de parâmetros recém-associado somente depois que a instância de banco de dados é reinicializada. No entanto, se você modificar parâmetros dinâmicos no grupo de parâmetros de banco de dados depois de associá-lo à instância de banco de dados, essas alterações serão aplicadas imediatamente sem uma reinicialização. Para obter mais informações sobre como alterar o grupo de parâmetros de banco de dados, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
Se você atualizar parâmetros dentro de um grupo de parâmetros de banco de dados, as alterações se aplicarão a todas as instâncias de banco de dados associadas a esse grupo de parâmetros. Da mesma forma, se você atualizar os parâmetros dentro de um grupo de parâmetros de cluster de banco de dados multi-AZ, as alterações se aplicarão a todos os clusters do Aurora que estiverem associados a esse grupo.
Se você não quiser criar um grupo de parâmetros do zero, poderá copiar um grupo de parâmetros existente com o comando [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) ou o comando [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) da AWS CLI. Você pode perceber que copiar um grupo de parâmetros é útil em alguns casos. Por exemplo, talvez você queira incluir a maioria dos valores e parâmetros personalizados de um grupo de parâmetros de banco de dados existente em um novo grupo de parâmetros de banco de dados.
## Parâmetros estáticos e dinâmicos de instância de banco de dados
Os parâmetros de instância de banco de dados são estáticos ou dinâmicos. As diferenças são as seguintes:
+ Quando você altera um parâmetro estático e salva o grupo de parâmetros de banco de dados, a alteração entra em vigor depois que você reinicializa as instâncias de banco de dados manualmente. Para parâmetros estáticos, o console sempre usa `pending-reboot` para o `ApplyMethod`.
+ Quando você altera um parâmetro dinâmico, por padrão, a alteração de parâmetro entra em vigor imediatamente, sem a necessidade de reinicialização. Quando você usa o Console de gerenciamento da AWS para alterar os valores dos parâmetros da instância de banco de dados, ele sempre usa `immediate` para `ApplyMethod` para parâmetros dinâmicos. Para adiar a alteração do parâmetro até a finalização da reinicialização de uma instância de banco de dados associada, use a AWS CLI ou a API do RDS. Defina o `ApplyMethod` como `pending-reboot` para a alteração do parâmetro.
**nota**
O uso do `pending-reboot` com parâmetros dinâmicos no AWS CLI ou no API do RDS em instâncias de banco de dados do RDS for SQL Server gera um erro. Use `apply-immediately` no RDS for SQL Server.
Para obter mais informações sobre como usar a AWS CLI para alterar um valor de parâmetro, consulte [modify-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html). Para obter mais informações sobre como usar a API do RDS para alterar um valor de parâmetro, consulte [ModifyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html).
Se uma instância de banco de dados não estiver usando as últimas alterações de seu grupo de parâmetros de banco de dados associado, o console mostrará o status **pending-reboot** para o grupo de parâmetros de banco de dados. Esse status não ocasionará uma reinicialização automática durante a próxima janela de manutenção. Para aplicar as alterações de parâmetro mais recentes a essa instância de banco de dados, reinicialize-a manualmente.
## Parâmetros estáticos e dinâmicos de cluster de banco de dados
Os parâmetros de cluster de banco de dados são estáticos ou dinâmicos. As diferenças são as seguintes:
+ Quando você altera um parâmetro estático e salva o grupo de parâmetros do cluster de banco de dados, a alteração do parâmetro entra em vigor depois que você reinicializa manualmente os clusters de banco de dados associados. Para parâmetros estáticos, o console sempre usa `pending-reboot` para o `ApplyMethod`.
+ Quando você altera um parâmetro dinâmico, por padrão, a alteração de parâmetro entra em vigor imediatamente, sem a necessidade de reinicialização. Quando você usa o Console de gerenciamento da AWS para alterar os valores dos parâmetros do cluster de banco de dados, ele sempre usa `immediate` para `ApplyMethod` para parâmetros dinâmicos. Para adiar a alteração do parâmetro até a reinicialização de um cluster de banco de dados, use a AWS CLI ou a API do RDS. Defina o `ApplyMethod` como `pending-reboot` para a alteração do parâmetro.
Para obter mais informações sobre como usar a AWS CLI para alterar um valor de parâmetro, consulte [modify-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html). Para obter mais informações sobre como usar a API do RDS para alterar um valor de parâmetro, consulte [ModifyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html).
## Parâmetros de conjunto de caracteres
Antes de criar uma instância de banco de dados ou um cluster de banco de dados multi-AZ, defina todos os parâmetros relacionados ao conjunto de caracteres ou ao agrupamento do seu banco de dados no grupo de parâmetros. Também faça isso antes de criar um banco de dados nele. Dessa forma, você garante que o banco de dados padrão e os novos bancos de dados usem o conjunto de caracteres e os valores de agrupamento que você especificar. Se você alterar o conjunto de caracteres ou os parâmetros de agrupamento, as alterações de parâmetros não serão aplicadas aos bancos de dados existentes.
Em mecanismos de bancos de dados, você pode alterar o conjunto de caracteres ou os valores de agrupamento para um banco de dados existente usando o comando `ALTER DATABASE`. Por exemplo:
```
ALTER DATABASE database_name CHARACTER SET character_set_name COLLATE collation;
```
Para obter mais informações sobre como alterar o conjunto de caracteres ou valores de agrupamento de um banco de dados, consulte a documentação referente ao seu mecanismo de banco de dados.
## Parâmetros e valores de parâmetros compatíveis
Para determinar os parâmetros compatíveis com seu mecanismo de banco de dados, visualize os parâmetros no grupo de parâmetros de banco de dados e no grupo de parâmetros do cluster de banco de dados utilizados pela instância ou pelo cluster de banco de dados. Para obter mais informações, consulte [Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Viewing.md) e [Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ViewingCluster.md).
Em muitos casos, é possível especificar valores de parâmetros inteiros e boolianos usando expressões, fórmulas e funções. As funções podem incluir uma expressão matemática de log. No entanto, nem todos os parâmetros são compatíveis com expressões, fórmulas e funções para valores de parâmetros. Para obter mais informações, consulte [Especificação de parâmetros de banco de dados](USER_ParamValuesRef.md).
Definir incorretamente os parâmetros em um grupo de parâmetros pode causar efeitos adversos não intencionais, inclusive diminuição da performance e instabilidade no sistema. Sempre tenha cuidado ao modificar parâmetros de bancos de dados e faça backup dos dados antes de modificar um grupo de parâmetros. Faça testes com alterações de configuração de grupos de parâmetros em uma instância ou um cluster de banco de dados de teste antes de aplicar essas alterações de grupos de parâmetros a uma instância ou um cluster de banco de dados de produção.
# Grupos de parâmetros de banco de dados para instâncias de banco de dados do Amazon RDS
As instâncias de banco de dados usam grupos de parâmetros de banco de dados. As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de instância de banco de dados.
**Topics**
+ [Criar um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Creating.md)
+ [Associar um grupo de parâmetros de banco de dados a uma instância de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Associating.md)
+ [Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Modifying.md)
+ [Redefinir parâmetros em um grupo de parâmetros de banco de dados como seus valores padrão no Amazon RDS](USER_WorkingWithParamGroups.Resetting.md)
+ [Copiar um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Copying.md)
+ [Listar grupos de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Listing.md)
+ [Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Viewing.md)
+ [Excluir um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Deleting.md)
# Criar um grupo de parâmetros de banco de dados no Amazon RDS
Você pode criar um novo grupo de parâmetros de banco de dados usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.
As seguintes limitações se aplicam ao nome do grupo de parâmetros de banco de dados:
+ O nome deve ter de 1 a 255 letras, números ou hifens.
Os nomes de grupos de parâmetros padrão podem incluir um ponto, como `default.mysql8.0`. No entanto, nomes de grupos de parâmetros personalizados não podem incluir um ponto.
+ O primeiro caractere deve ser uma letra.
+ O nome não pode terminar com hífen nem conter dois hífens consecutivos.
## Console
**Para criar um grupo de parâmetros de banco de dados**
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. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
1. Escolha **Create parameter group (Criar grupo de parâmetros)**.
1. Em **Nome do grupo de parâmetros**, digite o nome do novo grupo de parâmetros de banco de dados.
1. Em **Descrição**, digite uma descrição para o novo grupo de parâmetros de banco de dados.
1. Em **Tipo de mecanismo**, escolha o mecanismo de banco de dados.
1. Em **Família de grupos de parâmetros**, selecione uma família de grupos de parâmetros de banco de dados.
1. Em **Tipo**, se aplicável, selecione **Grupo de parâmetros de banco de dados**.
1. Escolha **Criar**.
## AWS CLI
Para criar um grupo de parâmetros de banco de dados, use o comando AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-parameter-group.html)da . O exemplo a seguir cria um grupo de parâmetros de banco de dados chamado *mydbparametergroup* para o MySQL versão 8.0 com a descrição "*My new parameter group (Meu novo grupo de parâmetros)*."
Inclua os seguintes parâmetros necessários:
+ `--db-parameter-group-name`
+ `--db-parameter-group-family`
+ `--description`
Para listar todas as famílias de grupos de parâmetros disponíveis, use o comando a seguir:
```
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
```
**nota**
A saída contém duplicatas.
**Example**
Para Linux, macOS ou Unix:
```
aws rds create-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--db-parameter-group-family MySQL8.0 \
--description "My new parameter group"
```
Para Windows:
```
aws rds create-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--db-parameter-group-family MySQL8.0 ^
--description "My new parameter group"
```
O comando gerará uma saída semelhante à seguinte:
```
DBPARAMETERGROUP mydbparametergroup mysql8.0 My new parameter group
```
## API do RDS
Para criar um grupo de parâmetros de banco de dados, use a operação da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBParameterGroup.html) do RDS.
Inclua os seguintes parâmetros necessários:
+ `DBParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
# Associar um grupo de parâmetros de banco de dados a uma instância de banco de dados no Amazon RDS
Você pode criar seus próprios grupos de parâmetros de banco de dados com configurações personalizadas. Você pode associar um grupo de parâmetros de banco de dados a uma instância de banco de dados usando a Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. Você pode fazer isso ao criar ou modificar uma instância de banco de dados.
Para obter mais informações sobre como criar um grupo de parâmetros de banco de dados, consulte [Criar um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Creating.md). Para obter informações sobre como criar uma instância de banco de dados, consulte [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md). Para ter mais informações sobre como modificar uma instância de banco de dados, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
**nota**
Ao associar um novo grupo de parâmetros de banco de dados a uma instância de banco de dados, os parâmetros estáticos e dinâmicos modificados serão aplicados somente após a reinicialização da instância de banco de dados. No entanto, se você modificar parâmetros dinâmicos no grupo de parâmetros de banco de dados depois de associá-lo à instância de banco de dados, essas alterações serão aplicadas imediatamente sem uma reinicialização.
## Console
**Para associar um grupo de parâmetros de banco de dados a uma instância de banco de dados**
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. No painel de navegação, escolha **Databases (Bancos de dados)** e a instância de banco de dados que você deseja modificar.
1. Selecione **Modify**. A página **Modify DB instance (Modificar instância de banco de dados)** será exibida.
1. Altere a configuração do **grupo de parâmetros de banco de dados**.
1. Escolha **Continue** (Continuar) e verifique o resumo de modificações.
1. (Opcional) Escolha **Apply immediately** (Aplicar imediatamente) para aplicar as alterações imediatamente. Escolher essa opção pode causar uma interrupção em alguns casos. Para obter mais informações, consulte [Usar a configuração de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).
1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modify DB Instance (Modificar instância de banco de dados)** para salvar suas alterações.
Ou escolha **Back (Voltar)** para editar as alterações ou **Cancel (Cancelar)** para cancelar as alterações.
## AWS CLI
Para associar um grupo de parâmetros de banco de dados a uma instância de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) com as seguintes opções:
+ `--db-instance-identifier`
+ `--db-parameter-group-name`
O exemplo a seguir associa o grupo de parâmetros de banco de dados `mydbpg` à instância de banco de dados `database-1`. As alterações são aplicadas imediatamente usando `--apply-immediately`. Use `--no-apply-immediately` para aplicar alterações durante a próxima janela de manutenção. Para obter mais informações, consulte [Usar a configuração de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).
**Example**
Para Linux, macOS ou Unix:
```
aws rds modify-db-instance \
--db-instance-identifier database-1 \
--db-parameter-group-name mydbpg \
--apply-immediately
```
Para Windows:
```
aws rds modify-db-instance ^
--db-instance-identifier database-1 ^
--db-parameter-group-name mydbpg ^
--apply-immediately
```
## API do RDS
Para associar um grupo de parâmetros de banco de dados a uma instância de banco de dados, use a operação da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) do RDS com os seguintes parâmetros:
+ `DBInstanceName`
+ `DBParameterGroupName`
# Modificar parâmetros em um grupo de parâmetros de banco de dados no Amazon RDS
Você pode modificar valores de parâmetros em um grupo de parâmetros de banco de dados criado pelo cliente, mas não pode alterar os valores dos parâmetros em um grupo de parâmetros de banco de dados padrão. As alterações em parâmetros em um grupo de parâmetros de banco de dados criado pelo cliente são aplicadas a todas as instâncias de bancos de dados que estão associadas a esse grupo de parâmetros.
Existem dois tipos de parâmetros: dinâmicos e estáticos. As alterações em parâmetros dinâmicos são aplicadas à instância de banco de dados imediatamente sem uma reinicialização. As alterações feitas em parâmetros estáticos só serão aplicadas depois que a instância de banco de dados for reinicializada.
O console do RDS mostra o status do grupo de parâmetros de banco de dados associado a uma instância de banco de dados na guia **Configuration (Configuração)**. Por exemplo, se a instância de banco de dados não estiver usando as últimas alterações do grupo de parâmetros de banco de dados associado, o console do RDS mostrará o grupo de parâmetros de banco de dados com um status de **pending-reboot (reinicialização pendente)**. Para aplicar as alterações de parâmetro mais recentes a essa instância de banco de dados, reinicialize-a manualmente.
![\[Cenário de reinicialização pendente para alteração de parâmetro\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/param-reboot.png)
## Console
**Como modificar os parâmetros em um grupo de parâmetros de banco de dados**
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. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
1. Na lista, selecione o grupo de parâmetros que você deseja modificar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. Altere os valores dos parâmetros que você deseja modificar. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo.
Não altere valores em um grupo de parâmetros padrão.
1. Escolha **Save changes** (Salvar alterações).
## AWS CLI
Para copiar um grupo de parâmetros de banco de dados, use o comando AWS CLI[https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-parameter-group.html) com as seguintes opções obrigatórias:
+ `--db-parameter-group-name`
+ `--parameters`
O exemplo a seguir modifica os valores ` max_connections` e `max_allowed_packet` no grupo de parâmetros de banco de dados chamado *mydbparametergroup*.
**Example**
Para Linux, macOS ou Unix:
```
aws rds modify-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" \
"ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"
```
Para Windows:
```
aws rds modify-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--parameters "ParameterName=max_connections,ParameterValue=250,ApplyMethod=immediate" ^
"ParameterName=max_allowed_packet,ParameterValue=1024,ApplyMethod=immediate"
```
O comando produz uma saída como a seguinte:
```
DBPARAMETERGROUP mydbparametergroup
```
## API do RDS
Para copiar um grupo de parâmetros de banco de dados, use a operação da API [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBParameterGroup.html) do RDS com os seguintes parâmetros obrigatórios:
+ `DBParameterGroupName`
+ `Parameters`
# Redefinir parâmetros em um grupo de parâmetros de banco de dados como seus valores padrão no Amazon RDS
Você pode redefinir valores de parâmetro em um grupo de parâmetros de banco de dados criado pelo cliente para seus valores padrão. As alterações em parâmetros em um grupo de parâmetros de banco de dados criado pelo cliente são aplicadas a todas as instâncias de bancos de dados que estão associadas a esse grupo de parâmetros.
Ao usar o console, você pode redefinir parâmetros específicos como seus valores padrão. No entanto, não é possível redefinir facilmente todos os parâmetros no grupo de parâmetros de banco de dados de uma só vez. Ao usar A AWS CLI ou a API do RDS, você pode redefinir parâmetros específicos como seus valores padrão. Você também pode redefinir todos os parâmetros no grupo de parâmetros de banco de dados de uma só vez.
As alterações em alguns parâmetros são aplicadas à instância de banco de dados imediatamente sem uma reinicialização. As alterações feitas em outros parâmetros só serão aplicadas depois que a instância de banco de dados no cluster de banco de dados for reinicializada. O console do RDS mostra o status do grupo de parâmetros de banco de dados associado a uma instância de banco de dados na guia **Configuration (Configuração)**. Por exemplo, suponha que a instância de banco de dados não esteja usando as últimas alterações do grupo de parâmetros de banco de dados associado. Se sim, o console do RDS mostrará o grupo de parâmetros de banco de dados com o status **pending-reboot**. Para aplicar as alterações de parâmetro mais recentes a essa instância de banco de dados, reinicialize-a manualmente.
![\[Cenário de reinicialização pendente para alteração de parâmetro\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/param-reboot.png)
**nota**
Em um grupo de parâmetros de banco de dados padrão, os parâmetros são sempre definidos para seus valores padrão.
## Console
**Para redefinir parâmetros em um grupo de parâmetros de banco de dados para seus valores padrão**
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. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. Escolha os parâmetros que você deseja redefinir para os valores padrão. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo.
Não redefina os valores em um grupo de parâmetros padrão.
1. Escolha **Reset (Redefinir)** e, em seguida, confirme escolhendo **Reset parameters (Redefinir parâmetros)**.
## AWS CLI
Para redefinir alguns ou todos os parâmetros em um grupo de parâmetros de banco de dados, use o comando AWS CLI da [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-parameter-group.html) com a seguinte opção necessária: `--db-parameter-group-name`.
Para redefinir todos os parâmetros no grupo de parâmetros de banco de dados, especifique a opção `--reset-all-parameters`. Para redefinir parâmetros específicos, especifique a opção `--parameters`.
O exemplo a seguir redefine todos os parâmetros no grupo de parâmetros de banco de dados chamado *mydbparametergroup* para seus valores padrão.
**Example**
Para Linux, macOS ou Unix:
```
aws rds reset-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--reset-all-parameters
```
Para Windows:
```
aws rds reset-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--reset-all-parameters
```
O exemplo a seguir redefine as pções `max_connections` e `max_allowed_packet` para seus valores padrão no grupo de parâmetros de banco de dados chamado *mydbparametergroup*.
**Example**
Para Linux, macOS ou Unix:
```
aws rds reset-db-parameter-group \
--db-parameter-group-name mydbparametergroup \
--parameters "ParameterName=max_connections,ApplyMethod=immediate" \
"ParameterName=max_allowed_packet,ApplyMethod=immediate"
```
Para Windows:
```
aws rds reset-db-parameter-group ^
--db-parameter-group-name mydbparametergroup ^
--parameters "ParameterName=max_connections,ApplyMethod=immediate" ^
"ParameterName=max_allowed_packet,ApplyMethod=immediate"
```
O comando produz uma saída como a seguinte:
```
DBParameterGroupName mydbparametergroup
```
## API do RDS
Para redefinir parâmetros em um grupo de parâmetros de banco de dados para seus valores padrão, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBParameterGroup.html) da API do RDS com o seguinte parâmetro necessário: `DBParameterGroupName`.
Para redefinir todos os parâmetros no grupo de parâmetro de banco de dados, defina o parâmetro `ResetAllParameters` como `true`. Para redefinir parâmetros específicos, especifique o parâmetro `Parameters`.
# Copiar um grupo de parâmetros de banco de dados no Amazon RDS
Você pode copiar os grupos de parâmetros de banco de dados personalizados que criou. Copiar um grupo de parâmetros pode ser uma solução conveniente. Um exemplo é quando você criou um grupo de parâmetros de banco de dados e quer incluir a maioria de seus parâmetros e valores personalizados em um novo grupo de parâmetros de banco de dados. Você pode copiar um grupo de parâmetros de banco de dados usando o Console de gerenciamento da AWS. Também é possível usar o comando [copy-db-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) da AWS CLI ou a operação da API [CopyDBParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) do RDS.
Depois de copiar um grupo de parâmetros de banco de dados, você deve esperar pelo menos 5 minutos antes de criar sua primeira instância de banco de dados que usa esse grupo de parâmetros de banco de dados como o padrão. Isso permite que o Amazon RDS conclua completamente a ação de cópia antes que o grupo de parâmetros seja usado. Isso é especialmente importante para parâmetros que são críticos ao criar o banco de dados padrão para uma instância de banco de dados. Um exemplo é o conjunto de caracteres para o banco de dados padrão definido pelo parâmetro `character_set_database`. Use opção **Parameter Groups (Grupos de parâmetros)** do [console do Amazon RDS](https://console.aws.amazon.com/rds/) ou o comando [describe-db-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) para verificar se o seu grupo de parâmetros de banco de dados foi criado.
**nota**
Não é possível copiar um grupo de parâmetros padrão. No entanto, é possível criar um grupo de parâmetros com base em um grupo de parâmetros padrão.
Não é possível copiar um grupo de parâmetros de banco de dados para uma Conta da AWS ou Região da AWS diferente.
## Console
**Para copiar um grupo de parâmetros de banco de dados**
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. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Copy (Copiar)**.
1. Em **New DB parameter group identifier (Novo identificador do grupo de parâmetros do banco de dados)**, digite um nome para o novo grupo de parâmetros.
1. Em **Description (Descrição)**, digite uma descrição para o novo grupo de parâmetros.
1. Escolha **Copiar**.
## AWS CLI
Para copiar um grupo de parâmetros de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-parameter-group.html) com as seguintes opções obrigatórias:
+ `--source-db-parameter-group-identifier`
+ `--target-db-parameter-group-identifier`
+ `--target-db-parameter-group-description`
O exemplo a seguir cria um novo grupo de parâmetros de banco de dados chamado `mygroup2` que é uma cópia do grupo de parâmetros de banco de dados `mygroup1`.
**Example**
Para Linux, macOS ou Unix:
```
aws rds copy-db-parameter-group \
--source-db-parameter-group-identifier mygroup1 \
--target-db-parameter-group-identifier mygroup2 \
--target-db-parameter-group-description "DB parameter group 2"
```
Para Windows:
```
aws rds copy-db-parameter-group ^
--source-db-parameter-group-identifier mygroup1 ^
--target-db-parameter-group-identifier mygroup2 ^
--target-db-parameter-group-description "DB parameter group 2"
```
## API do RDS
Para copiar um grupo de parâmetros de banco de dados, use a operação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `SourceDBParameterGroupIdentifier`
+ `TargetDBParameterGroupIdentifier`
+ `TargetDBParameterGroupDescription`
# Listar grupos de parâmetros de banco de dados no Amazon RDS
Você pode listar os grupos de parâmetros de banco de dados que criou para sua conta da AWS.
**nota**
Grupos de parâmetros padrão são criados automaticamente a partir de um template de parâmetro padrão quando você cria uma instância de banco de dados para um mecanismo e uma versão de banco de dados específicos. Esses grupos de parâmetros padrão contêm configurações de parâmetros preferenciais e não podem ser modificados. Quando você cria um grupo de parâmetros personalizado, pode modificar as configurações desses parâmetros.
## Console
**Para listar todos os grupos de parâmetros de banco de dados para uma conta da AWS**
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. No painel de navegação, selecione **Parameter groups**.
Os grupos de parâmetros de banco de dados aparecem em uma lista.
## AWS CLI
Para listar todos os grupos de parâmetros de banco de dados de uma conta da AWS, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameter-groups.html) da `describe-db-parameter-groups`.
**Example**
O exemplo a seguir lista todos os grupos de parâmetros de banco de dados para uma conta da AWS.
```
aws rds describe-db-parameter-groups
```
O comando retorna uma resposta como a seguinte:
```
DBPARAMETERGROUP default.mysql8.0 mysql8.0 Default parameter group for MySQL8.0
DBPARAMETERGROUP mydbparametergroup mysql8.0 My new parameter group
```
O exemplo a seguir descreve o grupo de parâmetros *mydbparamgroup1*.
Para Linux, macOS ou Unix:
```
aws rds describe-db-parameter-groups \
--db-parameter-group-name mydbparamgroup1
```
Para Windows:
```
aws rds describe-db-parameter-groups ^
--db-parameter-group-name mydbparamgroup1
```
O comando retorna uma resposta como a seguinte:
```
DBPARAMETERGROUP mydbparametergroup1 mysql8.0 My new parameter group
```
## API do RDS
Para listar todos os grupos de parâmetros de banco de dados para uma conta da AWS, use a operação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameterGroups.html).
# Visualizar valores de parâmetros para um grupo de parâmetros de banco de dados no Amazon RDS
Você pode obter uma lista de todos os parâmetros em um grupo de parâmetros de banco de dados e seus valores.
## Console
**Para visualizar os valores de parâmetros para um grupo de parâmetros de banco de dados**
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. No painel de navegação, selecione **Parameter groups**.
Os grupos de parâmetros de banco de dados aparecem em uma lista.
1. Escolha o nome do grupo de parâmetros para ver sua lista de parâmetros.
## AWS CLI
Para visualizar os valores de parâmetros para um grupo de parâmetros de banco de dados, use o comando [AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-parameters.html) da `describe-db-parameters` com o seguinte parâmetro obrigatório.
+ `--db-parameter-group-name`
**Example**
O exemplo a seguir lista os parâmetros e os valores de parâmetros para um grupo de parâmetros de banco de dados chamado *mydbparametergroup.*
```
aws rds describe-db-parameters --db-parameter-group-name mydbparametergroup
```
O comando retorna uma resposta como a seguinte:
```
DBPARAMETER Parameter Name Parameter Value Source Data Type Apply Type Is Modifiable
DBPARAMETER allow-suspicious-udfs engine-default boolean static false
DBPARAMETER auto_increment_increment engine-default integer dynamic true
DBPARAMETER auto_increment_offset engine-default integer dynamic true
DBPARAMETER binlog_cache_size 32768 system integer dynamic true
DBPARAMETER socket /tmp/mysql.sock system string static false
```
## API do RDS
Para visualizar os valores de parâmetros para um grupo de parâmetros de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) da API do RDS com o seguinte parâmetro necessário.
+ `DBParameterGroupName`
# Excluir um grupo de parâmetros de banco de dados no Amazon RDS
É possível excluir um grupo de parâmetros de banco de dados usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. Um grupo de parâmetros será elegível para exclusão somente se não estiver associado a uma instância de banco de dados.
## Console
**Como excluir um grupo de parâmetros de banco de dados**
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. No painel de navegação, selecione **Parameter groups**.
Os grupos de parâmetros de banco de dados aparecem em uma lista.
1. Escolha o nome dos grupos de parâmetros a serem excluídos.
1. Escolha **Ações** e então **Excluir**.
1. Revise os nomes dos grupos de parâmetros e escolha **Excluir**.
## AWS CLI
Para excluir um grupo de parâmetros de banco de dados, use o comando [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-parameter-group.html) da AWS CLI com o parâmetro exigido a seguir.
+ `--db-parameter-group-name`
**Example**
O exemplo a seguir exclui um grupo de parâmetros de banco de dados chamado *mydbparametergroup*.
```
aws rds delete-db-parameter-group --db-parameter-group-name mydbparametergroup
```
## API do RDS
Para excluir um grupo de parâmetros de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBParameterGroup.html) da API do RDS com o parâmetro exigido a seguir.
+ `DBParameterGroupName`
# Trabalhar com grupos de parâmetros de clusters de banco de dados multi-AZ
Clusters de banco de dados multi-AZ usam grupos de parâmetros de cluster de banco de dados As seções a seguir descrevem a configuração e o gerenciamento de grupos de parâmetros de cluster de banco de dados.
**Topics**
+ [Criar um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.CreatingCluster.md)
+ [Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ModifyingCluster.md)
+ [Redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ResettingCluster.md)
+ [Copiar um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.CopyingCluster.md)
+ [Listar grupos de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ListingCluster.md)
+ [Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.ViewingCluster.md)
+ [Excluir um grupo de parâmetros de cluster de banco de dados](USER_WorkingWithParamGroups.DeletingCluster.md)
# Criar um grupo de parâmetros de cluster de banco de dados
Você pode criar um novo grupo de parâmetros de cluster de banco de dados usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.
Depois de criar um grupo de parâmetros de cluster de banco de dados, você deve esperar pelo menos 5 minutos antes de criar seu primeiro cluster que usa esse grupo de parâmetros de cluster de banco de dados. Isso permite que o Amazon RDS conclua totalmente a criação do grupo de parâmetros antes que seja usado pelo novo cluster de banco de dados. É possível usar a página **Parameter Groups** (Grupos de parâmetros) do [console do Amazon RDS](https://console.aws.amazon.com/rds/) ou o comando [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) para verificar se o seu grupo de parâmetros de cluster de banco de dados foi criado.
As seguintes limitações se aplicam ao nome do grupo de parâmetros do cluster de banco de dados:
+ O nome deve ter de 1 a 255 letras, números ou hifens.
Os nomes de grupos de parâmetros padrão podem incluir um ponto, como `default.mysql5.7`. No entanto, nomes de grupos de parâmetros personalizados não podem incluir um ponto.
+ O primeiro caractere deve ser uma letra.
+ O nome não pode terminar com hífen nem conter dois hífens consecutivos.
## Console
**Para criar um grupo de parâmetros de cluster de banco de dados**
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. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
1. Escolha **Criar grupo de parâmetros**.
1. Em **Nome do grupo de parâmetros**, insira o nome do novo grupo de parâmetros do cluster de banco de dados.
1. Em **Descrição**, insira uma descrição para o novo grupo de parâmetros do cluster de banco de dados.
1. Em **Tipo de mecanismo**, escolha o mecanismo de banco de dados.
1. Em **Família de grupos de parâmetros**, selecione uma família de grupos de parâmetros de banco de dados.
1. Escolha **Criar**.
## AWS CLI
Para criar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster-parameter-group.html).
O exemplo a seguir cria um grupo de parâmetros de cluster de banco de dados chamado *mydbclusterparametergroup* para o RDS para MySQL versão 8.0 com a descrição "*My new parameter group*” (Meu novo grupo de parâmetros).
Inclua os seguintes parâmetros necessários:
+ `--db-cluster-parameter-group-name`
+ `--db-parameter-group-family`
+ `--description`
Para listar todas as famílias de grupos de parâmetros disponíveis, use o comando a seguir:
```
aws rds describe-db-engine-versions --query "DBEngineVersions[].DBParameterGroupFamily"
```
**nota**
A saída contém duplicatas.
**Example**
Para Linux, macOS ou Unix:
```
aws rds create-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclusterparametergroup \
--db-parameter-group-family mysql8.0 \
--description "My new cluster parameter group"
```
Para Windows:
```
aws rds create-db-cluster-parameter-group ^
--db-cluster-parameter-group-name mydbclusterparametergroup ^
--db-parameter-group-family mysql8.0 ^
--description "My new cluster parameter group"
```
O comando gerará uma saída semelhante à seguinte:
```
{
"DBClusterParameterGroup": {
"DBClusterParameterGroupName": "mydbclusterparametergroup",
"DBParameterGroupFamily": "mysql8.0",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup2"
}
}
```
## API do RDS
Para criar um grupo de parâmetros de cluster de banco de dados, use a ação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBClusterParameterGroup.html).
Inclua os seguintes parâmetros necessários:
+ `DBClusterParameterGroupName`
+ `DBParameterGroupFamily`
+ `Description`
# Modificar parâmetros em um grupo de parâmetros de cluster de banco de dados
É possível modificar valores de parâmetros em um grupo de parâmetros do cluster de banco de dados criado pelo cliente. Não é possível alterar os valores de parâmetros em um grupo de parâmetros do cluster de banco de dados padrão. As alterações dos parâmetros em um grupo de parâmetros de cluster de banco de dados criado pelo cliente são aplicadas a todos os clusters de bancos de dados que estão associados a esse grupo de parâmetros de cluster de banco de dados.
## Console
**Para modificar um grupo de parâmetros de cluster de banco de dados**
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. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros que você deseja modificar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. Altere os valores dos parâmetros que você deseja modificar. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo.
Não altere valores em um grupo de parâmetros padrão.
1. Selecione **Save changes**.
1. Reinicialize a cluster para aplicar as alterações a ela.
Se você não o cluster, uma operação de failover poderá levar mais tempo do que o normal.
## AWS CLI
Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster-parameter-group.html) com os seguintes parâmetros obrigatórios:
+ `--db-cluster-parameter-group-name`
+ `--parameters`
O exemplo a seguir modifica os valores `server_audit_logging` e `server_audit_logs_upload` no grupo de parâmetros de cluster de banco de dados chamado *mydbclusterparametergroup*.
**Example**
Para Linux, macOS ou Unix:
```
aws rds modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclusterparametergroup \
--parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
"ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
Para Windows:
```
aws rds modify-db-cluster-parameter-group ^
--db-cluster-parameter-group-name mydbclusterparametergroup ^
--parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
"ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
O comando produz uma saída como a seguinte:
```
DBCLUSTERPARAMETERGROUP mydbclusterparametergroup
```
## API do RDS
Para modificar um grupo de parâmetros de cluster de banco de dados, use o comando da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBClusterParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `DBClusterParameterGroupName`
+ `Parameters`
# Redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados
Você pode redefinir parâmetros para seus valores padrão em um grupo de parâmetro de cluster de banco de dados criado pelo cliente. As alterações dos parâmetros em um grupo de parâmetros de cluster de banco de dados criado pelo cliente são aplicadas a todos os clusters de bancos de dados que estão associados a esse grupo de parâmetros de cluster de banco de dados.
**nota**
Em um grupo de parâmetro de cluster de banco de dados padrão, os parâmetros são sempre definidos como seus valores padrão.
## Console
**Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão**
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. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Edit (Editar)**.
1. Escolha os parâmetros que você deseja redefinir para os valores padrão. Você pode percorrer os parâmetros usando as teclas de seta no canto superior direito da caixa de diálogo.
Não redefina os valores em um grupo de parâmetros padrão.
1. Escolha **Reset (Redefinir)** e, em seguida, confirme escolhendo **Reset parameters (Redefinir parâmetros)**.
1. Reinicialize a cluster do banco de dados.
## AWS CLI
Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/reset-db-cluster-parameter-group.html) com a seguinte opção obrigatória: `--db-cluster-parameter-group-name`.
Para redefinir todos os parâmetros no grupo de parâmetro do cluster de banco de dados, especifique a opção `--reset-all-parameters`. Para redefinir parâmetros específicos, especifique a opção `--parameters`.
O exemplo a seguir redefine todos os parâmetros no grupo de parâmetros de banco de dados chamado *mydbparametergroup* para seus valores padrão.
**Example**
Para Linux, macOS ou Unix:
```
aws rds reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbparametergroup \
--reset-all-parameters
```
Para Windows:
```
aws rds reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name mydbparametergroup ^
--reset-all-parameters
```
O exemplo a seguir redefine os valores padrão `server_audit_logging` e `server_audit_logs_upload` no grupo de parâmetro de cluster de banco de dados chamado *mydbclusterparametergroup*.
**Example**
Para Linux, macOS ou Unix:
```
aws rds reset-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclusterparametergroup \
--parameters "ParameterName=server_audit_logging,ApplyMethod=immediate" \
"ParameterName=server_audit_logs_upload,ApplyMethod=immediate"
```
Para Windows:
```
aws rds reset-db-cluster-parameter-group ^
--db-cluster-parameter-group-name mydbclusterparametergroup ^
--parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" ^
"ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
```
O comando produz uma saída como a seguinte:
```
DBClusterParameterGroupName mydbclusterparametergroup
```
## API do RDS
Para redefinir parâmetros em um grupo de parâmetros de cluster de banco de dados para seus valores padrão, use o comando da API do RDS de [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ResetDBClusterParameterGroup.html) com o seguinte parâmetro necessário: `DBClusterParameterGroupName`.
Para redefinir todos os parâmetros no grupo de parâmetros do cluster de banco de dados, defina o parâmetro `ResetAllParameters` para `true`. Para redefinir parâmetros específicos, especifique o parâmetro `Parameters`.
# Copiar um grupo de parâmetros de cluster de banco de dados
Você pode copiar os grupos de parâmetros de cluster de banco de dados personalizados que criou. Copiar um grupo de parâmetros é uma solução conveniente quando você já criou um grupo de parâmetros de cluster de banco de dados e deseja incluir a maioria dos parâmetros e valores personalizados desse grupo em um novo grupo de parâmetros de cluster de banco de dados. É possível copiar um grupo de parâmetros de cluster de banco de dados usando o comando AWS CLI [copy-db-cluster-parameter-group](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) ou a operação da API do RDS [CopyDBClusterParameterGroup](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBParameterGroup.html).
Depois de copiar um grupo de parâmetros de cluster de banco de dados, você deve esperar pelo menos 5 minutos antes de criar seu primeiro cluster que usa esse grupo de parâmetros de cluster de banco de dados. Isso permite que o Amazon RDS conclua totalmente a cópia do grupo de parâmetros antes que seja usado pelo novo cluster de banco de dados. É possível usar a página **Parameter Groups** (Grupos de parâmetros) do [console do Amazon RDS](https://console.aws.amazon.com/rds/) ou o comando [describe-db-cluster-parameters](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) para verificar se o seu grupo de parâmetros de cluster de banco de dados foi criado.
**nota**
Não é possível copiar um grupo de parâmetros padrão. No entanto, é possível criar um grupo de parâmetros com base em um grupo de parâmetros padrão.
Não é possível copiar um grupo de parâmetros de cluster de banco de dados para uma Conta da AWS ou Região da AWS diferente.
## Console
**Para copiar um grupo de parâmetros de cluster de banco de dados**
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. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha o grupo de parâmetros personalizado que você deseja copiar.
1. Em **Parameter group actions (Ações do grupo de parâmetros)**, escolha **Copy (Copiar)**.
1. Em **New DB parameter group identifier (Novo identificador do grupo de parâmetros do banco de dados)**, digite um nome para o novo grupo de parâmetros.
1. Em **Description (Descrição)**, digite uma descrição para o novo grupo de parâmetros.
1. Escolha **Copiar**.
## AWS CLI
Para copiar um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/copy-db-cluster-parameter-group.html) com os seguintes parâmetros obrigatórios:
+ `--source-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-identifier`
+ `--target-db-cluster-parameter-group-description`
O exemplo a seguir cria um novo grupo de parâmetros de cluster de banco de dados chamado `mygroup2` que é uma cópia do grupo de parâmetros de cluster de banco de dados `mygroup1`.
**Example**
Para Linux, macOS ou Unix:
```
aws rds copy-db-cluster-parameter-group \
--source-db-cluster-parameter-group-identifier mygroup1 \
--target-db-cluster-parameter-group-identifier mygroup2 \
--target-db-cluster-parameter-group-description "DB parameter group 2"
```
Para Windows:
```
aws rds copy-db-cluster-parameter-group ^
--source-db-cluster-parameter-group-identifier mygroup1 ^
--target-db-cluster-parameter-group-identifier mygroup2 ^
--target-db-cluster-parameter-group-description "DB parameter group 2"
```
## API do RDS
Para copiar um grupo de parâmetros de cluster de banco de dados, use a operação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CopyDBClusterParameterGroup.html) com os seguintes parâmetros obrigatórios:
+ `SourceDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupIdentifier`
+ `TargetDBClusterParameterGroupDescription`
# Listar grupos de parâmetros de cluster de banco de dados
Você pode listar os grupos de parâmetros do cluster de banco de dados que criou para sua conta da AWS.
**nota**
Grupos de parâmetros padrão são criados automaticamente a partir de um modelo de parâmetro padrão quando você cria um cluster de banco de dados para um mecanismo e uma versão de banco de dados específicos. Esses grupos de parâmetros padrão contêm configurações de parâmetros preferenciais e não podem ser modificados. Quando você cria um grupo de parâmetros personalizado, pode modificar as configurações desses parâmetros.
## Console
**Para listar todos os grupos de parâmetros do cluster de banco de dados para uma conta da AWS**
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. No painel de navegação, selecione **Parameter groups**.
Os parameter groups de cluster de banco de dados são exibidos na lista com **DB cluster parameter group (Parameter group de cluster de banco de dados)** para o **Type (Tipo)**.
## AWS CLI
Para listar todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-clusterparameter-groups.html).
**Example**
O exemplo a seguir lista todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS.
```
aws rds describe-db-cluster-parameter-groups
```
O exemplo a seguir descreve o grupo de parâmetros *mydbclusterparametergroup*.
Para Linux, macOS ou Unix:
```
aws rds describe-db-cluster-parameter-groups \
--db-cluster-parameter-group-name mydbclusterparametergroup
```
Para Windows:
```
aws rds describe-db-cluster-parameter-groups ^
--db-cluster-parameter-group-name mydbclusterparametergroup
```
O comando retorna uma resposta como a seguinte:
```
{
"DBClusterParameterGroups": [
{
"DBClusterParameterGroupName": "mydbclusterparametergroup2",
"DBParameterGroupFamily": "mysql8.0",
"Description": "My new cluster parameter group",
"DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterparametergroup"
}
]
}
```
## API do RDS
Para listar todos os grupos de parâmetros de cluster de banco de dados de uma conta da AWS, use a ação da API do RDS [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBClusterParameterGroups.html).
# Visualizar valores de parâmetros de um grupo de parâmetros de cluster de banco de dados
Você pode obter uma lista de todos os parâmetros em um grupo de parâmetros de cluster de banco de dados e seus valores.
## Console
**Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados**
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. No painel de navegação, selecione **Parameter groups**.
Os grupos de parâmetros de cluster de banco de dados são exibidos na lista com **DB cluster parameter group (Grupo de parâmetros de cluster de banco de dados)** para o **Type (Tipo)**.
1. Escolha o nome do grupo de parâmetros de cluster de banco de dados para ver sua lista de parâmetros.
## AWS CLI
Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados, use o comando da AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-cluster-parameters.html) com o parâmetro obrigatório a seguir.
+ `--db-cluster-parameter-group-name`
**Example**
O exemplo a seguir lista os parâmetros e os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados chamado *mydbclusterparametergroup*, no formato JSON.
O comando retorna uma resposta como a seguinte:
```
aws rds describe-db-cluster-parameters --db-cluster-parameter-group-name mydbclusterparametergroup
```
```
{
"Parameters": [
{
"ParameterName": "activate_all_roles_on_login",
"ParameterValue": "0",
"Description": "Automatically set all granted roles as active after the user has authenticated successfully.",
"Source": "engine-default",
"ApplyType": "dynamic",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": true,
"ApplyMethod": "pending-reboot",
"SupportedEngineModes": [
"provisioned"
]
},
{
"ParameterName": "allow-suspicious-udfs",
"Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
"Source": "engine-default",
"ApplyType": "static",
"DataType": "boolean",
"AllowedValues": "0,1",
"IsModifiable": false,
"ApplyMethod": "pending-reboot",
"SupportedEngineModes": [
"provisioned"
]
},
...
```
## API do RDS
Para visualizar os valores de parâmetros para um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBParameters.html) da API do RDS com o seguinte parâmetro necessário.
+ `DBClusterParameterGroupName`
Em alguns casos, os valores permitidos para um parâmetro não são mostrados. São sempre parâmetros em que a origem é o padrão do mecanismo de banco de dados.
Para visualizar os valores desses parâmetros, você pode executar as seguintes instruções SQL:
+ MySQL:
```
-- Show the value of a particular parameter
mysql$ SHOW VARIABLES LIKE '%parameter_name%';
-- Show the values of all parameters
mysql$ SHOW VARIABLES;
```
+ PostgreSQL:
```
-- Show the value of a particular parameter
postgresql=> SHOW parameter_name;
-- Show the values of all parameters
postgresql=> SHOW ALL;
```
# Excluir um grupo de parâmetros de cluster de banco de dados
É possível excluir um grupo de parâmetros de cluster de banco de dados usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. Um grupo de parâmetros do cluster de banco de dados será elegível para exclusão somente se não estiver associado a um cluster de banco de dados.
## Console
**Para excluir um grupo de parâmetros**
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. No painel de navegação, escolha **Parameter groups** (Grupos de parâmetros).
Os grupos de parâmetros aparecem em uma lista.
1. Escolha o nome dos grupos de parâmetros do cluster de banco de dados a serem excluídos.
1. Escolha **Ações** e então **Excluir**.
1. Revise os nomes dos grupos de parâmetros e escolha **Excluir**.
## AWS CLI
Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-db-cluster-parameter-group.html) da AWS CLI com os parâmetros obrigatórios a seguir.
+ `--db-parameter-group-name`
**Example**
O exemplo a seguir exclui um grupo de parâmetros do cluster de banco de dados chamado *mydbparametergroup*.
```
aws rds delete-db-cluster-parameter-group --db-parameter-group-name mydbparametergroup
```
## API do RDS
Para excluir um grupo de parâmetros de cluster de banco de dados, use o comando [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DeleteDBClusterParameterGroup.html) da API do RDS com os parâmetros obrigatórios a seguir.
+ `DBParameterGroupName`
# Comparação de grupos de parâmetros de banco de dados
É possível usar o Console de gerenciamento da AWS para visualizar as diferenças entre dois grupos de parâmetros de banco de dados.
Os grupos de parâmetros especificados devem ser grupos de parâmetros de banco de dados ou devem ser grupos de parâmetros de cluster de banco de dados. Isso se aplica mesmo se o mecanismo de banco de dados e a versão forem os mesmos. Por exemplo, não é possível comparar um grupo de parâmetros do banco de dados do `aurora-mysql8.0` (Aurora MySQL versão 3) e um grupo de parâmetros do cluster de banco de dados do `aurora-mysql8.0`.
Você pode comparar grupos de parâmetros de banco de dados do Aurora MySQL e do RDS para MySQL, mesmo para versões diferentes, mas não pode comparar grupos de parâmetros de banco de dados do Aurora PostgreSQL e do RDS para PostgreSQL.
**Para comparar dois grupos de parâmetros de banco de dados**
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. No painel de navegação, selecione **Parameter groups**.
1. Na lista, escolha os dois grupos de parâmetros que você deseja comparar.
**nota**
Para comparar um grupo de parâmetros padrão com um grupo de parâmetros personalizado, primeiro escolha o grupo de parâmetros padrão na guia **Padrão** e, depois, selecione o grupo de parâmetros personalizado na guia **Personalizado**.
1. Em **Ações**, selecione **Comparar**.
# Especificação de parâmetros de banco de dados
Os tipos de parâmetros de banco de dados incluem os seguintes:
+ Inteiro
+ Booliano
+ String
+ Longo
+ Double
+ Timestamp
+ Objeto de outros tipos de dados definidos
+ Matriz de valores do tipo integer, boolean, string, long, double, timestamp ou object
Você também pode especificar parâmetros inteiros e booleanos usando expressões, fórmulas e funções.
Para o mecanismo do Oracle, você pode usar a variável de fórmula `DBInstanceClassHugePagesDefault` para especificar um parâmetro de banco de dados booleano. Consulte [Variáveis de fórmulas de parâmetros de banco de dados](#USER_FormulaVariables).
Para o mecanismo do PostgreSQL, você pode usar uma expressão para especificar um parâmetro de banco de dados booleano. Consulte [Expressões de parâmetro de banco de dados booleanas](#USER_ParamBooleanExpressions).
**Contents**
+ [Fórmulas de parâmetros de banco de dados](#USER_ParamFormulas)
+ [Variáveis de fórmulas de parâmetros de banco de dados](#USER_FormulaVariables)
+ [Operadores de fórmulas de parâmetros de banco de dados](#USER_FormulaOperators)
+ [Funções de parâmetros de banco de dados](#USER_ParamFunctions)
+ [Expressões de parâmetro de banco de dados booleanas](#USER_ParamBooleanExpressions)
+ [Expressões de log de parâmetros de banco de dados](#USER_ParamLogExpressions)
+ [Exemplos de valores de parâmetros de banco de dados](#USER_ParamValueExamples)
## Fórmulas de parâmetros de banco de dados
Uma fórmula de parâmetro de banco de dados é uma expressão resolvida como um valor inteiro ou booliano. A expressão é delimitada por chaves: \$1\$1. você pode usar uma fórmula para um valor de parâmetro de banco de dados ou como um argumento para uma função de parâmetro de banco de dados.
**Sintaxe**
```
{FormulaVariable}
{FormulaVariable*Integer}
{FormulaVariable*Integer/Integer}
{FormulaVariable/Integer}
```
### Variáveis de fórmulas de parâmetros de banco de dados
Cada variável de fórmula retorna um inteiro ou um valor booliano. Os nomes das variáveis diferenciam maiúsculas de minúsculas.
*AllocatedStorage*
Retorna um inteiro que representa o tamanho, em bytes, do volume de dados.
*DBInstanceClassHugePagesDefault*
Retorna um valor Booliano. Atualmente, é compatível apenas com os mecanismos do Oracle.
Para obter mais informações, consulte [Ativar o HugePages para uma instância do RDS para Oracle](Oracle.Concepts.HugePages.md).
*DBInstanceClassMemory*
Retorna um número inteiro para o número de bytes de memória disponíveis para o processo do banco de dados. Esse número é calculado internamente começando com a quantidade total de memória para a classe de instância de banco de dados. A partir disso, o cálculo subtrai a memória reservada para o sistema operacional e os processos do RDS que gerenciam a instância. Portanto, o número é sempre um pouco menor do que as figuras de memória mostradas nas tabelas de classe de instância em [Classes de instâncias de banco de dados do ](Concepts.DBInstanceClass.md). O valor exato depende de uma combinação de fatores. São eles classe de instância, mecanismo de banco de dados e se ele se aplica a uma instância do RDS ou a uma instância que faça parte de um cluster do Aurora.
*DBInstanceVCPU*
Retorna um número inteiro representando a quantidade de unidades de processamento centrais virtuais (vCPUs) usadas pelo Amazon RDS para gerenciar a instância.
*EndPointPort*
Retorna um inteiro representando a porta usada ao se conectar à instância de banco de dados.
*Réplica TrueIF*
Retorna `1` se a instância de banco de dados é uma réplica de leitura e `0` se não é. Esse é o valor padrão do `read_only` parâmetro no .
### Operadores de fórmulas de parâmetros de banco de dados
Fórmulas de parâmetros de banco de dados que oferecem suporte a dois operadores: divisão e multiplicação.
*Operador de divisão: /*
Divide o dividendo pelo divisor, retornando um quociente inteiro. Casas decimais no quociente são truncadas, não arredondadas.
Sintaxe
```
dividend / divisor
```
Os argumentos de dividendo e divisor devem ser expressões de inteiros.
*Operador de multiplicação: \$1*
Multiplica as expressões, retornando seu produto. As casas decimais nas expressões são truncadas, e não arredondadas.
Sintaxe
```
expression * expression
```
Ambas as expressões devem ser números inteiros.
## Funções de parâmetros de banco de dados
Você especifica os argumentos das funções de parâmetro de banco de dados como inteiros ou fórmulas. Cada função deve ter pelo menos um argumento. Especifique vários argumentos como uma lista separada por vírgulas. A lista não pode ter membros vazios, como *argument1*,,*argument3*. Nomes de função não diferenciam maiúsculas de minúsculas.
*IF*
Retorna um argumento.
Atualmente, é compatível apenas com mecanismos do Oracle e o único primeiro argumento compatível é `{DBInstanceClassHugePagesDefault}`. Para obter mais informações, consulte [Ativar o HugePages para uma instância do RDS para Oracle](Oracle.Concepts.HugePages.md).
Sintaxe
```
IF(argument1, argument2, argument3)
```
Retorna o segundo argumento se o primeiro argumento é avaliado como verdadeiro. Retorna o terceiro argumento, caso contrário.
*GREATEST*
Retorna o maior valor de uma lista de números inteiros ou fórmulas de parâmetros.
Sintaxe
```
GREATEST(argument1, argument2,...argumentn)
```
Retorna um número inteiro.
*LEAST*
Retorna o menor valor de uma lista de números inteiros ou fórmulas de parâmetros.
Sintaxe
```
LEAST(argument1, argument2,...argumentn)
```
Retorna um número inteiro.
*SUM*
Adiciona os valores dos números inteiros ou fórmulas de parâmetros especificados.
Sintaxe
```
SUM(argument1, argument2,...argumentn)
```
Retorna um número inteiro.
## Expressões de parâmetro de banco de dados booleanas
Uma expressão de parâmetro de banco de dados booleana é resolvida como um valor booleano de 1 ou 0. A expressão é delimitada por aspas.
**nota**
Expressões de parâmetro de banco de dados booleanas são compatíveis apenas com o mecanismo do PostgreSQL.
**Sintaxe**
```
"expression operator expression"
```
Ambas as expressões devem ser resolvidas como inteiros. Uma expressão pode ser a seguinte:
+ Uma constante de inteiro
+ Fórmula de parâmetros de banco de dados
+ Função de parâmetros de banco de dados
+ Variável de parâmetro de banco de dados
As expressões de parâmetro de banco de dados booleanas suportam os seguintes operadores de desigualdade:
*O operador maior que: >*
Sintaxe
```
"expression > expression"
```
*O operador menor que: <*
Sintaxe
```
"expression < expression"
```
* Os operadores maior que ou igual a: >=, =>*
Sintaxe
```
"expression >= expression"
"expression => expression"
```
*Os operadores menor que ou igual a: <=, =<*
Sintaxe
```
"expression <= expression"
"expression =< expression"
```
**Example usando uma expressão de parâmetro de banco de dados booleana**
O seguinte exemplo de expressão de parâmetro de banco de dados booliana compara o resultado de uma fórmula de parâmetro com um valor inteiro. Ele faz isso para modificar o parâmetro de banco de dados booliano `wal_compression` para uma instância de banco de dados do PostgreSQL. A expressão do parâmetro compara o número de vCPUs com o valor 2. Se o número de vCPUs for maior que 2, então o parâmetro de banco de dados `wal_compression` é definido como true (verdadeiro).
```
aws rds modify-db-parameter-group --db-parameter-group-name group-name \
--parameters "ParameterName=wal_compression,ParameterValue=\"{DBInstanceVCPU} > 2\" "
```
## Expressões de log de parâmetros de banco de dados
Você pode definir um valor de parâmetro de banco de dados inteiro como uma expressão de log. A expressão é delimitada por chaves: \$1\$1. Por exemplo:
```
{log(DBInstanceClassMemory/8187281418)*1000}
```
A função `log` representa a base de log 2. Esse exemplo também usa a variável de fórmula `DBInstanceClassMemory`. Consulte [Variáveis de fórmulas de parâmetros de banco de dados](#USER_FormulaVariables).
**nota**
Atualmente, você não pode especificar o parâmetro `innodb_log_file_size` do MySQL com qualquer valor diferente de um inteiro.
## Exemplos de valores de parâmetros de banco de dados
Esses exemplos mostram o uso de fórmulas, funções e expressões para os valores de parâmetros de banco de dados.
**Atenção**
Definir parâmetros indevidamente em um grupo de parâmetros de banco de dados pode ter efeitos adversos não intencionais. Estes podem incluir performance degradada e instabilidade do sistema. Sempre tenha cuidado ao modificar os parâmetros do banco de dados e faça backup dos seus dados antes de modificar seu grupo de parâmetros de banco de dados. Faça testes com alterações de grupos de parâmetros em instâncias de bancos de dados de teste, criadas usando restaurações pontuais, antes de aplicar essas alterações às suas instâncias de banco de dados de produção.
**Example uso da função de parâmetros de banco de dados GREATEST (Maior)**
Você pode especificar a função `GREATEST` em um parâmetro de processos do Oracle. Use-a para definir a quantidade de processos do usuário para o maior entre 80 ou `DBInstanceClassMemory` dividido por 9.868.951.
```
GREATEST({DBInstanceClassMemory/9868951},80)
```
**Example uso da função de parâmetro de banco de dados LEAST (Menor)**
Você pode especificar a função `LEAST` em um valor do parâmetro MySQL `max_binlog_cache_size`. Use-a para definir o tamanho máximo de cache que uma transação pode usar em uma instância MySQL para o menor entre 1 MB ou `DBInstanceClass`/256.
```
LEAST({DBInstanceClassMemory/256},10485760)
```
# Criar um cache do Amazon ElastiCache usando as configurações da instância de banco de dados do Amazon RDS
O ElastiCache é um serviço de armazenamento em cache em memória totalmente gerenciado que fornece latências de leitura e gravação em microssegundos que são compatíveis com casos de uso flexíveis e em tempo real. O ElastiCache pode ajudar você a acelerar a performance de aplicações e bancos de dados. Você pode usar o ElastiCache como armazenamento de dados primário para casos de uso que não exigem durabilidade de dados, como tabelas de classificação de jogos, streaming e análise de dados. O ElastiCache ajuda a remover a complexidade associada à implantação e ao gerenciamento de um ambiente de cache distribuído. Para ter mais informações, consulte [Common ElastiCache Use Cases and How ElastiCache Can Help](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/elasticache-use-cases.html) para Memcached e [Common ElastiCache Use Cases and How ElastiCache Can Help](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/elasticache-use-cases.html) para Redis OSS. É possível usar o console do Amazon RDS para criar o cache do ElastiCache.
Você pode operar o Amazon ElastiCache em dois formatos. Você pode começar com um cache sem servidor ou optar por criar seu próprio cluster de cache. Se você optar por desenvolver seu próprio cluster de cache, saiba que o ElastiCache funciona com os mecanismos do Redis OSS e do Memcached. Se você não tiver certeza de qual mecanismo deseja usar, consulte [Comparing Memcached and Redis OSS](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/SelectEngine.html). Para ter mais informações sobre o Amazon ElastiCache, consulte o [Guia do usuário do Amazon ElastiCache](https://docs.aws.amazon.com/AmazonElastiCache/latest/UserGuide/).
**Topics**
+ [Visão geral da criação do cache do ElastiCache com as configurações da instância de banco de dados do RDS](#creating-elasticache-cluster-with-RDS-settings-overview)
+ [Criar um cache do ElastiCache com as configurações de uma instância de banco de dados do RDS](#creating-elasticache-cluster-with-RDS-settings-new-DB)
## Visão geral da criação do cache do ElastiCache com as configurações da instância de banco de dados do RDS
É possível criar um cache do ElastiCache pelo Amazon RDS usando as mesmas configurações de uma instância de banco de dados do RDS recém-criada ou existente.
Alguns casos de uso para associar um cache do ElastiCache à instância de banco de dados:
+ Você pode economizar custos e melhorar a performance usando o ElastiCache com o RDS em vez de executar somente no RDS.
Por exemplo, você pode economizar até 55% em custos e alcançar performance de leitura até 80 vezes mais rápida usando o ElastiCache com o RDS para MySQL, em comparação com o RDS para MySQL sozinho.
+ É possível usar o cache do ElastiCache como um datastore primário para aplicações que não exigem durabilidade de dados. As aplicações que usam Redis OSS ou o Memcached podem usar o ElastiCache sem praticamente nenhuma modificação.
Ao criar um cache do ElastiCache pelo RDS, esse cache herda as seguintes configurações da instância de banco de dados do RDS associada:
+ Configurações de conectividade do ElastiCache
+ Configurações de segurança do ElastiCache
Também é possível definir as configurações de cache de acordo com seus requisitos.
### Configurar o ElastiCache nas aplicações
As aplicações devem ser configuradas para usar o cache do ElastiCache. Também é possível otimizar e melhorar o desempenho do cache configurando as aplicações para usar estratégias de armazenamento em cache, dependendo dos requisitos.
+ Para acessar o cache do ElastiCache e começar, consulte [Getting started with ElastiCache (Redis OSS)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/GettingStarted.html) e [Getting started with ElastiCache (Memcached)](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/GettingStarted.html).
+ Para ter mais informações sobre estratégias de armazenamento em cache, consulte [Caching strategies and best practices](https://docs.aws.amazon.com/AmazonElastiCache/latest/mem-ug/BestPractices.html) para Memcached e [Caching strategies and best practices](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/BestPractices.html) para Redis OSS.
+ Para ter mais informações sobre alta disponibilidade nos clusters do ElastiCache (Redis OSS), consulte [ High availability using replication groups](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/BestPractices.html).
+ É possível incorrer em custos associados a armazenamento de backup, transferência de dados dentro ou entre regiões ou uso do AWS Outposts. Para obter detalhes de preço, consulte [Preço do Amazon ElastiCache](https://aws.amazon.com/elasticache/pricing/).
## Criar um cache do ElastiCache com as configurações de uma instância de banco de dados do RDS
É possível criar um cache do ElastiCache para instância de banco de dados do RDS com configurações herdadas da instância de banco de dados.
**Criar um cache do ElastiCache com as configurações de uma instância de banco de dados**
1. Para criar uma instância de banco de dados, siga as instruções em [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md).
1. Depois de criar uma instância de banco de dados do RDS, o console exibe a janela **Complementos sugeridos**. Selecione **Criar um cluster do ElastiCache do RDS usando suas configurações de banco de dados**.
Para um banco de dados existente, na página **Bancos de dados**, selecione a instância de banco de dados. No menu suspenso **Ações**, selecione **Criar cluster do ElastiCache** para criar um cache do ElastiCache no RDS que tenha as mesmas configurações da instância de banco de dados do RDS existente.
Na **seção de Configuração do ElastiCache**, o **Identificador de banco de dados de origem** exibe de qual instância de banco de dados o cache do ElastiCache herda as configurações.
1. Escolha se você deseja ou não criar um cluster do Redis OSS ou do Memcached. Para ter mais informações, consulte [Comparing Memcached and Redis OSS](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/SelectEngine.html).
![\[Escolha o tipo de cluster e a opção de implantação.\]](http://docs.aws.amazon.com/pt_br/AmazonRDS/latest/UserGuide/images/EC-RDS-Config.png)
1. Depois disso, escolha entre criar um **Cache sem servidor** ou **Crie seu próprio cache**. Consulte mais informações em [Choosing between deployment options](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/WhatIs.deployment.html).
Se você escolher **Cache sem servidor**:
1. Em **Configurações de cache**, insira valores para **Nome** e **Descrição**.
1. Em **Visualizar configurações padrão**, deixe as configurações padrão para estabelecer a conexão entre o cache e a instância de banco de dados.
1. Também é possível editar as configurações padrão escolhendo **Personalizar as configurações padrão**. Selecione as **Configurações de conectividade do ElastiCache**, as **Configurações de segurança do ElastiCache** e os **Limites de uso máximos**.
1. Se você escolher **Crie seu próprio cache**:
1. Se você selecionou **Cluster do Redis OSS**, escolha se deseja manter o modo de cluster **Habilitado** ou **Desabilitado**. Para ter mais informações, consulte [ Replication: Redis OSS (Cluster Mode Disabled) vs. Redis OSS (Cluster Mode Enabled)](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/Replication.Redis-RedisCluster.html).
1. Insira valores para **Nome**, **Descrição** e **Versão do mecanismo**.
Para **Versão de mecanismo**, o valor padrão recomendado é a versão mais recente do mecanismo. Você também pode escolher uma **Versão do mecanismo** para o cache do ElastiCache mais adequada para as seus requisitos.
1. Escolha o tipo de nó na opção **Tipo de nó**. Para ter mais informações, consulte [Gerenciar nós](https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/CacheNodes.html).
Se você optar por criar um cluster do Redis OSS com o **Modo de cluster** definido como **Habilitado**, insira o número de fragmentos (partições/grupos de nós) na opção **Número de fragmentos**.
Insira o número de réplicas de cada fragmento em **Número de réplicas**.
**nota**
O tipo de nó selecionado, o número de fragmentos e o número de réplicas afetam o desempenho do cache e os custos de recursos. Essas configurações devem corresponder às necessidades de seu banco de dados. Para ter informações de preços, consulte [Definição de preço do Amazon ElastiCache](https://aws.amazon.com/elasticache/pricing/).
1. Selecione as **Configurações de conectividade do ElastiCache** e as **Configurações de segurança do ElastiCache**. É possível manter as configurações padrão ou personalizar essas configurações de acordo com seus requisitos.
1. Verifique as configurações padrão e herdadas do cache do ElastiCache. Algumas configurações não podem ser alteradas após a criação.
**nota**
O RDS pode ajustar a janela de backup do cache do ElastiCache para atender ao requisito mínimo de janela de 60 minutos. A janela de backup de seu banco de dados de origem permanece a mesma.
1. Quando estiver tudo pronto, selecione **Criar cache do ElastiCache**.
O console exibe um banner de confirmação para a criação do cache do ElastiCache. Siga o link no banner para o console do ElastiCache para ver os detalhes do cache. O console do ElastiCache exibe o cache do ElastiCache recém-criado.
# Migração automática de bancos de dados do EC2 para o Amazon RDS usando o AWS Database Migration Service
Você pode usar o console do RDS para migrar um banco de dados do EC2 para o RDS. O RDS usa o AWS Database Migration Service (AWS DMS) para migrar seu banco de dados do EC2 de origem. O AWS DMS permite que você migre bancos de dados relacionais para a Nuvem AWS. Para obter mais informações sobre o AWS Database Migration Service, consulte [O que é AWS Database Migration Service?](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html) no * Guia do Usuário doAWS Database Migration Service*.
Para começar a migração, você deve criar um ou uma instância de banco de dados equivalente do RDS para o qual migrar os dados. Depois de criar o banco de dados de destino, você pode importar seu banco de dados do EC2 para ele. Para bancos de dados de origem menores que 1 TiB, essa ação de migração reduz o tempo e os recursos necessários para migrar seus dados para o RDS.
## Visão geral
O console do RDS permite migrar bancos de dados do EC2 para bancos de dados equivalentes do RDS. Você deve criar um banco de dados do RDS para habilitar a migração pelo console.
Você pode migrar bancos de dados do EC2 para os seguintes mecanismos de banco de dados:
+ MySQL
+ MariaDB
+ PostgreSQL
O processo de migração inclui as seguintes etapas:
+ Crie um banco de dados equivalente no RDS. Para que os bancos de dados sejam equivalentes, eles devem ter o mesmo mecanismo de banco de dados e versões de mecanismo compatíveis. Eles também devem estar na mesma VPC. Para obter instruções sobre como criar um banco de dados, consulte [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md).
+ Escolha o tipo de replicação para seu banco de dados:
+ **Migração de carga máxima**: o RDS copia o banco de dados de origem completo para o banco de dados de destino, criando novas tabelas no destino quando necessário.
**nota**
Essa opção causa uma interrupção no banco de dados do RDS.
+ **Migração de carga máxima e captura de dados de alteração (CDC)**: semelhante à migração de carga máxima, com essa opção, o RDS copia todo o banco de dados de origem para o banco de dados de destino. No entanto, após a migração de carga máxima, o RDS aplica todas as alterações capturadas na origem ao banco de dados de destino. A captura de dados de alteração coleta alterações nos logs de banco de dados utilizando a API nativa do mecanismo do banco de dados.
**nota**
Essa opção causa uma interrupção no banco de dados do RDS.
+ **Captura de dados de alteração (CDC)**: use essa opção para manter seu banco de dados de destino disponível durante a migração. O RDS migra as alterações em andamento no banco de dados de origem para o banco de dados de destino.
+ O RDS cria os recursos de rede necessários para facilitar a migração. Depois que o RDS cria os recursos necessários, ele notifica você sobre os recursos criados e permite que inicie a transferência de dados.
O tempo necessário para concluir a migração depende do tipo de replicação e do tamanho do banco de dados de origem.
## Pré-requisitos
### MySQL e MariaDB
Antes de começar a trabalhar com um banco de dados MySQL ou MariaDB como origem, confirme se você tem os pré-requisitos a seguir. Esses pré-requisitos se aplicam às gerenciadas pela AWS.
Você deve ter uma conta do AWS DMS com o perfil Replication Admin. O perfil precisa dos seguintes privilégios:
+ **REPLICATION CLIENT**: este privilégio é necessário apenas para tarefas de CDC. Em outras palavras, as tarefas somente com carga completa não requerem este privilégio.
+ **REPLICATION SLAVE**: este privilégio é necessário apenas para tarefas de CDC. Em outras palavras, as tarefas somente com carga completa não requerem este privilégio.
O usuário do AWS DMS deve ter privilégios SELECT para as tabelas de origem designadas para replicação.
Conceda os seguintes privilégios se você usar avaliações de pré-migração específicas do MySQL.
```
grant select on mysql.user to ;
grant select on mysql.db to ;
grant select on mysql.tables_priv to ;
grant select on mysql.role_edges to #only for MySQL version 8.0.11 and higher
```
### PostgreSQL
Antes de migrar dados de um banco de dados de origem PostgreSQL gerenciado pela AWS, faça o seguinte:
+ É recomendável utilizar uma conta de usuário da AWS com as permissões mínimas necessárias para a instância de banco de dados PostgreSQL como a conta de usuário do endpoint de origem do PostgreSQL do AWS DMS. A utilização de uma conta mestre não é recomendada. A conta deve ter o perfil `rds_superuser` e o perfil `rds_replication`. O perfil `rds_replication` concede permissões para gerenciar slots lógicos e transmitir dados utilizando slots lógicos.
**nota**
Algumas transações do AWS DMS ficam ociosas por algum tempo antes que o mecanismo do DMS as utilize novamente. Com a utilização do parâmetro `idle_in_transaction_session_timeout` no PostgreSQL versões 9.6 e superior é possível fazer com que as transações ociosas atinjam o tempo limite e falhem.
## Limitações
As seguintes limitações se aplicam ao processo de migração automática:
+ O status do banco de dados de destino deve ser **Disponível** para iniciar a migração do banco de dados de origem.
+ Ao migrar de um banco de dados de origem MySQL, sua conta do RDS deve ter a função de Administrador de Replicação. Você também deve ter os privilégios adequados aplicados para essa função.
+ A instância do EC2 e o banco de dados de destino devem estar na mesma VPC.
+ Você não pode migrar o banco de dados do EC2 para os seguintes bancos de dados de destino ao usar a ação **Migrar dados do banco de dados do EC2**:
+ Banco de dados que é membro de um cluster
+ Bancos de dados Oracle, SQL Server e Db2
+ Bancos de dados com versão do MySQL anterior a 5.7
+ Bancos de dados com versão do PostgreSQL anterior a 10.4
+ Bancos de dados com versão do MariaDB anterior a 10.2
# Criação de recursos do IAM para migrações homogêneas
O RDS usa AWS DMS para migrar seus dados. Para acessar os bancos de dados e migrar os dados, o AWS DMS cria um ambiente com tecnologia sem servidor para migrações de dados homogêneas. Nesse ambiente, o AWS DMS exige acesso ao emparelhamento de VPC, a tabelas de rotas, a grupos de segurança e a outros recursos da AWS. Além disso, o AWS DMS armazena os logs, as métricas e o progresso de cada migração de dados no Amazon CloudWatch. Para criar um projeto de migração de dados, o AWS DMS precisa acessar esses serviços.
Além disso, o AWS DMS requer acesso aos segredos que representam um conjunto de credenciais de usuário para autenticar a conexão de banco de dados para as conexões de origem e de destino.
**nota**
Ao usar a ação **Migrar dados da instância do EC2**, você pode usar o console do RDS para gerar esses recursos do IAM. Ignore esta etapa se você estiver usando os recursos do IAM gerados pelo console.
Para esse processo, é necessário ter estes recursos do IAM:
**Topics**
+ [Criação de uma política do IAM para migrações de dados homogêneas](#USER_DMS_migration-IAM.iam-policy)
+ [Criação de um perfil do IAM para migrações de dados homogêneas](#USER_DMS_migration-IAM.iam-role)
+ [Criação de uma política de acesso secreto e um perfil](USER_DMS_migration-IAM.secret-iam-role-policy.md)
+ [Criação de um perfil do IAM para AWS DMS para gerenciar a Amazon VPC](USER_DMS_migration-IAM.dms-vpc-role.md)
## Criação de uma política do IAM para migrações de dados homogêneas
Nesta etapa, você cria uma política do IAM que fornece acesso aos recursos do Amazon EC2 e do CloudWatch ao AWS DMS. Crie um perfil do IAM e anexe uma política.
**Como criar uma política do IAM para migrações de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do IAM, em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação, selecione **Políticas**.
1. Selecione **Criar política**.
1. Na página **Criar política**, escolha a guia **JSON**.
1. Cole a política o JSON a seguir no editor.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"ec2:DescribeRouteTables",
"ec2:DescribeSecurityGroups",
"ec2:DescribeVpcPeeringConnections",
"ec2:DescribeVpcs",
"ec2:DescribePrefixLists",
"logs:DescribeLogGroups"
],
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"servicequotas:GetServiceQuota"
],
"Resource": "arn:aws:servicequotas:*:*:vpc/L-0EA8095F"
},
{
"Effect": "Allow",
"Action": [
"logs:CreateLogGroup",
"logs:DescribeLogStreams"
],
"Resource": "arn:aws:logs:*:*:log-group:dms-data-migration-*"
},
{
"Effect": "Allow",
"Action": [
"logs:CreateLogStream",
"logs:PutLogEvents"
],
"Resource": "arn:aws:logs:*:*:log-group:dms-data-migration-*:log-stream:dms-data-migration-*"
},
{
"Effect": "Allow",
"Action": "cloudwatch:PutMetricData",
"Resource": "*"
},
{
"Effect": "Allow",
"Action": [
"ec2:CreateRoute",
"ec2:DeleteRoute"
],
"Resource": "arn:aws:ec2:*:*:route-table/*"
},
{
"Effect": "Allow",
"Action": [
"ec2:CreateTags"
],
"Resource": [
"arn:aws:ec2:*:*:security-group/*",
"arn:aws:ec2:*:*:security-group-rule/*",
"arn:aws:ec2:*:*:route-table/*",
"arn:aws:ec2:*:*:vpc-peering-connection/*",
"arn:aws:ec2:*:*:vpc/*"
]
},
{
"Effect": "Allow",
"Action": [
"ec2:AuthorizeSecurityGroupEgress",
"ec2:AuthorizeSecurityGroupIngress"
],
"Resource": "arn:aws:ec2:*:*:security-group-rule/*"
},
{
"Effect": "Allow",
"Action": [
"ec2:AuthorizeSecurityGroupEgress",
"ec2:AuthorizeSecurityGroupIngress",
"ec2:RevokeSecurityGroupEgress",
"ec2:RevokeSecurityGroupIngress"
],
"Resource": "arn:aws:ec2:*:*:security-group/*"
},
{
"Effect": "Allow",
"Action": [
"ec2:AcceptVpcPeeringConnection",
"ec2:ModifyVpcPeeringConnectionOptions"
],
"Resource": "arn:aws:ec2:*:*:vpc-peering-connection/*"
},
{
"Effect": "Allow",
"Action": "ec2:AcceptVpcPeeringConnection",
"Resource": "arn:aws:ec2:*:*:vpc/*"
}
]
}
```
------
1. Selecione **Avançar: tags** e **Avançar: revisar**.
1. Insira **HomogeneousDataMigrationsPolicy** para **Nome\$1** e escolha **Criar política**.
## Criação de um perfil do IAM para migrações de dados homogêneas
Nesta etapa, você cria um perfil do IAM que fornece acesso ao AWS Secrets Manager, ao Amazon EC2 e ao CloudWatch.
**Como criar um perfil do IAM para migrações de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do IAM, em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação, selecione **Perfis**.
1. Escolha **Criar Perfil**.
1. Na página **Selecionar entidade confiável**, em **Tipo de entidade confiável**, escolha **Serviço da AWS**. Em **Casos de uso para outros serviços da AWS**, escolha **DMS**.
1. Marque a caixa de seleção **DMS** e escolha **Próximo**.
1. Na página **Adicionar permissões**, escolha **HomogeneousDataMigrationsPolicy** criada anteriormente. Escolha **Próximo**.
1. Na página **Nomear, revisar e criar**, insira **HomogeneousDataMigrationsRole** em **Nome do perfil** e escolha **Criar função**.
1. Na página **Perfis**, insira **HomogeneousDataMigrationsRole** em **Nome do perfil**. Escolha **HomogeneousDataMigrationsRole**.
1. Na página **HomogeneousDataMigrationsRole**, escolha a guia **Relações de confiança**. Selecione **Edit trust policy** (Editar política de confiança).
1. Na página **Editar política de confiança**, cole o seguinte JSON no editor, substituindo o texto existente.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "",
"Effect": "Allow",
"Principal": {
"Service": [
"dms-data-migrations.amazonaws.com",
"dms.your_region.amazonaws.com"
]
},
"Action": "sts:AssumeRole"
}
]
}
```
------
No exemplo anterior, substitua *your\$1region* pelo nome da sua Região da AWS.
A política anterior baseada em recursos fornece às entidades principais do AWS DMS as permissões para executar tarefas de acordo com a política **HomogeneousDataMigrationsPolicy** gerenciada pelo cliente.
1. Escolha **Atualizar política**.
# Criação de uma política de acesso secreto e um perfil
Siga os procedimentos abaixo para criar sua política de acesso secreto e seu perfil que permitem que o DMS acesse as credenciais do usuário para os bancos de dados de origem e destino.
**Como criar a política de acesso secreto e o perfil, que permite que o Amazon RDS acesse o AWS Secrets Manager para acessar o segredo apropriado**
1. Faça login no Console de gerenciamento da AWS e abra o console do AWS Identity and Access Management (IAM) em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Escolha **Políticas** e **Criar política**.
1. Escolha **JSON** e insira a política a seguir para ativar o acesso e a descriptografia do segredo.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "secretsmanager:GetSecretValue",
"Resource": "arn:aws:secretsmanager:us-east-1:111122223333:secret:SecretName-ABCDEF"
},
{
"Effect": "Allow",
"Action": [
"kms:Decrypt",
"kms:DescribeKey"
],
"Resource": "arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab"
}
]
}
```
------
Aqui, `secret_arn` é o ARN do segredo, que é possível obter de `SecretsManagerSecretId` conforme apropriado, e `kms_key_arn` é o ARN da chave do AWS KMS que você está utilizando para criptografar o segredo, como no exemplo a seguir.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "secretsmanager:GetSecretValue",
"Resource": "arn:aws:secretsmanager:us-east-2:123456789012:secret:MySQLTestSecret-qeHamH"
},
{
"Effect": "Allow",
"Action": [
"kms:Decrypt",
"kms:DescribeKey"
],
"Resource": "arn:aws:kms:us-east-2:123456789012:key/761138dc-0542-4e58-947f-4a3a8458d0fd"
}
]
}
```
------
**nota**
Se você utilizar a chave de criptografia padrão criada pelo AWS Secrets Manager, não precisará especificar as permissões do AWS KMS para `kms_key_arn`.
Se quiser que a política forneça acesso aos dois segredos, basta especificar um objeto de recurso JSON adicional para o outro *secret\$1arn*.
1. Revise e crie a política com um nome amigável e uma descrição opcional.
1. Escolha **Funções** e **Criar função**.
1. Escolha **Serviço da AWS** como o tipo de entidade confiável.
1. Escolha **DMS** na lista de serviços como o serviço confiável e escolha **Próximo: Permissões**.
1. Pesquise e anexe a política que criada na etapa 4 e continue para adicionar quaisquer tags e revisar o perfil. Nesse ponto, edite as relações de confiança do perfil para utilizar a entidade principal do serviço Amazon RDS regional como a entidade confiável. Essa entidade principal tem o seguinte formato.
```
dms.region-name.amazonaws.com
```
Aqui, *`region-name`* é nome da sua região, como `us-east-1`. Desse modo, segue uma entidade principal do serviço Amazon RDS regional para essa região.
```
dms.us-east-1.amazonaws.com
dms-data-migrations.amazonaws.com
```
# Criação de um perfil do IAM para AWS DMS para gerenciar a Amazon VPC
Você deve criar um perfil do IAM para AWS DMS para gerenciar as configurações de VPC para seus recursos. Esse perfil deve estar disponível para uma migração bem-sucedida.
**Criação de `dms-vpc-role` para migração de banco de dados**
1. Faça login no Console de gerenciamento da AWS e abra o console do IAM, em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. No painel de navegação do console, escolha **Roles** (Perfis) e, em seguida, clique em **Create role** (Criar perfil).
1. Selecione a opção **AWS service (Serviço da AWS)** para **Selecionar entidade confiável**.
Em **Caso de uso**, selecione **DMS**.
1. Na etapa **Adicionar permissões**, selecione `AmazonDMSVPCManagementRole` e escolha **Próximo**.
1. Na página **Nomear, revisar e criar**, defina o **Nome do perfil** como `dms-vpc-role` e escolha **Criar perfil**.
Isso cria o perfil para o DMS para gerenciar as configurações de VPC para a migração.
# Configurar a migração de dados para o banco de dados do EC2
Para começar a migrar dados do banco de dados de origem do EC2, é necessário criar um banco de dados do RDS equivalente. Para obter instruções sobre como criar um banco de dados, consulte [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md).
Depois de criar o banco de dados de destino, use as etapas a seguir para configurar a migração de dados:
**Configurar o projeto de migração de dados**
1. Selecione o banco de dados de destino na página **Bancos de dados** no console do RDS.
1. Escolha o menu suspenso **Ações** e selecione a opção **Migrar dados do banco de dados do EC2**. Para ver os bancos de dados de destino compatíveis, consulte [Limitações](USER_DMS_migration.md#USER_DMS_migration-Limitations).
1. Na seção **Selecionar banco de dados de origem do EC2**:
1. Verifique o **Tipo de mecanismo** e certifique-se de que seja o mesmo do banco de dados de origem.
Além disso, verifique se as versões do mecanismo são compatíveis.
1. Em **Instância do EC2**, escolha a instância do EC2 onde o banco de dados de origem reside.
1. Em **Porta**, insira a porta na qual o banco de dados de origem permite tráfego.
1. Em **Segredo**, escolha **Criar e usar um novo segredo** se você não tiver um segredo existente. Insira o **Nome de usuário** e a **Senha** do banco de dados de origem. Escolha também a chave do KMS com a qual criptografar seu segredo.
Para você já tiver um segredo, selecione **Usar um segredo existente** e escolha um segredo no menu suspenso.
1. Em **Perfil do IAM para segredo**, se você tiver um perfil do IAM existente, selecione **Usar um perfil do IAM existente** e escolha um perfil do IAM no menu suspenso que possa acessar o ID do segredo da etapa anterior.
Se você não tem um perfil do IAM, escolha **Criar e usar novo perfil do IAM**. Insira o novo nome para o perfil no campo **Nome do perfil do IAM. Você pode ver as permissões associadas a essa função no link abaixo.**
1. Na seção **Visualizar banco de dados de destino do RDS**:
1. Confirme as configurações do banco de dados de destino na parte superior da seção.
1. Em **Segredo**, escolha **Criar e usar um novo segredo** se você não tiver um segredo existente que contenha as credenciais do banco de dados de destino.
Para você já tiver um segredo, selecione o segredo no menu suspenso.
1. Em **Perfil do IAM para segredo**, selecione um perfil do IAM que possa acessar o segredo da etapa anterior. Você também pode criar um perfil do IAM se já não tiver um.
Se o menu suspenso não preencher os perfis do IAM, especifique o **ARN do perfil do IAM** no formato `arn:aws:iam:account_id:role/roleName`.
1. Na seção **Configurar migração de dados**:
1. Selecione o tipo de migração de dados escolhendo entre **Carga máxima**, **Captura de dados de alteração e carga máxima (CDC)** ou **Captura de dados de alteração (CDC)**. Para obter mais informações sobre essas opções, consulte [Visão geral](USER_DMS_migration.md#USER_DMS_migration-overview).
Não é possível modificar o tipo de migração após o início da migração.
1. Em **Perfil do IAM para migração de dados**, se você já tiver um perfil do IAM, selecione **Usar um perfil do IAM existente** e escolha um perfil do IAM no menu suspenso que conceda ao DMS as permissões para criar os recursos necessários para a migração. Se você não tem um perfil do IAM, escolha **Criar e usar novo perfil do IAM**.
1. Confirme se a guia **Exibir configurações de migração** mostra as configurações necessárias para que a migração de dados seja configurada com sucesso.
1. Selecione **Migrar** para concluir a configuração da migração.
Depois de concluir essas etapas, você pode ver os recursos que estão sendo configurados para a migração de dados escolhendo **Visualizar detalhes** no banner de progresso no console. Depois que os recursos necessários estiverem configurados, a migração será iniciada automaticamente. Se você criar
Para migrar vários bancos de dados para o banco de dados de destino, inicie esse processo novamente com detalhes sobre o novo banco de dados do EC2.
# Gerenciar migrações de dados
Depois de usar a ação **Migrar dados do banco de dados do EC2** do console do RDS, o RDS inicia a migração automaticamente.
Se você tiver usado o console do AWS DMS para criar os recursos de migração, poderá iniciar o processo de migração.
## Início da migração de dados
Siga estas etapas para iniciar a migração de dados:
**Início de uma migração de dados**
1. Escolha o banco de dados de destino na página **Bancos de dados** no console do RDS.
1. Na página de detalhes do banco de dados, escolha a guia **Migrações de dados**.
1. Na guia **Migrações de dados**, a opção **Migrações de dados associadas** lista as migrações de dados disponíveis.
As migrações configuradas usando o console do RDS são iniciadas automaticamente quando os recursos necessários são configurados.
As migrações configuradas usando o console do DMS são definidas como **Prontas**.
Para começar essas migrações, selecione o menu suspenso **Ações** e selecione **Iniciar**.
1. Isso inicia a migração de dados para seu banco de dados do EC2.
## Interrupção da migração de dados
Para migrações de dados cujo tipo de replicação é de carga completa, interromper a migração faz com que o processo pare e não possa ser retomado. Depois de interrompida, a migração deve ser reiniciada.
Para migrações com o tipo de replicação definido para captura de dados de alteração (CDC) ou carga total e CDC, você pode interromper o processo de replicação contínua e retomar o processo posteriormente.
**Interrupção de uma migração de dados**
1. Escolha o banco de dados de destino na página **Bancos de dados** no console do RDS.
1. Na página de detalhes do banco de dados, escolha a guia **Migrações de dados**.
1. Na guia **Migrações de dados**, a opção **Migrações de dados associadas** lista as migrações de dados em andamento.
Para interromper uma migração, selecione uma migração de dados e selecione **Parar** no menu suspenso **Ações**.
1. Isso para a migração de dados para seu banco de dados do EC2.
## Retomada da migração de dados
Para migrações de dados cujo tipo de replicação é carga total e captura de dados de alteração (CDC) ou migração de captura de dados de alteração (CDC), você pode retomar o processo CDC a partir do último ponto de interrupção.
**Retomada de uma migração de dados**
1. Escolha o banco de dados de destino na página **Bancos de dados** no console do RDS.
1. Na página de detalhes do banco de dados, escolha a guia **Migrações de dados**.
1. Na guia **Migrações de dados**, a opção **Migrações de dados associadas** lista as migrações de dados interrompidas.
Para retomar uma migração, selecione uma migração de dados e selecione **Retomar processamento** no menu suspenso **Ações**.
1. Isso retoma a migração de dados para seu banco de dados do EC2.
## Exclusão da migração de dados
Para excluir uma migração de dados associada, use as instruções a seguir
**Exclusão de uma migração de dados**
1. Escolha o banco de dados de destino na página **Bancos de dados** no console do RDS.
1. Na página de detalhes do banco de dados, escolha a guia **Migrações de dados**.
1. Para excluir uma migração, selecione uma migração de dados e selecione **Excluir** no menu suspenso **Ações**.
1. Isso exclui a migração de dados.
A exclusão de uma migração de dados que estava em andamento não afeta nenhum dado que já tenha sido carregado no banco de dados de destino.
## Reinicialização da migração de dados
Para reiniciar uma migração de dados associada a partir de um ponto inicial do CDC, use as instruções a seguir
**Reinicialização de uma migração de dados**
1. Escolha o banco de dados de destino na página **Bancos de dados** no console do RDS.
1. Na página de detalhes do banco de dados, escolha a guia **Migrações de dados**.
1. Para reiniciar uma migração, selecione uma migração de dados e escolha **Reiniciar** no menu suspenso **Ações**.
1. Isso reinicia a migração de dados a partir de um ponto inicial do CDC.
A reinicialização de uma migração de dados que estava em andamento não afeta nenhum dado que já tenha sido carregado no banco de dados de destino.
# Monitoramento das migrações de dados
Depois de iniciar migrações de dados, é possível monitorar seu status e progresso. As migrações de dados de grandes conjuntos de dados demoram horas para serem concluídas. Para manter a confiabilidade, a disponibilidade e o alto desempenho da migração de dados, monitore o progresso regularmente.
**Como verificar o status e o progresso da migração de dados**
1. Escolha o banco de dados de destino na página **Bancos de dados** no console do RDS.
1. Na página de detalhes do banco de dados, escolha a guia **Migrações de dados**.
1. A seção **Migrações de dados associadas** lista suas migrações de dados. Verifique a coluna **Status**.
1. Para migrações de dados em execução, a coluna **Processo da migração** exibe a porcentagem de dados migrados.
1. Para monitorar o processo no CloudWatch, use o link na coluna **CloudWatch**.
## Status das migrações
Para cada migração de dados executada, o console do RDS exibe o **Status**. A lista a seguir inclui os status:
+ `Ready`: a migração de dados está pronta para ser iniciada.
+ `Starting`: o RDS está criando o ambiente com tecnologia sem servidor para a migração de dados.
+ `Load running`: o RDS está executando a migração de carga máxima.
+ `Load complete, replication ongoing`: o RDS concluiu a carga máxima e agora replica as alterações em andamento. Esse status só se aplica a migrações de carga máxima e do tipo CDC.
+ `Replication ongoing`: o RDS está replicando as alterações em andamento. Esse status só se aplica a migrações do tipo CDC.
+ `Stopping`: o RDS está interrompendo as migrações de dados. Esse status se aplica quando você opta por interromper a migração de dados no menu **Ações**.
+ `Stopped`: o RDS interrompeu as migrações de dados.
+ `Failed`: falha na migração de dados. Para obter mais informações, consulte os arquivos de log.
+ `Restarting`: a migração de dados reiniciou uma replicação de dados em andamento a partir de um ponto inicial do CDC.
# Tutorial: criar uma instância de banco de dados do MySQL com um grupo de parâmetros personalizadoe um novo grupo de opções
Neste tutorial, é necessário criar uma instância de banco de dados do MySQL com um grupo de parâmetros personalizado e um novo grupo de opções. Para ter mais informações sobre grupos de parâmetros personalizados e grupos de opções, consulte [Grupos de parâmetros para Amazon RDS](USER_WorkingWithParamGroups.md) e [Trabalhar com grupos de opções](USER_WorkingWithOptionGroups.md).
**Importante**
Não há cobrança para criar uma conta da AWS. No entanto, ao concluir este tutorial, é possível gerar custos para os recursos da AWS que você usa. Se esses recursos não forem mais necessários após a conclusão do tutorial, você poderá excluí-los.
Para criar uma instância de banco de dados com configurações e definições personalizadas, é possível usar grupos de parâmetros personalizados e novos grupos de opções. Os grupos de parâmetros personalizados e os novos grupos de opções são particularmente úteis se você trabalha com vários bancos de dados e quer definir as configurações de modo uniforme para eles.
Ao concluir essas etapas, você aprende a:
+ Usar o Amazon RDS para criar uma instância de banco de dados do MySQL com um grupo de parâmetros personalizado e um novo grupo de opções.
+ Como usar parâmetros específicos e opções específicas para instâncias de banco de dados do MySQL.
Para concluir este tutorial, realize as seguintes tarefas:
1. Crie um grupo de parâmetros personalizado com os parâmetros `default_password_lifetime` e `disconnect_on_expired_password` do MySQL.
1. Crie um grupo de opções com o recurso opcional `MariaDB Audit Plugin` do MySQL. Para conhecer as etapas para criar um grupo de opções, consulte [Trabalhar com grupos de opções](USER_WorkingWithOptionGroups.md).
1. Crie uma instância de banco de dados do MySQL com o grupo de parâmetros personalizado e o grupo de opções que você criou.
**Topics**
+ [Pré-requisitos](#tutorial-creating-custom-OPG.Prerequisites)
+ [Criar um grupo de parâmetros do Amazon RDS](#tutorial-creating-custom-OPG.create-parameter-group)
+ [Modificar os valores dos parâmetros em seu grupo de parâmetros personalizado](#tutorial-creating-custom-OPG.add-parameters)
+ [Criar um grupo de opções do Amazon RDS](#tutorial-creating-custom-OPG.create-option-group)
+ [Adicionar uma opção ao seu novo grupo de opções](#tutorial-creating-custom-OPG.add-options)
+ [Criar uma instância de banco de dados do MySQL com um grupo de parâmetrospersonalizadoe um novo grupo de opções](#tutorial-creating-custom-OPG.create-OPG)
## Pré-requisitos
Este tutorial exige que você tenha uma Conta da AWS e um usuário com acesso administrativo. Se ainda não os configurou, conclua as etapas apresentadas nas seguintes seções:
+ [Inscrever-se para uma Conta da AWS](CHAP_SettingUp.md#sign-up-for-aws)
+ [Criar um usuário com acesso administrativo](CHAP_SettingUp.md#create-an-admin)
## Criar um grupo de parâmetros do Amazon RDS
Neste tutorial, você aprende a criar um grupo de parâmetros personalizado com [default\$1password\$1lifetime](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_default_password_lifetime) e [disconnect\$1on\$1expired\$1password](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_disconnect_on_expired_password) para uma instância de banco de dados do MySQL no console. O parâmetro `default_password_lifetime` controla o número de dias antes da expiração automática da senha do cliente. O parâmetro `disconnect_on_expired_password` controla se a instância de banco de dados do MySQL desconecta o cliente quando a senha expira. Para ter mais informações sobre outros parâmetros disponíveis para instâncias de banco de dados do MySQL, consulte [Parâmetros do MySQL](Appendix.MySQL.Parameters.md).
**Para criar um parameter group**
1. Abra o console do Amazon RDS e selecione **Grupos de parâmetros**.
1. Em **Grupos de parâmetros personalizados**, selecione **Criar grupo de parâmetros**.
1. Defina os detalhes do grupo de parâmetros.
1. Insira um nome para o grupo de parâmetros.
1. Insira uma descrição do grupo de parâmetros.
1. Em **Tipo de mecanismo**, escolha **MySQL Community**.
1. Em **Família de grupos de parâmetros**, selecione **MySQL 8.0**.
1. Escolha **Criar**.
O novo grupo de parâmetros aparece na página **Grupos de parâmetros** no console do Amazon RDS. As etapas a seguir mostram como modificar valores de parâmetro para personalizar um grupo de parâmetros.
## Modificar os valores dos parâmetros em seu grupo de parâmetros personalizado
Use as etapas a seguir para modificar os valores dos parâmetros no grupo de parâmetros que você criou em [Criar um grupo de parâmetros do Amazon RDS](#tutorial-creating-custom-OPG.create-parameter-group).
**Como modificar os valores dos parâmetros em seu grupo de parâmetros**
1. Abra o console do Amazon RDS e selecione **Grupos de parâmetros**.
1. Em **Grupos de parâmetros personalizados**, escolha o nome do grupo de parâmetros que você criou.
1. Escolha **Editar**.
1. Na caixa de pesquisa **Filtrar parâmetros**, pesquise o parâmetro personalizado `default_password_lifetime`.
1. Marque a caixa de seleção ao lado do parâmetro e insira um valor para o número de dias a ser definido para esse parâmetro de ciclo de vida da senha.
1. Escolha **Salvar alterações**.
1. Repita as mesmas etapas para o parâmetro ` disconnect_on_expired_password`. Ao escolher esse parâmetro, será solicitado que você selecione um valor de 0 ou 1 no menu suspenso. Selecione 1 para desconectar quando a senha expirar.
O grupo de parâmetros personalizado agora está disponível para ser associado ao Amazon RDS para instâncias de banco de dados do MySQL 8.0. Em seguida, crie um grupo de opções para sua instância de banco de dados.
## Criar um grupo de opções do Amazon RDS
Crie um grupo de opções com o [MariaDB Audit Plugin](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Appendix.MySQL.Options.AuditPlugin.html) opcional. Esse plug-in registra a atividade do servidor para segurança e conformidade. Para ter mais informações sobre outras opções personalizadas disponíveis para instâncias de banco de dados do MySQL, consulte [Opções para instâncias de bancos de dados MySQL](Appendix.MySQL.Options.md).
**Como criar um grupo de opções**
1. Abra o console do Amazon RDS e selecione **Grupos de opções**.
1. Em **Grupos de opções**, escolha **Criar grupo**.
1. Defina os detalhes do grupo de opções.
+ Insira um nome para o grupo de opções.
+ Insira uma descrição do grupo de opções.
+ Em **Mecanismo**, selecione **mysql**.
+ Em **Versão do mecanismo principal**, selecione **8.0**.
1. Escolha **Criar**.
O novo grupo de opções aparece na página **Grupos de opções** no console do Amazon RDS. As etapas a seguir mostram como adicionar opções ao grupo de opções.
## Adicionar uma opção ao seu novo grupo de opções
Use as etapas a seguir para adicionar uma opção ao grupo de opções que você criou em [Criar um grupo de opções do Amazon RDS](#tutorial-creating-custom-OPG.create-option-group).
**Como adicionar uma opção ao seu grupo de opções**
1. Abra o console do Amazon RDS e selecione **Grupos de opções**.
1. Em **Grupos de opções**, selecione o nome do grupo de opções que você criou.
1. Em **Opções**, escolha **Adicionar opção**.
1. Defina os detalhes do grupo de opções.
+ Em **Nome da opção**, selecione a opção MariaDB Audit Plugin, **MARIADB\$1AUDIT\$1PLUGIN**.
+ Em **Configurações de opção**, mantenha todas as opções padrão selecionadas.
+ Em **Aplicar imediatamente**, escolha **Sim**.
1. Selecione **Criar opção**.
O novo grupo de opões agora deve estar disponível para todas as instâncias de banco de dados associadas. Depois, crie uma instância de banco de dados do MySQL com o grupo de parâmetros personalizado e o novo grupo de opções.
## Criar uma instância de banco de dados do MySQL com um grupo de parâmetrospersonalizadoe um novo grupo de opções
Por fim, crie uma instância de banco de dados do MySQL com o grupo de parâmetros personalizado e o grupo de opções que você criou nas etapas anteriores. As etapas a seguir mostram como criar a instância de banco de dados do MySQL com um grupo de parâmetros personalizado e um novo grupo de opções.
**Como criar uma instância de banco de dados com um grupo de parâmetros personalizado e um novo grupo de opções**
1. Abra o console do Amazon RDS e selecione **Bancos de dados**.
1. Selecione **Criar banco de dados**.
1. Em **Escolher um método de criação de banco de dados**, escolha **Criação padrão**.
1. Em **Opções do mecanismo**, escolha **MySQL**.
1. Em **Disponibilidade e durabilidade**, selecione **Instância de banco de dados única.** Essa etapa é necessária para comportar um grupo de parâmetros personalizado ou um novo grupo de opções.
1. Selecione **Configuração adicional**.
+ Em **Nome do banco de dados inicial**, selecione um nome para a instância de banco de dados.
+ No menu suspenso **Grupo de parâmetros do banco de dados**, selecione o nome do grupo de parâmetros personalizado que você criou anteriormente.
+ No menu suspenso **Grupo de opções**, selecione o nome do novo grupo de opções que você criou anteriormente.
1. Neste tutorial, é possível deixar as configurações padrão para qualquer outra configuração de banco de dados ou modificá-las conforme necessário.
1. Selecione **Criar banco de dados**.
O RDS cria uma instância de banco de dados do MySQL com um grupo de parâmetros personalizado e um novo grupo de opções. Para ver mais informações sobre esse banco de dados, consulte a página **Bancos de dados** do console do Amazon RDS.
Neste tutorial, você vai configurar uma instância de banco de dados do MySQL com configurações personalizadas usando um grupo de parâmetros personalizado e um novo grupo de opções. Essa instância de banco dados recém-criada do MySQL gerencia o ciclo de vida da senha do usuário usando o parâmetro `default_password_lifetime`. Essa instância de banco de dados também desconecta usuários que se conectam com uma senha vencida usando o parâmetro `disconnect_on_expired_password`. A opção `MariaDB Audit Plugin` também é usada para acompanhar a atividade do servidor. Para otimizar o banco de dados, é possível aplicar configurações adicionais no grupo de parâmetros personalizado e adicionar opções.
Assim que criar sua instância de banco de dados personalizada, você deve excluir seus recursos para evitar custos indesejados. Para excluir uma instância de banco de dados, siga as instruções em [Excluir uma instância de banco de dados](USER_DeleteInstance.md).