# Habilitar o encaminhamento de gravação local
<a name="aurora-mysql-write-forwarding-enabling"></a>

Por padrão, o encaminhamento de gravação local não está habilitado para clusters de banco de dados do Aurora MySQL. Você habilita o encaminhamento de gravação local no cluster, não na instância.

**Importante**  
Você também pode habilitar o encaminhamento de gravação local para réplicas de leitura entre regiões que usam registro em log binário, mas as operações de gravação não são encaminhadas à Região da AWS de origem. Elas são encaminhadas à instância de banco de dados do gravador do cluster de réplica de leitura do binlog.  
Use esse método somente se você tiver um caso de uso para gravar na réplica de leitura do binlog na Região da AWS secundária. Caso contrário, você pode acabar enfrentando um cenário de “cérebro dividido”, caso em que os conjuntos de dados replicados são inconsistentes entre si.   
Recomendamos usar o encaminhamento de gravação global com bancos de dados globais, em vez do encaminhamento de gravação local em réplicas de leitura entre regiões, a menos que seja absolutamente necessário. Para ter mais informações, consulte [Como usar o encaminhamento de gravação em um banco de dados global Amazon Aurora](aurora-global-database-write-forwarding.md).

## Console
<a name="aurora-mysql-write-forwarding-enabling.CON"></a>

Usando o Console de gerenciamento da AWS, marque a caixa de seleção **Ativar o encaminhamento de gravação local** abaixo de **Encaminhamento de gravação de réplica de leitura** quando você criar ou modificar um cluster de banco de dados.

## AWS CLI
<a name="aurora-mysql-write-forwarding-enabling.CLI"></a>

Para habilitar o encaminhamento de gravação com a AWS CLI, use a opção `--enable-local-write-forwarding`. Essa opção funciona quando você cria um cluster de banco de dados usando o comando `create-db-cluster`. Ela também funciona quando você modifica um cluster de banco de dados usando o comando `modify-db-cluster`. É possível desabilitar o encaminhamento de gravação usando a opção `--no-enable-local-write-forwarding` com esses mesmos comandos da CLI.

O exemplo a seguir cria um cluster de banco de dados do Aurora MySQL com encaminhamento de gravação habilitado.

```
aws rds create-db-cluster \
  --db-cluster-identifier write-forwarding-test-cluster \
  {{--enable-local-write-forwarding}} \
  --engine aurora-mysql \
  --engine-version {{8.0.mysql_aurora.3.04.0}} \
  --master-username myuser \
  --master-user-password mypassword \
  --backup-retention 1
```

Depois, você cria instâncias de banco de dados do gravador e do leitor para poder usar o encaminhamento de gravação. Para ter mais informações, consulte [Criar um cluster de bancos de dados do Amazon Aurora](Aurora.CreateInstance.md).

## API do RDS
<a name="aurora-mysql-write-forwarding-enabling.API"></a>

Para habilitar o encaminhamento de gravação usando a API do Amazon RDS, defina o parâmetro `EnableLocalWriteForwarding` como `true`. Esse parâmetro funciona quando você cria um cluster de banco de dados usando a operação `CreateDBCluster`. Ele também funciona quando você modifica um cluster de banco de dados usando a operação `ModifyDBCluster`. É possível desabilitar o encaminhamento de gravação definindo o parâmetro `EnableLocalWriteForwarding` como `false`.

## Habilitar o encaminhamento de gravação para sessões de banco de dados
<a name="aurora-mysql-write-forwarding-enabling-session"></a>

`aurora_replica_read_consistency` é um parâmetro de banco de dados e de cluster de banco de dados que permite o encaminhamento de gravação. Você pode especificar `EVENTUAL`, `SESSION` ou `GLOBAL` para o nível de consistência de leitura. Para saber mais sobre os níveis de consistência, consulte [Consistência de leitura para encaminhamento de gravação](aurora-mysql-write-forwarding-consistency.md). 

As seguintes regras se aplicam a esse parâmetro:
+ O valor padrão é '' (null).
+ O encaminhamento de gravação estará disponível apenas se você definir `aurora_replica_read_consistency` como `EVENTUAL`, `SESSION` ou `GLOBAL`. Esse parâmetro é relevante somente em instâncias do leitor de clusters de banco de dados que têm o encaminhamento de gravação habilitado.
+ Não é possível definir esse parâmetro (quando vazio) ou cancelar a definição (quando já estiver definido) em uma transação de várias declarações. Você pode alterá-lo de um valor válido para outro valor válido durante essa transação, mas não recomendamos essa ação.