# Como atualizar para um snapshot de banco de dados Oracle
<a name="USER_UpgradeDBSnapshot.Oracle"></a>

A atualização dos snapshots de banco de dados do Oracle no Amazon RDS garante que o banco de dados permaneça seguro e totalmente suportado. À medida que as versões mais antigas do Oracle chegarem ao fim do suporte de patches, você poderá atualizar qualquer snapshot de banco de dados manual vinculado a essas versões para evitar possíveis vulnerabilidades ou limitações de serviço. Para obter mais informações, consulte [Oracle Engine Version Management](USER_UpgradeDBInstance.Oracle.Overview.md#Oracle.Concepts.Patching).

O Amazon RDS comporta a atualização de snapshots em todas as Regiões da AWS.

## Console
<a name="USER_UpgradeDBSnapshot.Oracle.Console"></a>

**Para atualizar para um snapshot de banco de dados Oracle**

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 **Snapshots** e selecione o snapshot de banco de dados que você deseja atualizar.

1. Em **Actions (Ações)**, selecione **Upgrade snapshot (Atualizar snapshot)**. A página **Upgrade snapshot (Atualizar snapshot)** é exibida.

1. Escolha a **New engine version (Nova versão do mecanismo)** para a qual o snapshot será atualizado.

1. (Opcional) Em **Option group (Grupo de opções)**, escolha o grupo de opções para o snapshot de banco de dados atualizado. As mesmas considerações de grupo de opções se aplicam ao atualizar um snapshot de banco de dados e uma instância de banco de dados. Para obter mais informações, consulte [Considerações de grupos de opções](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG). 

1. Escolha **Save changes (Salvar alterações)** para salvar suas alterações.

   Durante o processo de atualização, todas as ações do snapshot serão desabilitadas para esse snapshot de banco de dados. Além disso, o status do snapshot de banco de dados muda de **available (disponível)** para **upgrading (atualizando)** e muda para **active (ativo)** após a conclusão. Se não for possível atualizar o snapshot de banco de dados devido a problemas de corrupção do snapshot, o status mudará para **unavailable (indisponível)**. Não é possível recuperar o snapshot desse estado. 
**nota**  
Se a atualização do snapshot de banco de dados falhar, o snapshot será revertido para o estado original com a versão original.

## AWS CLI
<a name="USER_UpgradeDBSnapshot.Oracle.CLI"></a>

Para atualizar um snapshot de banco de dados Oracle usando a AWS CLI, chame o comando [modify-db-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-snapshot.html) com os seguintes parâmetros: 
+ `--db-snapshot-identifier` – o nome do snapshot de banco de dados. 
+ `--engine-version` – a versão de atualização do snapshot. 

Talvez também seja necessário incluir o parâmetro a seguir. As mesmas considerações de grupo de opções se aplicam ao atualizar um snapshot de banco de dados e uma instância de banco de dados. Para obter mais informações, consulte [Considerações de grupos de opções](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG). 
+ `--option-group-name` – o grupo de opções para o snapshot de banco de dados atualizado. 

**Example**  
O exemplo a seguir atualiza um snapshot de banco de dados.   
Para Linux, macOS ou Unix:  

```
aws rds modify-db-snapshot \
    --db-snapshot-identifier mydbsnapshot \
    --engine-version 19.0.0.0.ru-2020-10.rur-2020-10.r1 \
    --option-group-name default:oracle-se2-19
```
Para Windows:  

```
aws rds modify-db-snapshot ^
    --db-snapshot-identifier mydbsnapshot ^
    --engine-version 19.0.0.0.ru-2020-10.rur-2020-10.r1 ^
    --option-group-name default:oracle-se2-19
```

## API do RDS
<a name="USER_UpgradeDBSnapshot.Oracle.API"></a>

Para atualizar um snapshot de banco de dados Oracle usando a API do Amazon RDS, chame a operação [ModifyDBSnapshot](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBSnapshot.html) com os seguintes parâmetros: 
+ `DBSnapshotIdentifier` – o nome do snapshot de banco de dados. 
+ `EngineVersion` – a versão de atualização do snapshot. 

Você também pode precisar incluir o parâmetro `OptionGroupName`. As mesmas considerações de grupo de opções se aplicam ao atualizar um snapshot de banco de dados e uma instância de banco de dados. Para obter mais informações, consulte [Considerações de grupos de opções](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG).