Renomear uma instância de banco de dados

Você pode renomear uma instância de banco de dados usando o AWS Management Console, o comando modify-db-instance da AWS CLI ou a ação ModifyDBInstance da API do Amazon RDS. Renomear uma instância de banco de dados pode ter efeitos de longo alcance. Veja a seguir uma lista de considerações antes de renomear uma instância de banco de dados.

• Quando você renomeia uma instância de banco de dados, o endpoint dessa instância é alterado, pois o URL inclui o nome que você atribuiu a ela. Você sempre deve redirecionar o tráfego da URL antiga para a nova.

• Ao renomear uma instância de banco de dados, o nome DNS antigo que era usado pelo cluster é excluído imediatamente, embora ele possa permanecer armazenado em cache por alguns minutos. O novo nome DNS da instância de banco de dados renomeada torna-se efetivo em 10 minutos. A instância de banco de dados renomeada não ficará disponível até que o novo nome entre em vigor.

• Você não pode usar um nome de instância de banco de dados existente ao renomear uma instância.

• Todas as réplicas de leitura associadas a uma instância de banco de dados permanecem associadas a essa instância depois que ela é renomeada. Por exemplo, suponha que você tenha uma instância de banco de dados que serve seu banco de dados de produção e essa instância tem várias réplicas de leitura associadas. Se você renomear a instância de banco de dados e a substituir no ambiente de produção por um snapshot de banco de dados, a instância de banco de dados que você renomeou ainda terá as réplicas leitura associadas a ela.

• Métricas e eventos associados ao nome de uma instância de banco de dados serão mantidos se você reutilizar um nome de instância de banco de dados. Por exemplo, se você promover uma réplica de leitura e a renomear para que ela tenha o nome da instância de banco de dados primária anterior, os eventos e as métricas associados à instância de banco de dados primária serão associados à instância renomeada.

• Tags de instâncias de bancos de dados permanecem com a instância de banco de dados, independentemente de renomeação.

• snapshot de banco de dadoss são mantidos para uma instância de banco de dados renomeada.

nota

Uma instância de banco de dados é um ambiente de banco de dados isolado em execução na nuvem. Uma instância de banco de dados pode hospedar vários bancos de dados ou um único banco de dados Oracle com vários esquemas. Para obter informações sobre como alterar um nome de banco de dados, consulte a documentação do seu mecanismo de banco de dados.

Renomear para substituir uma instância de banco de dados existente

As razões mais comuns para renomear uma instância de banco de dados são porque você está promovendo uma réplica de leitura ou restaurando dados de um snapshot de banco de dados ou de uma Point-In-Time Recovery (PITR – Recuperação point-in-time). Ao renomear o banco de dados, você pode substituir a instância de banco de dados sem precisar alterar qualquer código de aplicativo que faça referência a ela. Nesses casos, faça o seguinte:

1. Pare todo o tráfego para a instância de banco de dados primária. Isso pode envolver redirecionar o tráfego, impedindo-o de acessar os bancos de dados na instância de banco de dados ou de alguma outra maneira que você queira impedir que o tráfego acesse seus bancos de dados na instância de banco de dados.

2. Renomeie a instância de banco de dados primária com um nome que indique que ela não é mais a instância de banco de dados primária, conforme descrito mais adiante neste tópico.

3. Crie uma nova instância de banco de dados primária restaurando de um snapshot de banco de dados ou promovendo uma réplica de leitura e dê à nova instância o nome da instância de banco de dados primária anterior.

4. Associe réplicas de leitura à nova instância de banco de dados primária.

Se você excluir a instância de banco de dados primária antiga, será responsável por excluir qualquer snapshot de banco de dados indesejado dessa instância primária antiga.

Para obter informações sobre como promover uma réplica de leitura, consulte Promoção de uma réplica de leitura a uma instância de banco de dados autônoma.

Importante

A instância de banco de dados é reinicializada ao ser renomeada.

Console

Para renomear uma instância de banco de dados

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 Databases (Bancos de dados).

3. Selecione a instância de banco de dados que você deseja renomear.

4. Selecione Modify.

5. Em Settings (Configurações), digite um novo nome para DB instance identifier (Identificador da instância de banco de dados).

6. Escolha Continue.

7. Para aplicar as alterações imediatamente, escolha Apply immediately. Escolher essa opção pode causar uma interrupção em alguns casos. Para obter mais informações, consulte Modificar uma instância de banco de dados do Amazon RDS.

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

   Como alternativa, escolha Back (Voltar) para editar suas alterações ou escolha Cancel (Cancelar) para cancelar as alterações.

AWS CLI

Para renomear uma instância de banco de dados, use o comando AWS CLI da modify-db-instance. Forneça ao valor --db-instance-identifier atual e ao parâmetro --new-db-instance-identifier o novo nome da instância de banco de dados.

exemplo

Para Linux, macOS ou Unix:

aws rds modify-db-instance \
    --db-instance-identifier DBInstanceIdentifier \
    --new-db-instance-identifier NewDBInstanceIdentifier

Para Windows:

aws rds modify-db-instance ^
    --db-instance-identifier DBInstanceIdentifier ^
    --new-db-instance-identifier NewDBInstanceIdentifier

API do RDS

Para renomear uma instância de banco de dados, chame a operação ModifyDBInstance da API do Amazon RDS com os seguintes parâmetros:

• DBInstanceIdentifier — nome existente da instância

• NewDBInstanceIdentifier — novo nome da instância