

# Trabalhar com réplicas para o Amazon RDS para Db2
<a name="db2-replication"></a>

O RDS para Db2 aceita a criação de bancos de dados de réplica para fornecer recursos de escalabilidade de leitura e recuperação de desastres. Você pode criar réplicas em dois modos: réplicas somente para leitura para automatizar workloads de leitura e réplicas em espera para recuperação de desastres entre regiões. O RDS para Db2 usa Recuperação de Desastres de Alta Disponibilidade (HADR) do IBM Db2 para replicação. Para obter mais informações, consulte [High availability disaster recovery (HADR)](https://www.ibm.com/docs/en/db2/11.5?topic=server-high-availability-disaster-recovery-hadr) na IBM Db2documentação.

Um banco de dados de *réplica do Db2* é uma cópia física do seu banco de dados primário. Uma réplica do Db2 no modo somente leitura é chamada de *réplica de leitura*. Uma réplica do Db2 no modo de espera é chamada de *réplica em espera*. O Db2 não permite gravações em uma réplica, mas é possível promover uma réplica para torná-la gravável. A réplica promovida terá os dados replicados para o ponto quando a solicitação foi feita para promovê-la. Para obter mais informações, consulte [Promoção de uma réplica de leitura a uma instância de banco de dados autônoma](USER_ReadRepl.Promote.md).

Para ver um resumo dos recursos e dos comportamentos de réplicas do RDS para Db2, consulte [Diferenças entre réplicas de leitura para mecanismos de banco de dados](USER_ReadRepl.Overview.Differences.md).

## Réplicas somente leitura e em espera
<a name="db2-read-replicas.overview.modes"></a>

Ao criar ou modificar uma réplica do Db2, você pode colocá-la em um dos seguintes modos:

**Somente leitura**  
Esse é o padrão. O HADR transmite e aplica alterações do banco de dados de origem a todos os bancos de dados da réplica de leitura. No caso de réplicas somente leitura, a variável de ambiente do Db2 `DB2_HADR_ROS` é definida como `ON`. O nível de isolamento para consultas de leitura no banco de dados de réplica é `Uncommitted Read`. Para acessar mais informações, consulte [Isolation level on the active standby database](https://www.ibm.com/docs/en/db2/11.5?topic=standby-isolation-level-active-database) na documentação do IBM Db2.  
Para obter informações gerais sobre réplicas de leitura que se aplicam a todos os mecanismos de banco de dados, consulte [Trabalhar com réplicas de leitura de instância de banco de dados](USER_ReadRepl.md). Para acessar mais informações, consulte [High availability disaster recovery (HADR)](https://www.ibm.com/docs/en/db2/11.5?topic=server-high-availability-disaster-recovery-hadr) na documentação do IBM Db2.

 **Em espera**  
Para réplicas em espera, a variável de ambiente do Db2 `DB2_HADR_ROS` é definida como `OFF` de forma que os bancos de dados de réplica não aceitem conexões de usuário. O principal uso para réplicas em espera é a recuperação de desastres entre regiões.  
Uma réplica em espera não pode atender a uma workload somente leitura. A réplica em espera não tem nenhum log de arquivo.

Você pode criar até três réplicas de uma instância de banco de dados de origem. É possível criar uma combinação de réplicas de banco de dados somente leitura e em espera para a mesma instância de banco de dados de origem. Depois de criar uma réplica, você pode alterar o modo dela. Para acessar mais informações, consulte [Modificar o modo da réplica do RDS para Db2](db2-replicas-changing-replica-mode.md). 

Antes de criar réplicas, garanta que todos os requisitos sejam atendidos. Para obter mais informações, consulte [Requisitos e considerações sobre réplicas do RDS para Db2](db2-read-replicas.limitations.md).

## Ativações do banco de dados
<a name="db2-read-replicas.overview.database-activations"></a>

O HADR do Db2 é configurado no nível do banco de dados. Depois de criar réplicas, o HADR é definido para todos os bancos de dados Db2, inclusive `rdsadmin`, que o RDS gerencia totalmente. Antes de criar réplicas do Db2, você deve ativar explicitamente todos os bancos de dados. Caso contrário, a criação de réplicas falhará e o Amazon RDS emitirá um evento. Depois que uma instância de banco de dados tiver uma ou mais réplicas, você não poderá ativar ou desativar nenhum banco de dados na instância de banco de dados usando os procedimentos armazenados `rdsadmin.activate_database` ou `rdsadmin.deactivate_database`. Para obter mais informações, consulte [Procedimentos armazenados para bancos de dados do RDS para Db2](db2-sp-managing-databases.md).

## Configurações de HADR
<a name="db2-read-replicas.overview.hadr-configurations"></a>

Você pode ver todas as configurações de HADR de um banco de dados conectando-se ao banco de dados e depois executando `db2 get db cfg`. 

## Arquivar retenção de logs
<a name="db2-read-replicas.overview.log-retention"></a>

O Amazon RDS limpará os logs de uma instância de banco de dados primária depois que as seguintes condições forem atendidas:
+ Os logs têm pelo menos duas horas.
+ A configuração para o período de retenção para os logs de arquivo expirou.
+ Os logs de arquivamento foram replicados com sucesso em todas as instâncias de banco de dados de réplica. Essa condição se aplica tanto às instâncias de banco de dados na mesma Região da AWS quanto às instâncias de banco de dados entre regiões. 

Para obter informações sobre como definir horas de retenção de log de arquivamento, consulte [rdsadmin.set\$1archive\$1log\$1retention](db2-sp-managing-databases.md#db2-sp-set-archive-log-retention).

O Amazon RDS verifica e limpa cada banco de dados individualmente. Se um banco de dados perder a conexão HADR ou se as informações sobre a conexão não estiverem disponíveis, o Amazon RDS ignorará o banco de dados e não limpará os logs de arquivamento.

## Interrupções durante a replicação do Db2
<a name="db2-read-replicas.overview.outages"></a>

Ao criar uma réplica, o Amazon RDS faz um snapshot do banco de dados da sua instância de banco de dados de origem e inicia a replicação. Quando a operação de snapshot do banco de dados se inicia, a instância de banco de dados de origem sofre uma suspensão de E/S muito breve. A suspensão de E/S geralmente dura um segundo. No entanto, se a instância de banco de dados de origem for uma implantação Multi-AZ, a instância de banco de dados de origem não sofrerá nenhuma suspensão de E/S. Isso ocorre porque, com implantações Multi-AZ, o snapshot é obtido da instância de banco de dados secundária.

O snapshot de banco de dados torna-se a réplica do Db2. O Amazon RDS define as permissões e os parâmetros necessários para o banco de dados de origem e para a réplica sem interrupção do serviço. Da mesma forma, se você excluir uma réplica, nenhuma interrupção ocorrerá.

# Requisitos e considerações sobre réplicas do RDS para Db2
<a name="db2-read-replicas.limitations"></a>

Os requisitos de réplica do Db2 se enquadram em várias categorias: licenciamento e versionamento, considerações de backup e restauração, comportamento de replicação e considerações operacionais gerais. Antes de criar uma réplica do Oracle, familiarize-se com os seguintes requisitos e considerações.

## Requisitos de versão e licenciamento para réplicas do RDS para Db2
<a name="db2-read-replicas.limitations.versions-and-licenses"></a>

Antes de criar uma réplica do RDS para Db2, analise as seguintes informações sobre versões e modelos de licenciamento:
+ **Versões aceitas**: todas as versões do Db2 11.5 aceitam instâncias de banco de dados de réplica. 

  As instâncias de banco de dados de origem e réplica devem usar a mesma versão principal. As réplicas do Db2 comportam atualizações de versões secundárias, mas não atualizações de versões principais. Para acessar informações sobre como atualizar instâncias de banco de dados, consulte [Atualizar a versão de mecanismo de uma instância de banco de dados ](USER_UpgradeDBInstance.Upgrading.md).
**nota**  
Quando você atualiza uma instância de banco de dados de origem, todas as réplicas são atualizadas automaticamente para manter a compatibilidade das versões.
+ **Modelos de licença válidos e modos de réplica**: tanto o Db2 Advanced Edition (AE) quanto o Standard Edition (SE) podem criar réplicas somente leitura ou em espera tanto para o modelo traga a sua própria licença (BYOL) quanto para o modelo de licença do Db2 por meio do modelo AWS Marketplace.
+ **Grupo de parâmetros personalizado**: é necessário especificar um grupo de parâmetros personalizado para a réplica. 

  Para réplicas que usam o modelo BYOL, esse grupo de parâmetros personalizados deve incluir seu IBM Site ID e IBM Customer ID. Para obter mais informações, consulte [IDs da IBM para traga a sua própria licença (BYOL) para o Db2](db2-licensing.md#db2-prereqs-ibm-info). Você pode especificar esse grupo de parâmetros personalizado para a réplica usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. 
+ A **contagem de vCPUs** varia de acordo com o modo de réplica e o modelo de licenciamento:
  + As **réplicas em espera** sempre usam duas vCPUs, independentemente do tamanho da instância de banco de dados.
    + **Modelo BYOL**: as configurações de AWS License Manager mostram que as instâncias de banco de dados do RDS para Db2 usam duas vCPUs.
    + **Modelo de licença do Db2 por meio do AWS Marketplace**, as faturas exibem os custos de licença de duas vCPUs.
  + As **réplicas somente leitura** usam a mesma contagem de vCPUs que o tamanho da instância de banco de dados.
    + **Modelo BYOL**: as configurações do AWS License Manager mostram que as instâncias de banco de dados do RDS para Db2 usam o mesmo número de vCPUs que correspondem ao tamanho da instância de banco de dados.
    + **Licença do Db2 por meio do modelo AWS Marketplace**: as contas refletem os custos de licença para o mesmo número de vCPUs que correspondem ao tamanho da instância de banco de dados.

## Considerações sobre backup e restauração de réplicas do RDS para Db2
<a name="db2-read-replicas.limitations.backups"></a>

Os backups de réplicas têm um comportamento diferente dos backups do banco de dados primário. Pense nos seguintes requisitos de backup e restauração:
+ Para criar snapshots de réplicas do RDS para Db2 ou ativar backups automáticos, defina o período de retenção de backup manualmente. Por padrão, os backups automáticos não estão ativados.
+ Ao restaurar um backup de réplica, você restaura para a hora do banco de dados, não para a hora de criação do backup. A hora do banco de dados se refere ao horário de transação mais recente aplicado dos dados no backup. A diferença é significativa porque uma réplica pode apresentar atraso de minutos ou horas em relação ao banco de dados primário. Quando há vários bancos de dados, o RDS para Db2 usa o horário mais antigo do banco de dados.

  Para descobrir a diferença, execute o comando AWS CLI [describe-db-snapshots](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-snapshots.html) ou chame a operação [DescribeDBSnapshots](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshots.html) da API do RDS. Compare o valor `SnapshotDatabaseTime` com o valor `OriginalSnapshotCreateTime`. O valor `SnapshotDatabaseTime` é o horário do banco de dados do backup da réplica. O valor `OriginalSnapshotCreateTime` é a última transação aplicada no banco de dados primário.

Para acessar informações sobre backups e como restaurá-los, consulte [Como trabalhar com backups de réplicas do RDS para Db2](db2-read-replicas.backups.md).

## Considerações sobre replicação para réplicas do RDS para Db2
<a name="db2-read-replicas.limitations.replication"></a>

As réplicas do Db2 usam a tecnologia HADR com limitações e comportamentos específicos. Analise as seguintes considerações sobre replicação:
+ A replicação usa Db2 HADR para todos os bancos de dados na instância de banco de dados do RDS para Db2.
+ A replicação não suporta o comando `LOAD`. Se você executar o comando `LOAD` a partir da instância de banco de dados de origem, receberá dados inconsistentes.
+ O RDS para Db2 não replica os seguintes itens: 
  + Acesso ao armazenamento. Esteja ciente de dados, como tabelas externas, que dependem do acesso ao armazenamento.
  + LOBs que não são em linha e não registrados em log.
  + Binários de procedimentos armazenados externos (em C ou Java).
+ Para réplicas em espera, o RDS para Db2 replica os seguintes itens: 
  + Usuários locais, exceto usuários mestres
  + Parâmetros de configuração do banco de dados
+ Para réplicas somente leitura, o RDS para Db2 replica os seguintes itens:
  + Usuários locais, exceto usuários mestres
  + Mapeamentos do grupo de SID

## Considerações diversas sobre réplicas do RDS para Db2
<a name="db2-read-replicas.limitations.miscellaneous"></a>

Considerações operacionais adicionais se aplicam às réplicas do Db2. Analise os seguintes itens:
+ O RDS para Db2 replica as configurações do banco de dados para as réplicas. Quando o RDS para Db2 promove uma réplica, ele desativa e ativa cada banco de dados.
+ O RDS para Db2 replica os usuários locais, mas não o usuário mestre, e os mapeamentos do grupo SID nas réplicas. Você pode modificar o usuário mestre na réplica. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
+ Todos os bancos de dados devem estar em um estado ativo. Para obter informações sobre como ativar banco de dados, consulte [Procedimentos armazenados para bancos de dados do RDS para Db2](db2-sp-managing-databases.md).
+ Todos os procedimentos armazenados para criar, eliminar, restaurar ou avançar bancos de dados devem ser concluídos antes da criação de uma réplica. Para obter informações sobre esses procedimentos armazenados, consulte [Procedimentos armazenados para bancos de dados do RDS para Db2](db2-sp-managing-databases.md).
+ Quando a réplica é criada, o Amazon RDS define o parâmetro em nível de banco de dados `blocknonlogged` para todos os bancos de dados na instância de banco de dados de origem como `YES`. Quando a réplica de origem se torna novamente uma instância independente, o Amazon RDS redefine o valor para `NO`. Para obter mais informações, consulte [blocknonlogged - Block creation of tables that allow non-logged activity configuration parameter](https://www.ibm.com/docs/en/db2/11.1?topic=dcp-blocknonlogged-block-creation-tables-that-allow-non-logged-activity) na documentação do IBM Db2.
+ Quando a réplica é criada, o Amazon RDS define o parâmetro em nível de banco de dados `logindexbuild` para todos os bancos de dados na instância de banco de dados de origem como `YES`. Quando a réplica de origem se torna novamente uma instância independente, o Amazon RDS redefine o valor para `NO`. Para obter mais informações, consulte [logindexbuild - Log index pages created configuration parameter](https://www.ibm.com/docs/en/db2/11.1?topic=parameters-logindexbuild-log-index-pages-created) na documentação do IBM Db2.

# Preparar-se para criar uma réplica do RDS para Db2
<a name="db2-read-replicas.Configuration"></a>

Antes de criar uma réplica do RDS para Db2, você deve concluir as tarefas a seguir para uma replicação bem-sucedida. Estas tarefas ajudam a evitar problemas comuns e a garantir a performance ideal.

## Tarefa 1: habilitar backups automáticos
<a name="db2-read-replicas.configuration.autobackups"></a>

Antes que uma instância de banco de dados possa servir como uma instância de banco de dados de origem, você deve habilitar backups automáticos na instância de banco de dados de origem. Isso é um pré-requisito para todas as operações de criação de réplica. Para saber como executar esse procedimento, consulte [Ativar backups automáticos](USER_WorkingWithAutomatedBackups.Enabling.md).

Para acessar informações sobre backups específicos para réplicas do Db2, consulte [Como trabalhar com backups de réplicas do RDS para Db2](db2-read-replicas.backups.md).

## Tarefa 2: planejar recursos de computação e armazenamento
<a name="db2-read-replicas.configuration.planning-resources"></a>

Verifique se a instância de banco de dados de origem e suas réplicas estão dimensionadas corretamente, em termos de computação e armazenamento, para atender às suas cargas operacionais. Se uma réplica atingir a capacidade de recursos de computação, rede ou armazenamento, a réplica deixará de receber ou aplicar alterações de sua origem. Para acessar informações sobre o monitoramento da performance da réplica e da utilização de recursos, consulte [Monitoramento da replicação de leitura](USER_ReadRepl.Monitoring.md). 

O RDS para Db2 não intervém para atenuar atrasos altos de replicação entre uma instância de banco de dados de origem e suas réplicas. Se você tiver um alto atraso na réplica, consulte [Monitoramento de atraso da replicação do Db2](db2-troubleshooting-replicas.md#db2-troubleshooting-replicas-lag) para receber orientação sobre solução de problemas. 

É possível modificar os recursos de armazenamento e de CPU de uma réplica independentemente de sua origem e de outras réplicas. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).

## Tarefa 3: preparar bancos de dados
<a name="db2-read-replicas.configuration.activate-databases"></a>

Antes de criar uma réplica, confirme se seus bancos de dados estão prontos com base nos seguintes pontos:
+ A instância de banco de dados contém todos os bancos de dados que você deseja que estejam presentes na instância de banco de dados. Após a criação da réplica, você não pode criar, excluir ou restaurar nativamente um banco de dados na instância de banco de dados. Todas as chamadas para os procedimentos armazenados [rdsadmin.create\$1database](db2-sp-managing-databases.md#db2-sp-create-database), [rdsadmin.drop\$1database](db2-sp-managing-databases.md#db2-sp-drop-database) ou [rdsadmin.restore\$1database](db2-sp-managing-databases.md#db2-sp-restore-database) falham.
+ Todos os bancos de dados na instância de banco de dados estão em um estado ativo. Se algum banco de dados estiver em um estado inativo, a criação da réplica falhará. Para obter informações sobre como ativar banco de dados, consulte [Procedimentos armazenados para bancos de dados do RDS para Db2](db2-sp-managing-databases.md).

## Próximas etapas
<a name="db2-read-replicas-configuration-next-steps"></a>

Quando terminar de concluir todas as tarefas de preparação, você poderá criar uma réplica do Db2.
+ Para criar uma réplica somente leitura, consulte [Como criar uma réplica de leitura](USER_ReadRepl.Create.md).
+ Para criar uma réplica em espera, consulte [Criação de uma réplica do Db2 em espera](db2-read-replicas.creating-in-standby-mode.md).

# Criar uma réplica do RDS para Db2 no modo de espera
<a name="db2-read-replicas.creating-in-standby-mode"></a>

Por padrão, as réplicas do Db2 são criadas no modo somente leitura. É possível criar uma réplica no modo de espera para fins de recuperação de desastres. As réplicas em espera não aceitam conexões de usuários, mas fornecem recursos de failover mais rápidos para cenários entre regiões.

Antes de criar uma réplica em espera, garanta que você tenha cumprido as tarefas de preparação. Para obter mais informações, consulte [Preparar-se para criar uma réplica do RDS para Db2](db2-read-replicas.Configuration.md). Depois de criar uma réplica em espera, é possível modificar o modo da réplica. Para obter mais informações, consulte [Modificar o modo da réplica do RDS para Db2](db2-replicas-changing-replica-mode.md).

É possível criar uma réplica em modo de espera usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. Para acessar informações sobre como criar uma réplica somente leitura, consulte [Como criar uma réplica de leitura](USER_ReadRepl.Create.md).

## Console
<a name="db2-read-replicas.creating-in-standby-mode.console"></a>

**Para criar uma réplica em espera a partir de uma instância de banco de dados de origem do RDS para Db2**

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 painel de navegação, escolha **Bancos de dados**.

1. Escolha a instância de banco de dados do RDS para Db2 que você deseja usar como a origem da réplica em espera.

1. Em **Actions (Ações)**, escolha **Create replica (Criar réplica)**. 

1. Em **Replica mode** (Modo de réplica), escolha **Standby** (Em espera).

1. Escolha as configurações que deseja usar. Em **Identificador da instância de banco de dados**, insira um nome para a réplica em espera. Ajuste outras configurações, conforme necessário.

1. Em **Regions** (Regiões), escolha Região da AWS onde a réplica em espera será iniciada. 

1. Escolha o tamanho da instância e o tipo de armazenamento. Recomendamos que você use a classe de instância de banco de dados e o tipo de armazenamento iguais aos da instância de banco de dados de origem na réplica em espera.

1. Em **Multi-AZ deployment** (Implantação Multi-AZ), escolha **Create a standby instance** (Criar uma instância de espera) para criar uma versão de espera de sua réplica em outra zona de disponibilidade a fim de oferecer suporte de failover para a réplica em espera.

1. Escolha as outras configurações que deseja usar.

1. Escolha **Create replica (Criar réplica)**.

Na página **Databases** (Bancos de dados), a réplica em espera tem a função **Replica** (Réplica).

## AWS CLI
<a name="db2-read-replicas.creating-in-standby-mode.cli"></a>

Para criar uma réplica do Db2 no modo em espera, defina o comando [create-db-instance-read-replica](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance-read-replica.html) da AWS CLI com `--replica-mode` definido como `mounted`.

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

```
aws rds create-db-instance-read-replica \
    --db-instance-identifier my_standby_replica \
    --source-db-instance-identifier my_db_instance \
    --replica-mode mounted
```
Para Windows:  

```
aws rds create-db-instance-read-replica ^
    --db-instance-identifier my_standby_replica ^
    --source-db-instance-identifier my_db_instance ^
    --replica-mode mounted
```

## API do RDS
<a name="db2-read-replicas.creating-in-standby-mode.api"></a>

Para criar uma réplica do Db2 no modo em espera, especifique `ReplicaMode=mounted` na operação de API [CreateDBInstanceReadReplica](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstanceReadReplica.html) do RDS.

# Modificar o modo da réplica do RDS para Db2
<a name="db2-replicas-changing-replica-mode"></a>

Você pode alterar o modo da réplica do Db2 existente entre os modos somente leitura e em espera. Essa flexibilidade permite que você adapte sua configuração de réplica com base nas mudanças nos requisitos de workloads de leitura ou nas necessidades de recuperação de desastres. 

Convém alterar os modos da réplica em um dos seguintes cenários:
+ **De somente leitura para em espera**: quando você não precisa mais da capacidade de leitura, mas quer manter os recursos de recuperação de desastres
+ **De em espera para somente leitura**: quando você precisa adicionar capacidade de leitura para workloads de relatórios ou analytics.

Antes de alterar os modos da réplica, garanta que as seguintes condições sejam atendidas:
+ A réplica está em um estado disponível.
+ Nenhuma operação de manutenção ativa está sendo executada na réplica.
+ Você tem as permissões necessárias para modificar a instância de banco de dados.

A operação de alteração pode levar alguns minutos. Durante a operação, o status da instância de banco de dados muda para **modifying (modificando)**. Para obter mais informações sobre alterações de status, consulte [Visualizar o status de uma instância de banco de dados do Amazon RDS](accessing-monitoring.md#Overview.DBInstance.Status). Quando você altera do modo somente leitura para o modo em espera, a réplica desconecta todas as conexões ativas. 

**Importante**  
Como a alteração dos modos de réplica interrompe temporariamente o serviço, planeje a alteração durante uma janela de manutenção a fim de minimizar o impacto em suas aplicações.

Você pode modificar o modo de uma réplica usando o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS.

## Console
<a name="db2-replicas-changing-replica-mode-console"></a>

**Como alterar o modo de uma réplica do Db2**

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 painel de navegação, escolha **Bancos de dados**.

1. Escolha o banco de dados de réplica que você deseja modificar.

1. Escolha **Modificar**.

1. Em **Modo de réplica**, escolha o modo desejado:
   + **Somente leitura**: para workloads de leitura
   + **Em espera**: para recuperação de desastres

1. Escolha as outras configurações que deseja alterar.

1. Escolha **Continue**.

1. Em **Scheduling of modifications (Programação de modificações)**, selecione **Apply immediately (Aplicar imediatamente)**.

1. Selecione **Modify DB instance (Modificar instância de banco de dados)**.

1. Depois que a modificação for concluída, verifique a alteração do modo de réplica na página **Bancos de dados**. O status da réplica deverá ser exibido como **Disponível** quando a alteração for concluída.

## AWS CLI
<a name="db2-replicas-changing-replica-mode-cli"></a>

Para alterar uma réplica do Db2 do modo somente leitura para o modo em espera, defina `--replica-mode` como `mounted` no comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da AWS CLI. Para alterar uma réplica do Db2 do modo em espera para o modo somente leitura, defina `--replica-mode` como `open-read-only`.

O exemplo a seguir altera uma réplica do modo somente leitura para o modo em espera:

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

```
aws rds modify-db-instance \
    --db-instance-identifier my_db2_replica \
    --replica-mode mounted
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier my_db2_replica ^
    --replica-mode mounted
```

O exemplo a seguir altera uma réplica do modo em espera para o modo somente leitura:

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

```
aws rds modify-db-instance \
    --db-instance-identifier my_db2_replica \
    --replica-mode open-read-only
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier my_db2_replica ^
    --replica-mode open-read-only
```

## API do RDS
<a name="db2-replicas-changing-replica-mode-api"></a>

Para alterar uma réplica do Db2 do modo somente leitura para o modo em espera, defina `ReplicaMode=mounted` em [ModifyDBInstance](AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Para alterar uma réplica do Db2 do modo em espera para o modo somente leitura, defina `ReplicaMode=open-read-only`.

O seguinte exemplo é de uma chamada de API para alterar o modo da réplica de somente leitura para em espera:

```
{
    "DBInstanceIdentifier": "my_db2_replica",
    "ReplicaMode": "mounted",
    "ApplyImmediately": true
}
```

O seguinte exemplo é de uma chamada de API para alterar o modo da réplica de em espera para somente leitura:

```
{
    "DBInstanceIdentifier": "my_db2_replica",
    "ReplicaMode": "open-read-only",
    "ApplyImmediately": true
}
```

Para acessar informações sobre as diferenças entre modos de réplica, consulte [Trabalhar com réplicas para o Amazon RDS para Db2](db2-replication.md). Para solucionar problemas de réplica, consulte [Solução de problemas de replicação do RDS para Db2](db2-troubleshooting-replicas.md).

# Como trabalhar com backups de réplicas do RDS para Db2
<a name="db2-read-replicas.backups"></a>

Você pode criar e restaurar backups de uma réplica do RDS para Db2 assim como um banco de dados primário. No entanto, existem diferenças importantes na forma como os backups de réplica funcionam, principalmente em relação ao horário de restauração e às configurações de retenção de backup.

O RDS para Db2 aceita tanto backups automáticos quanto snapshots manuais para réplicas. O RDS para Db2 não permite restauração pontual. Para acessar informações sobre backups do RDS, consulte [Backup, restauração e exportação de dados](CHAP_CommonTasks.BackupRestore.md). 

## Principais diferenças entre backups de réplicas
<a name="db2-read-replicas-backups-overview"></a>

Os backups de réplica diferem dos backups do banco de dados primário de várias maneiras importantes:
+ Os backups automáticos não estão habilitados por padrão para réplicas.
+ As operações de restauração usam a hora do banco de dados em vez da hora de criação do backup.
+ O atraso na réplica pode afetar os dados reais restaurados. Para acessar informações sobre o monitoramento do atraso da réplica, consulte [Monitoramento de atraso da replicação do Db2](db2-troubleshooting-replicas.md#db2-troubleshooting-replicas-lag).

## Habilitar backups automáticos para réplicas do RDS para Db2
<a name="db2-read-replicas.backups.turning-on"></a>

Ao contrário dos bancos de dados primários, réplicas do RDS para Db2 não têm o recurso de backups automatizados habilitado por padrão. Você deve configurar manualmente o período de retenção de backup para habilitar backups automáticos. Habilite backups automatizados configurando o período de retenção de backup como um valor positivo diferente de zero.

### Console
<a name="db2-read-replicas.backups.turning-on-console"></a>

**Como habilitar imediatamente backups automáticos**

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 painel de navegação, escolha **Databases (Bancos de dados)** e a instância de banco de dados que você deseja modificar.

1. Selecione **Modify**.

1. Em **Backup Retention Period** (Período de retenção de backup), escolha um valor positivo diferente de zero; por exemplo, 3 dias.

1. Escolha **Continue**.

1. Escolha **Apply immediately (Aplicar imediatamente)**.

1. Escolha **Modify DB Instance** (Modificar instância de banco de dados) para salvar as alterações e ativar os backups automatizados.

### AWS CLI
<a name="db2-read-replicas.backups.turning-on-cli"></a>

Para habilitar os backups automatizados, use o comando AWS CLI[modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html).

Inclua os seguintes parâmetros:
+ `--db-instance-identifier`
+ `--backup-retention-period`
+ `--apply-immediately` ou `--no-apply-immediately`

O exemplo a seguir habilita backups automatizados definindo o período de retenção de backup como três dias. As alterações são aplicadas imediatamente.

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

```
aws rds modify-db-instance \
    --db-instance-identifier my_db_instance  \
    --backup-retention-period 3 \
    --apply-immediately
```
Para Windows:  

```
aws rds modify-db-instance ^
    --db-instance-identifier my_db_instance  ^
    --backup-retention-period 3 ^
    --apply-immediately
```

### API do RDS
<a name="db2-read-replicas.backups.turning-on-api"></a>

Para habilitar backups automatizados, use a operação [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) da API do RDS com os seguintes parâmetros obrigatórios:
+ `DBInstanceIdentifier`
+ `BackupRetentionPeriod`

## Restaurar um backup de réplica do RDS para Db2
<a name="db2-read-replicas.backups.restoring"></a>

Você pode restaurar um backup de réplica do RDS para Db2 da mesma forma que pode restaurar um backup do banco de dados primário. Para obter mais informações, consulte [Restaurar uma instância de banco de dados](USER_RestoreFromSnapshot.md).

A consideração mais importante ao restaurar backups de réplicas é entender a diferença entre hora do banco de dados e hora da criação do backup, principalmente quando há atraso na réplica.

Você pode monitorar o atraso na replicação e garantir que seus backups contenham os dados esperados. Para acessar informações sobre a métrica ReplicaLag, consulte [Métricas do Amazon CloudWatch para o Amazon RDS](rds-metrics.md).

### Noções básicas sobre diferenças de horário
<a name="db2-read-replicas-backups-restoring-timing"></a>

Quando você restaura o backup de uma réplica, deve determinar o momento para o qual está restaurando. A hora do banco de dados se refere ao horário de transação mais recente aplicado dos dados no backup. Ao restaurar um backup de réplica, você restaura para a hora do banco de dados, não para a hora em que o backup foi concluído. A diferença é significativa porque uma réplica pode apresentar atraso de minutos ou horas em relação ao banco de dados primário. Portanto, a hora do banco de dados de um backup de réplica pode ser muito antes do horário de criação do snapshot.

Para encontrar a diferença entre a hora do banco de dados e o horário de criação, execute o comando AWS CLI[describe-db-snapshots](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-snapshots.html) ou chame a operação [DescribeDBSnapshots](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshots.html) da API do RDS. Compare o valor `SnapshotDatabaseTime` e o valor `OriginalSnapshotCreateTime`. O valor `SnapshotDatabaseTime` é o horário mais antigo do banco de dados entre todos os bancos de dados do backup da réplica. O valor `OriginalSnapshotCreateTime` é a última transação aplicada no banco de dados primário. Observe que os atrasos de replicação podem ser diferentes para vários bancos de dados, e o tempo do banco de dados pode estar entre esses dois tempos. 

O exemplo AWS CLI a seguir mostra a diferença entre as duas horas:

Para Linux, macOS ou Unix:

```
aws rds describe-db-snapshots \
    --db-instance-identifier my_db2_replica \
    --db-snapshot-identifier my_replica_snapshot
```

Para Windows:

```
aws rds describe-db-snapshots ^
    --db-instance-identifier my_db2_replica ^
    --db-snapshot-identifier my_replica_snapshot
```

O comando vai produzir uma saída semelhante ao exemplo a seguir. 

```
{
    "DBSnapshots": [
        {
            "DBSnapshotIdentifier": "my_replica_snapshot",
            "DBInstanceIdentifier": "my_db2_replica", 
            "SnapshotDatabaseTime": "2022-07-26T17:49:44Z",
            ...
            "OriginalSnapshotCreateTime": "2021-07-26T19:49:44Z"
        }
    ]
}
```

# Solução de problemas de replicação do RDS para Db2
<a name="db2-troubleshooting-replicas"></a>

Este tópico descreve problemas comuns de replicação do RDS para Db2 e fornece orientação para solução de problemas tanto para réplicas somente leitura quanto para réplicas em espera. Além de analisar as informações de solução de problemas a seguir, siga os [requisitos e as considerações](db2-read-replicas.limitations.md) e conclua as [etapas de preparação](db2-read-replicas.Configuration.md) antes de criar réplicas do Db2.

## Falha na criação da réplica
<a name="db2-troubleshooting-replicas-creation"></a>



A criação da réplica pode falhar por vários motivos:
+ **Bancos de dados inativos**: todos os bancos de dados na instância de banco de dados de origem devem estar ativos antes de criar réplicas. 

  Para obter informações sobre como ativar banco de dados, consulte [Procedimentos armazenados para bancos de dados do RDS para Db2](db2-sp-managing-databases.md).
+ **Backups automáticos ausentes**: a instância de banco de dados de origem deve ter os backups automáticos habilitados. 

  Para acessar informações sobre como habilitar backups, consulte [Habilitar backups automáticos para réplicas do RDS para Db2](db2-read-replicas.backups.md#db2-read-replicas.backups.turning-on).
+ **Problemas com grupos de parâmetros**: grupos de parâmetros personalizados são necessários para réplicas. Para licenciamento BYOL, o grupo de parâmetros deve incluir o IBM Site ID e o IBM Customer ID. 

  Para obter mais informações, consulte [IDs da IBM para traga a sua própria licença (BYOL) para o Db2](db2-licensing.md#db2-prereqs-ibm-info).

## Monitoramento de atraso da replicação do Db2
<a name="db2-troubleshooting-replicas-lag"></a>

Para monitorar o atraso de replicação no Amazon CloudWatch, visualize a métrica `ReplicaLag` do Amazon RDS. Para obter informações sobre o tempo de atraso de replicação, consulte [Monitoramento da replicação de leitura](USER_ReadRepl.Monitoring.md) e [Métricas do Amazon CloudWatch para o Amazon RDS](rds-metrics.md). Para acessar informações sobre como configurar alarmes do CloudWatch para atraso de réplica, consulte [Monitorar métricas do Amazon RDS com o Amazon CloudWatch](monitoring-cloudwatch.md). 

Para uma réplica somente leitura, se o tempo de atraso for muito longo, consulte a tabela `MON_GET_HADR` para saber o status da instância de banco de dados de réplica. 

Para uma réplica em espera, se o tempo de atraso for muito longo, consulte a tabela `MON_GET_HADR` para saber o status da instância de banco de dados de origem. Não consulte a instância de banco de dados de réplica porque as instâncias de banco de dados de réplica não aceitam conexões de usuário.

As causas comuns do alto atraso na replicação incluem os seguintes motivos:
+ Recursos computacionais insuficientes na réplica.
+ Problemas de conectividade de rede entre a origem e a réplica.
+ Alta atividade de gravação no banco de dados de origem.
+ Limitações de performance de armazenamento na réplica.

Se o alto atraso da replicação persistir, pense em escalar seus recursos de réplica. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).

## erros de replicação no Db2
<a name="db2-troubleshooting-replicas-triggers"></a>

A replicação do Db2 pode estar em estado de erro por vários motivos. Execute as seguintes ações:
+ Monitore eventos e o estado da instância de banco de dados para garantir que a instância de banco de dados esteja replicando. 

  Para obter mais informações, consulte [Trabalhar com a notificação de eventos do Amazon RDS](USER_Events.md).
+ Confira os logs de diagnóstico da réplica do Db2 no console do Amazon RDS. Nos logs, procure erros nas mensagens do HADR. Compare o número da sequência de log com o número de sequência principal. 

  Para acessar informações sobre como acessar e interpretar os logs de diagnóstico do Db2, consulte [Arquivos de log do banco de dados do Amazon RDS para Db2](USER_LogAccess.Concepts.Db2.md). Para acessar informações sobre configuração e solução de problemas do Db2 HADR, consulte [Trabalhar com réplicas para o Amazon RDS para Db2](db2-replication.md). 

Se os erros de replicação persistirem, talvez seja necessário recriar a réplica. 

## Problemas de conectividade
<a name="db2-troubleshooting-replicas-connections"></a>

Se você não conseguir se conectar à sua réplica, analise as seguintes informações sobre os modos de réplica:
+ **Réplicas em espera**: elas normalmente não aceitam conexões de usuários. Use réplicas somente leitura para workloads de leitura.
+ **Réplicas somente leitura**: confira suas configurações de grupo de segurança, ACLs de rede e configurações de grupos de parâmetros. 

  Para acessar mais informações, consulte [Controle o tráfego para seus recursos da AWS usando grupos de segurança](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-security-groups.html) no *Guia do usuário da Amazon VPC*, [Controlar o tráfego da sub-rede com listas de controle de acesso à rede](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-network-acls.html) no *Guia do usuário da Amazon VPC* e [Grupos de parâmetros para Amazon RDS](USER_WorkingWithParamGroups.md).

## Problemas de performance
<a name="db2-troubleshooting-replicas-performance"></a>

Se a performance da réplica for inadequada, analise as seguintes sugestões:
+ Garanta que a réplica tenha recursos de computação e armazenamento adequados. 
+ Monitore a métrica `ReplicaLag` no Amazon CloudWatch. 
+ Pense em aumentar a escala verticalmente da classe de instância de banco de dados da réplica. 

Para acessar informações sobre como modificar recursos ou classes de instância, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).

Para acessar informações sobre o monitoramento do atraso da réplica, consulte [Monitorar atraso da replicação](USER_ReadRepl.Monitoring.md#USER_ReadRepl.Monitoring.Lag) e [Métricas do Amazon CloudWatch para o Amazon RDS](rds-metrics.md). Para acessar informações sobre como configurar alarmes do CloudWatch para atraso de réplica, consulte [Monitorar métricas do Amazon RDS com o Amazon CloudWatch](monitoring-cloudwatch.md). 