Modificar um cluster de banco de dados multi-AZ para o Amazon RDS
Um cluster de banco de dados multi-AZ tem uma instância de banco de dados de gravador e duas instâncias de banco de dados de leitor em três zonas de disponibilidade separadas. Clusters de banco de dados multi-AZ oferecem alta disponibilidade, maior capacidade para workloads de leitura e menor latência quando comparados a implantações multi-AZ. Para obter mais informações sobre clusters de banco de dados multi-AZ, consulte Implantações de cluster de banco de dados multi-AZ para o Amazon RDS.
Você pode modificar um cluster de banco de dados multi-AZ para alterar suas configurações. Você também pode realizar operações em um cluster de banco de dados multi-AZ, como obter snapshots.
Importante
Não é possível modificar as instâncias de banco de dados dentro de um cluster de banco de dados multi-AZ. Todas as modificações devem ser feitas no nível do cluster de banco de dados. A única operação que é possível realizar em uma instância de banco de dados dentro de um cluster de banco de dados multi-AZ é reinicializá-la.
Você pode modificar um cluster de banco de dados multi-AZ usando o AWS Management Console, a AWS CLI ou a API do RDS.
Para modificar um cluster de banco de dados multi-AZ
Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/
. -
No painel de navegação, escolha Bancos de dados e o cluster de banco de dados multi-AZ que você deseja modificar.
-
Escolha Modify (Modificar). A página Modify DB cluster (Modificar cluster de banco de dados) é exibida.
-
Altere qualquer uma das configurações desejadas. Para obter informações sobre cada configuração, consulte Configurações para modificar clusters de banco de dados multi-AZ.
-
Quando todas as alterações estiverem conforme o desejado, escolha Continue (Continuar) e verifique o resumo das modificações.
-
(Opcional) Escolha Apply immediately (Aplicar imediatamente) para aplicar as alterações imediatamente. Escolher essa opção pode causar uma inatividade em alguns casos. Para ter mais informações, consulte Aplicar alterações imediatamente.
-
Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha Modify DB cluster (Modificar cluster de banco de dados) para salvar as alterações.
Ou escolha Back (Voltar) para editar as alterações ou Cancel (Cancelar) para cancelar as alterações.
Para modificar um cluster de banco de dados multi-AZ utilizando a AWS CLI, chame o comando modify-db-cluster. Especifique o identificador de instância de banco de dados e os valores para as configurações que você deseja modificar. Para obter mais informações sobre cada opção, consulte Configurações para modificar clusters de banco de dados multi-AZ.
O código a seguir modifica my-multi-az-dbcluster configurando o período de retenção de backup como 1 semana (7 dias). O código ativa a proteção contra exclusão, utilizando --deletion-protection. Para desativar a proteção contra exclusão, utilize --no-deletion-protection. As alterações serão aplicadas durante a janela de manutenção usando --no-apply-immediately. Use --apply-immediately para aplicar as alterações imediatamente. Para ter mais informações, consulte Aplicar alterações imediatamente.
Para Linux, macOS ou Unix:
aws rds modify-db-cluster \ --db-cluster-identifiermy-multi-az-dbcluster\ --backup-retention-period7\--deletion-protection\--no-apply-immediately
Para Windows:
aws rds modify-db-cluster ^ --db-cluster-identifiermy-multi-az-dbcluster^ --backup-retention-period7^--deletion-protection^--no-apply-immediately
Para modificar um cluster de banco de dados multi-AZ usando a API do Amazon RDS, chame a operação ModifyDBCluster. Especifique o identificador de cluster de banco de dados e os parâmetros para as configurações que você deseja modificar. Para obter informações sobre cada parâmetro, consulte Configurações para modificar clusters de banco de dados multi-AZ.
Aplicar alterações imediatamente
Quando você modifica um cluster de banco de dados multi-AZ, pode aplicar as alterações imediatamente. Para aplicar as alterações imediatamente, escolha a opção Apply Immediately (Aplicar imediatamente) no AWS Management Console. Se preferir, use a opção --apply-immediately ao chamar AWS CLI ou defina o parâmetro ApplyImmediately como true ao usar a API do Amazon RDS.
Se você não optar por aplicar as alterações imediatamente, elas serão colocadas na fila de modificações pendentes. Durante a próxima janela de manutenção, todas as alterações pendentes na fila serão aplicadas. Se você optar por aplicar as alterações imediatamente, as novas alterações e todas as alterações na fila de modificações pendentes serão aplicadas.
Importante
Se alguma das modificações pendentes exigir que o cluster de banco de dados esteja temporariamente indisponível (inatividade), a escolha da opção para aplicar imediatamente poderá causar tempo de inatividade inesperado.
Quando você opta por aplicar uma alteração imediatamente, todas as modificações pendentes também são aplicadas de imediato, em vez de durante a próxima janela de manutenção.
Se não quiser que uma alteração pendente seja aplicada na próxima janela de manutenção, é possível modificar a instância de banco de dados para reverter a alteração. Você pode fazer isso usando a AWS CLI e especificando a opção --apply-immediately.
As alterações em algumas configurações do banco de dados são aplicadas imediatamente, mesmo que você opte por adiá-las. Para ver como as diferentes configurações do banco de dados interagem com a configuração Aplicar imediatamente, consulte Configurações para modificar clusters de banco de dados multi-AZ.
Configurações para modificar clusters de banco de dados multi-AZ
Para obter detalhes sobre as configurações que é possível utilizar para modificar um cluster de banco de dados multi-AZ, consulte a tabela a seguir. Para obter mais informações sobre as opções da AWS CLI, consulte modify-db-cluster. Para obter mais informações sobre os parâmetros da API do RDS, consulte ModifyDBCluster.
| Configuração do console | Descrição da configuração | Opção da CLI e parâmetro da API do RDS | Quando a alteração ocorre | Observações sobre tempo de inatividade |
|---|---|---|---|---|
|
Armazenamento alocado |
O valor de armazenamento a ser alocado para cada instância de banco de dados no seu cluster de banco de dados (em gibibyte). Para ter mais informações, consulte Armazenamento de instâncias de banco de dados do Amazon RDS.
|
Opção da CLI:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Não ocorre uma inatividade durante esta alteração. |
| Atualização da versão secundária automática |
Selecione Enable auto minor version upgrade (Habilitar atualização automática da versão secundária) para que o cluster de banco de dados receba atualizações automáticas da versão do mecanismo de banco de dados secundárias preferidas quando elas forem disponibilizadas. O Amazon RDS executa atualizações automáticas de versões secundárias na janela de manutenção. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração ocorre imediatamente. Essa configuração ignora a configuração para aplicar imediatamente. |
Ocorre uma inatividade durante esta alteração. |
| Backup retention period (Período de retenção de backup) |
O número de dias que você deseja que os backups automáticos do seu cluster de banco de dados fiquem retidos. Para clusters de banco de dados incomuns, defina esse valor como Para ter mais informações, consulte Introdução aos backups. |
Opção da CLI:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar imediatamente e alterar a configuração de um valor diferente de zero para outro valor diferente de zero, a alteração será aplicada de forma assíncrona o mais rápido possível. Caso contrário, a alteração ocorrerá durante a próxima janela de manutenção. |
Uma inatividade ocorrerá se você alterar de 0 para um valor diferente de zero ou de um valor diferente de zero para 0. |
| Janela de backup |
O período durante o qual o Amazon RDS faz um backup automático do seu cluster 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, utilize o padrão No Preference (Sem preferência). Para ter mais informações, consulte Introdução aos backups. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração é aplicada de forma assíncrona logo que possível. |
Não ocorre uma inatividade durante esta alteração. |
|
Autoridade certificadora |
A autoridade de certificação (CA) para o certificado do servidor usado pelo cluster de banco de dados. Para ter mais informações, consulte Usar SSL/TLS para criptografar uma conexão com uma instância ou um cluster de banco de dados. |
Opção da CLI:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Tempo de inatividade ocorrerá somente se o mecanismo de banco de dados não for compatível com alternância sem reinicialização. Você pode usar o comando da AWS CLI describe-db-engine-versions para determinar se o mecanismo de banco de dados é compatível com alternância sem reinicialização. |
| Copiar tags para snapshots |
Essa opção copia qualquer etiqueta do cluster de banco de dados para um snapshot do banco de dados quando você cria um snapshot. Para ter mais informações, consulte Marcar recursos do Amazon RDS. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração ocorre imediatamente. Essa configuração ignora a configuração para aplicar imediatamente. |
Não ocorre uma inatividade durante esta alteração. |
| Autenticação de banco de dados |
Para clusters de banco de dados multi-AZ, somente a autenticação por senha tem suporte. |
Nenhum, pois a autenticação por senha é o padrão. |
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Não ocorre uma inatividade durante esta alteração. |
|
Identificador do cluster de banco de dados |
O identificador de cluster de banco de dados. Esse valor é armazenado como uma string em minúsculas. Quando você altera o identificador de cluster de banco de dados, o endpoint de cluster de banco de dados é alterado. Os identificadores e os endpoints das instâncias de banco de dados no cluster de banco de dados também mudam. O nome do novo cluster de banco de dados deve ser exclusivo. O tamanho máximo é de 63 caracteres. Os nomes das instâncias de banco de dados no cluster de banco de dados são alterados para corresponder ao novo nome do cluster de banco de dados. O nome de uma nova instância de banco de dados não pode ser igual ao nome de uma instância de banco de dados existente. Por exemplo, se você alterar o nome do cluster de banco de dados para Para ter mais informações, consulte Renomear um cluster de banco de dados multi-AZ para o Amazon RDS. |
Opção da CLI:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Não ocorre uma inatividade durante esta alteração. |
| Classe de instância de cluster de banco de dados |
A capacidade de computação e memória de cada instância de banco de dados no cluster de banco de dados multi-AZ, por exemplo 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 ter mais informações, consulte Disponibilidade de classe de instância para clusters de banco de dados multi-AZ. |
Opção da CLI:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Ocorre uma inatividade durante esta alteração. |
|
Grupo de parâmetros do cluster de banco de dados |
O parameter group do cluster de banco de dados que você deseja associar ao cluster de banco de dados. Para ter mais informações, consulte Grupos de parâmetros para clusters de banco de dados multi-AZ. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração de grupo de parâmetros ocorre imediatamente. |
Não ocorre uma inatividade durante esta alteração. Quando você altera o grupo de parâmetros, as alterações feitas em alguns parâmetros são aplicadas às instâncias de banco de dados no cluster de banco de dados multi-AZ imediatamente sem reinicialização. Alterações em outros parâmetros são aplicadas somente depois que as instâncias de banco de dados forem reinicializadas. |
| 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:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Ocorre uma inatividade durante esta alteração. |
| Deletion protection (Proteção contra exclusão) |
Selecione Enable deletion protection (Habilitar proteção contra exclusão) para impedir que seu cluster de banco de dados seja excluído. Para ter mais informações, consulte Excluir uma instância de banco de dados. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração ocorre imediatamente. Essa configuração ignora a configuração para aplicar imediatamente. |
Não ocorre uma inatividade durante esta alteração. |
| Janela de manutenção |
A janela de 30 minutos na qual as modificações pendentes do seu cluster de banco de dados serão aplicadas. Se o período não for relevante, selecione No Preference (Sem preferência). Para ter mais informações, consulte A janela de manutenção do Amazon RDS. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração ocorre imediatamente. Essa configuração ignora a configuração para aplicar imediatamente. |
Se houver uma ou mais ações pendentes que provoquem uma inatividade, e a janela de manutenção for alterada para incluir a hora atual, essas ações pendentes serão aplicadas imediatamente e ocorrerá uma inatividade. |
| 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. Se o RDS já estiver gerenciando a senha do usuário principal para o cluster de banco de dados, você poderá alternar a senha do usuário principal selecionando Rotate secret immediately (Alternar segredo imediatamente). Para ter mais informações, consulte Gerenciamento de senhas com Amazon RDS e AWS Secrets Manager. |
Opção da CLI:
Parâmetro da API do RDS:
|
Se você estiver ativando ou desativando o gerenciamento automático de senhas de usuário principal, a alteração ocorrerá imediatamente. Essa configuração ignora a configuração para aplicar imediatamente. Se você estiver alternando a senha do usuário principal, deverá especificar que a alteração seja aplicada imediatamente. |
Não ocorre uma inatividade durante esta alteração. |
| Nova senha mestre |
A senha da conta de usuário principal. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração é aplicada de forma assíncrona logo que possível. Essa configuração ignora a configuração para aplicar imediatamente. |
Não ocorre uma inatividade durante esta alteração. |
| IOPS provisionadas |
A quantidade de IOPS (operações de entrada/saída por segundo) provisionadas a serem inicialmente alocadas ao cluster de banco de dados. |
Opção da CLI:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Não ocorre uma inatividade durante esta alteração. |
| Acesso público |
Publicly accessible (Acessível publicamente) para fornecer ao cluster de banco de dados um endereço IP público, o que significa que ele é acessível fora da nuvem privada virtual (VPC). Para ser acessível publicamente, o cluster de banco de dados também deve estar em uma sub-rede pública na VPC. Not publicly accessible (Não acessível publicamente) para tornar o cluster de banco de dados acessível somente de dentro da VPC. Para ter mais informações, consulte Ocultar uma instância de banco de dados em uma VPC da Internet. Para se conectar a um cluster de banco de dados de fora de sua VPC, o cluster de banco de dados deve ser acessível publicamente. Além disso, deve ser concedido acesso utilizando as regras de entrada do grupo de segurança do cluster de banco de dados, e 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. Se o cluster de banco de dados não estiver acessível publicamente, será possível usar uma conexão AWS Site-to-Site VPN ou uma conexão do AWS Direct Connect para acessá-la de uma rede privada. Para ter mais informações, consulte Privacidade do tráfego entre redes. |
Não disponível ao modificar uma instância de banco de dados. |
A alteração ocorre imediatamente. Essa configuração ignora a configuração para aplicar imediatamente. |
Não ocorre uma inatividade durante esta alteração. |
| Tipo de armazenamento |
O tipo de armazenamento do seu cluster de banco de dados. Somente os armazenamentos SSD de uso geral (gp3), IOPS provisionadas (io1) e SSD de IOPS provisionadas (io2) são compatíveis. Para ter mais informações, consulte Tipos de armazenamento do Amazon RDS. |
Opção da CLI:
Parâmetro da API do RDS:
|
Se você optar por aplicar a alteração imediatamente, ela ocorrerá imediatamente. Se você não optar por aplicar a alteração imediatamente, ela ocorrerá durante a próxima janela de manutenção. |
Não ocorre uma inatividade durante esta alteração. |
| Grupo de segurança de VPC |
O grupo de segurança a ser associado ao cluster de banco de dados. Para ter mais informações, consulte Visão geral dos grupos de segurança de VPC. |
Opção da CLI:
Parâmetro da API do RDS:
|
A alteração é aplicada de forma assíncrona logo que possível. Essa configuração ignora a configuração para aplicar imediatamente. |
Não ocorre uma inatividade durante esta alteração. |
Configurações não aplicáveis ao modificar clusters de banco de dados multi-AZ
As seguintes configurações no comando da AWS CLI modify-db-cluster e na operação ModifyDBCluster da API do RDS não se aplicam a clusters de banco de dados multi-AZ.
Você também não pode modificar essas configurações para clusters de banco de dados multi-AZ no console.
| Configuração da AWS CLI | Configuração da API do RDS |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
