# Promover uma réplica de leitura a um cluster de banco de dados para o Aurora MySQL
<a name="AuroraMySQL.Replication.CrossRegion.Promote"></a>

 Você pode promover uma réplica de leitura do Aurora MySQL para um cluster de banco de dados autônomo. Quando você promove uma réplica de leitura do Aurora MySQL, suas instâncias de banco de dados são reiniciadas antes de se tornarem disponíveis. 

 Normalmente, você promove uma réplica de leitura do Aurora MySQL para um cluster de banco de dados autônomo como um esquema de recuperação de dados se houver uma falha no cluster de banco de dados de origem. 

 Para isso, primeiro crie uma réplica de leitura e monitore o cluster de banco de dados de origem para identificar se há falhas. Em caso de falha, faça o seguinte: 

1.  Promova a réplica de leitura. 

1.  Direcione o tráfego do banco de dados para o cluster de banco de dados promovido. 

1.  Crie uma réplica de leitura de substituição com o cluster de banco de dados promovido como origem. 

 Quando você promove uma réplica de leitura, a réplica de leitura se torna um cluster de banco de dados do Aurora autônomo. O processo de promoção pode levar vários minutos ou mais para ser concluído, dependendo do tamanho da réplica de leitura. Depois da promoção da réplica de leitura para um novo cluster de banco de dados, ela será semelhante a qualquer outro cluster de banco de dados. Por exemplo, você pode criar réplicas de leitura dele e executar operações de recuperação pontuais. Você também pode criar réplicas do Aurora para o cluster de banco de dados. 

 Como o cluster de banco de dados promovido não é mais uma réplica de leitura, não é possível usá-lo como um destino de replicação. 

 As etapas a seguir mostram o processo geral para promover uma réplica de leitura para um cluster de banco de dados: 

1.  Interrompa a gravação de todas as transações no cluster de banco de dados de origem da réplica de leitura e aguarde todas as atualizações a serem feitas na réplica de leitura. As atualizações do banco de dados ocorrem na réplica de leitura após terem ocorrido no cluster de banco de dados de origem e esse atraso de replicação pode variar significativamente. Use a métrica `ReplicaLag` para determinar quando todas as atualizações foram feitas na réplica de leitura. A métrica `ReplicaLag` registra a quantidade de tempo que uma instância de banco de dados de réplica de leitura atrasa em relação à instância de banco de dados de origem. Quando a métrica `ReplicaLag` chega a `0`, isso mostra que a réplica de leitura alcançou a instância do banco de dados de origem. 

1.  Promova a réplica de leitura usando a opção **Promote** (Promover) no console do Amazon RDS, o comando [promote-read-replica-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica-db-cluster.html) da AWS CLI ou a operação [PromoteReadReplicaDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplicaDBCluster.html) da API do Amazon RDS. 

    Você escolhe uma instância de banco de dados do Aurora MySQL para promover a réplica de leitura. Depois que a réplica de leitura é promovida, o cluster de banco de dados do Aurora MySQL é promovido para um cluster de banco de dados autônomo. A instância de banco de dados com a prioridade de failover mais alta é promovida para a instância de banco de dados principal para o cluster de banco de dados. As outras instâncias de banco de dados se tornam réplicas do Aurora. 
**nota**  
 O processo de promoção leva alguns minutos para ser concluído. Ao promover uma réplica de leitura, a replicação é interrompida, e as instâncias de banco de dados são reiniciadas. Quando a reinicialização é concluída, a réplica de leitura está disponível como um novo cluster de banco de dados. 

## Console
<a name="AuroraMySQL.Replication.CrossRegion.Promote.Console"></a>

**Para promover uma réplica de leitura do Aurora MySQL para um 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 console, escolha **Instances (Instâncias)**. 

    O painel **Instance (Instância)** é exibido. 

1.  No painel **Instances (Instâncias)**, escolha a réplica de leitura que você deseja promover. 

    As réplicas de leitura aparecem como instâncias de banco de dados do Aurora MySQL. 

1.  Em **Actions (Ações)**, escolha **Promote read replica (Promover réplica de leitura)**. 

1.  Na página de confirmação, escolha **Promote read replica (Promover réplica de leitura)**. 

## AWS CLI
<a name="AuroraMySQL.Replication.CrossRegion.Promote.CLI"></a>

 Para promover uma réplica de leitura para um cluster de banco de dados, use o comando [promote-read-replica-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/promote-read-replica-db-cluster.html) da AWS CLI. 

**Example**  
Para Linux, macOS ou Unix:  

```
aws rds promote-read-replica-db-cluster \
    --db-cluster-identifier mydbcluster
```
Para Windows:  

```
aws rds promote-read-replica-db-cluster ^
    --db-cluster-identifier mydbcluster
```

## API do RDS
<a name="AuroraMySQL.Replication.CrossRegion.Promote.API"></a>

 Para promover uma réplica de leitura para um cluster de banco de dados, chame [PromoteReadReplicaDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_PromoteReadReplicaDBCluster.html).