Renomear um cluster de banco de dados multi-AZ

Você pode renomear um cluster de banco de dados multi-AZ utilizando o AWS Management Console, comando modify-db-cluster da AWS CLI ou a operação ModifyDBCluster da API do Amazon RDS. Renomear um cluster de banco de dados multi-AZ pode ter efeitos significativos. Veja a seguir uma lista de considerações antes de renomear um cluster de banco de dados multi-AZ.

• Quando você renomeia um cluster de banco de dados multi-AZ, os endpoints de cluster do cluster de banco de dados multi-AZ são alterados. Esses endpoints mudam porque incluem o nome que você atribuiu ao cluster de banco de dados multi-AZ. Você pode redirecionar o tráfego de um endpoint antigo para um novo. Para obter mais informações sobre endpoints de cluster de banco de dados multi-AZ, consulte Conectar a um cluster de banco de dados multi-AZ.

• Ao renomear um cluster de banco de dados multi-AZ, o nome DNS antigo que era usado pelo cluster é excluído, embora ele possa permanecer armazenado em cache por alguns minutos. O novo nome DNS do cluster de banco de dados multi-AZ renomeado entra em vigor em, aproximadamente, dois minutos. O cluster de banco de dados multi-AZ renomeado não fica disponível até que o novo nome entre em vigor.

• Você não pode usar um nome de cluster de banco de dados multi-AZ existente ao renomear um cluster.

• Métricas e eventos associados ao nome de um cluster de banco de dados multi-AZ serão mantidos se você reutilizar um nome de cluster de banco de dados.

• As tags de cluster de banco de dados multi-AZ permanecem no cluster de banco de dados multi-AZ, independentemente da renomeação.

• Snapshots de cluster de banco de dados são retidos para um cluster de banco de dados multi-AZ renomeado.

nota

Um cluster de banco de dados multi-AZ é um ambiente de banco de dados isolado em execução na nuvem. Um cluster de banco de dados multi-AZ pode hospedar vários bancos de dados. 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 um cluster de banco de dados multi-AZ existente

As situações mais comuns para renomear um cluster de banco de dados multi-AZ incluem restaurar dados de um snapshot de cluster de banco de dados ou realizar uma recuperação a um ponto anterior no tempo (PITR). Ao renomear o cluster de banco de dados multi-AZ, você pode substituir o cluster de banco de dados multi-AZ sem alterar nenhum código de aplicação que faça referência ao cluster de banco de dados multi-AZ. Nesses casos, conclua as seguintes etapas:

1. Interrompa todo o tráfego para o cluster de banco de dados multi-AZ. É possível redirecionar o tráfego, impedindo-o de acessar os bancos de dados no cluster de banco de dados multi-AZ ou selecionar outra forma de impedir que o tráfego acesse seus bancos de dados no cluster de banco de dados multi-AZ.

2. Renomeia o cluster de banco de dados multi-AZ existente.

3. Crie um cluster de banco de dados multi-AZ restaurando-o de um snapshot de banco de dados ou recuperando-o para um momento específico. Depois, dê ao cluster de banco de dados multi-AZ o nome do cluster de banco de dados multi-AZ anterior.

Se você excluir o cluster de banco de dados multi-AZ antigo, será responsável por excluir qualquer snapshot de banco de dados indesejado do cluster de banco de dados multi-AZ antigo.

Console

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

3. Selecione o cluster de banco de dados multi-AZ que você deseja renomear.

4. Escolha Modificar.

5. Em Settings (Configurações), digite um novo nome para DB cluster identifier (Identificador do cluster 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 Aplicar alterações imediatamente.

8. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha Modify cluster (Modificar cluster) para salvar as alterações.

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

AWS CLI

Para renomear um cluster de banco de dados multi-AZ, use o comando modify-db-cluster da AWS CLI. Forneça ao valor --db-cluster-identifier atual e ao parâmetro --new-db-cluster-identifier o novo nome do cluster de banco de dados multi-AZ.

exemplo

Para Linux, macOS ou Unix:

aws rds modify-db-cluster \
    --db-cluster-identifier DBClusterIdentifier \
    --new-db-cluster-identifier NewDBClusterIdentifier

Para Windows:

aws rds modify-db-cluster ^
    --db-cluster-identifier DBClusterIdentifier ^
    --new-db-cluster-identifier NewDBClusterIdentifier

API do RDS

Para renomear um cluster de bancos de dados multi-AZ, chame a operação ModifyDBCluster da API do Amazon RDS com os seguintes parâmetros:

• DBClusterIdentifier: o nome existente do cluster de banco de dados.

• NewDBClusterIdentifier: o novo nome do cluster de banco de dados.