Modificar um cluster de banco de dados multi-AZ - Amazon Relational Database Service

Modificar um cluster de banco de dados multi-AZ

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 clusters de banco de dados multi-AZ.

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
  1. Faça login no AWS Management Console e abra o console do Amazon RDS em https://console.aws.amazon.com/rds/.

  2. No painel de navegação, escolha Bancos de dados e o cluster de banco de dados multi-AZ que você deseja modificar.

  3. Escolha Modify (Modificar). A página Modify DB cluster (Modificar cluster de banco de dados) é exibida.

  4. 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.

  5. Quando todas as alterações estiverem conforme o desejado, escolha Continue (Continuar) e verifique o resumo das modificações.

  6. (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.

  7. 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-identifier my-multi-az-dbcluster \ --backup-retention-period 7 \ --deletion-protection \ --no-apply-immediately

Para Windows:

aws rds modify-db-cluster ^ --db-cluster-identifier my-multi-az-dbcluster ^ --backup-retention-period 7 ^ --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:

--allocated-storage

Parâmetro da API do RDS:

AllocatedStorage

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:

--auto-minor-version-upgrade

--no-auto-minor-version-upgrade

Parâmetro da API do RDS:

AutoMinorVersionUpgrade

A alteração ocorre imediatamente. Essa configuração ignora a configuração para aplicar imediatamente.

Não 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 1 ou maior.

Para ter mais informações, consulte Introdução aos backups.

Opção da CLI:

--backup-retention-period

Parâmetro da API do RDS:

BackupRetentionPeriod

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:

--preferred-backup-window

Parâmetro da API do RDS:

PreferredBackupWindow

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:

--ca-certificate-identifier

Parâmetro da API do RDS:

CACertificateIdentifier

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:

-copy-tags-to-snapshot

-no-copy-tags-to-snapshot

Parâmetro da API do RDS:

CopyTagsToSnapshot

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 maz, o nome de uma instância de banco de dados poderá ser alterado para maz-instance-1. Nesse caso, não pode haver uma instância de banco de dados existente chamada maz-instance-1.

Para ter mais informações, consulte Renomear um cluster de banco de dados multi-AZ.

Opção da CLI:

--new-db-cluster-identifier

Parâmetro da API do RDS:

NewDBClusterIdentifier

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 interrupção 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 db.r6gd.xlarge.

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:

--db-cluster-instance-class

Parâmetro da API do RDS:

DBClusterInstanceClass

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 Trabalhar com grupos de parâmetros para clusters de banco de dados multi-AZ.

Opção da CLI:

--db-cluster-parameter-group-name

Parâmetro da API do RDS:

DBClusterParameterGroupName

A alteração de grupo de parâmetros ocorre imediatamente.

Não ocorre uma interrupção 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:

--engine-version

Parâmetro da API do RDS:

EngineVersion

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 interrupção 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:

--deletion-protection

--no-deletion-protection

Parâmetro da API do RDS:

DeletionProtection

A alteração ocorre imediatamente. Essa configuração ignora a configuração para aplicar imediatamente.

Não ocorre uma interrupção 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:

--preferred-maintenance-window

Parâmetro da API do RDS:

PreferredMaintenanceWindow

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:

--manage-master-user-password | --no-manage-master-user-password

--master-user-secret-kms-key-id

--rotate-master-user-password | --no-rotate-master-user-password

Parâmetro da API do RDS:

ManageMasterUserPassword

MasterUserSecretKmsKeyId

RotateMasterUserPassword

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:

--master-user-password

Parâmetro da API do RDS:

MasterUserPassword

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:

--iops

Parâmetro da API do RDS:

Iops

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 interrupção 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:

--storage-type

Parâmetro da API do RDS:

StorageType

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:

--vpc-security-group-ids

Parâmetro da API do RDS:

VpcSecurityGroupIds

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 interrupção 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

--backtrack-window

BacktrackWindow

--cloudwatch-logs-export-configuration

CloudwatchLogsExportConfiguration

--copy-tags-to-snapshot | --no-copy-tags-to-snapshot

CopyTagsToSnapshot

--db-instance-parameter-group-name

DBInstanceParameterGroupName

--domain

Domain

--domain-iam-role-name

DomainIAMRoleName

--enable-global-write-forwarding | --no-enable-global-write-forwarding

EnableGlobalWriteForwarding

--enable-http-endpoint | --no-enable-http-endpoint

EnableHttpEndpoint

--enable-iam-database-authentication | --no-enable-iam-database-authentication

EnableIAMDatabaseAuthentication

--option-group-name

OptionGroupName

--port

Port

--scaling-configuration

ScalingConfiguration

--storage-type

StorageType