Habilitar o encaminhamento de gravação local - Amazon Aurora
Habilitar o encaminhamento de gravação para sessões de banco de dados

Habilitar o encaminhamento de gravação local

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.

Usando o AWS Management Console, 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.

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.

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

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.

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.