# Fazer upgrade do mecanismo de banco de dados RDS para Oracle
Quando o Amazon RDS oferece suporte a uma nova versão do Oracle Database, você pode fazer upgrade de suas instâncias de banco de dados para essa nova versão. Para obter informações sobre quais versões do Oracle estão disponíveis no Amazon RDS, consulte [https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/Welcome.html](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/Welcome.html).
**Importante**
Os bancos de dados RDS para Oracle 11g, 12c e 18c não são mais compatíveis. Se você mantiver snapshots do Oracle Database 11g, 12c ou 18v, poderá atualizá-los para uma versão posterior. Para ter mais informações, consulte [Como atualizar para um snapshot de banco de dados Oracle](USER_UpgradeDBSnapshot.Oracle.md).
**Topics**
+ [Visão geral das atualizações do mecanismo RDS para Oracle](USER_UpgradeDBInstance.Oracle.Overview.md)
+ [Atualizações da versão principal do Oracle](USER_UpgradeDBInstance.Oracle.Major.md)
+ [Atualizações de versões secundárias Oracle](USER_UpgradeDBInstance.Oracle.Minor.md)
+ [Considerações sobre atualizações de bancos de dados Oracle](USER_UpgradeDBInstance.Oracle.OGPG.md)
+ [Testar uma atualização do Oracle DB](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md)
+ [Atualizar a versão de uma instância de banco de dados do RDS para Oracle](USER_UpgradeDBInstance.Oracle.Upgrading.md)
+ [Como atualizar para um snapshot de banco de dados Oracle](USER_UpgradeDBSnapshot.Oracle.md)
# Visão geral das atualizações do mecanismo RDS para Oracle
Antes de atualizar sua instância de banco de dados do RDS para Oracle, familiarize-se com os seguintes conceitos.
**Topics**
+ [Upgrades de versões principais e secundárias](#USER_UpgradeDBInstance.Oracle.Overview.versions)
+ [Datas de suporte e atualizações obrigatórias referentes ao RDS para Oracle](#Aurora.VersionPolicy.MajorVersionLifetime)
+ [Oracle Engine Version Management](#Oracle.Concepts.Patching)
+ [Instantâneos automáticos durante atualizações do mecanismo](#USER_UpgradeDBInstance.Oracle.Overview.snapshots)
+ [Atualizações do Oracle em uma implantação Multi-AZ](#USER_UpgradeDBInstance.Oracle.Overview.multi-az)
+ [Atualizações do Oracle de réplicas de leitura](#USER_UpgradeDBInstance.Oracle.Overview.read-replicas)
## Upgrades de versões principais e secundárias
As versões principais são os principais lançamentos do Oracle Database que ocorrem a cada 1–2 anos. O Oracle Database 19c e o Oracle Database 21c são exemplos de versões principais.
A cada trimestre, o RDS para Oracle lança novas versões secundárias de mecanismos para cada mecanismo principal compatível. Uma atualização de versão (RU) do mecanismo incorpora correções de bugs da Oracle incluindo os patches de RU referentes ao trimestre especificado. Por exemplo, 21.0.0.0.ru-2024-10.rur-2024-10.r1 é uma versão secundária do Oracle Database 21c que incorpora a RU de outubro de 2024.
Uma versão do mecanismo do pacote de patches espaciais (SPB) contém patches de RU e patches específicos para o Oracle Spatial. Por exemplo, 19.0.0.0.ru-2025-01.spb-1.r1 é uma versão secundária do mecanismo que contém os patches de RU na versão do mecanismo 19.0.0.0.ru-2025-01.rur-2025-01.r1 e patches do Spatial. Normalmente, o RDS para Oracle lança SPBs duas a três semanas após a RU correspondente. Para obter uma explicação sobre as diferenças entre RUs e SPBs, consulte [Atualizações de versão (RUs) e pacotes de patches espaciais (SPBs)](USER_UpgradeDBInstance.Oracle.Minor.md#RUs-and-SPBs). Para ter mais informações, consulte [Release notes for Amazon Relational Database Service (Amazon RDS) for Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes).
O RDS para Oracle oferece suporte aos seguintes upgrades para uma instância de banco de dados.
| Tipo de upgrade | Compatibilidade de aplicações | Métodos de upgrade | Exemplo de caminho de upgrade |
| --- | --- | --- | --- |
| Versão principal | Um upgrade de versão principal pode apresentar alterações não compatíveis com aplicações existentes. | Somente manual | Do Oracle Database 19c para o Oracle Database 21c |
| Versão secundária | Uma atualização da versão secundária inclui apenas alterações compatíveis com versões anteriores dos aplicativos existentes. | Automático ou manual | De 21.0.0.0.ru-2023-07.rur-2022-07.r1 para 21.0.0.0.ru-2023-10.rur-2022-10.r1 |
**Importante**
Quando você atualiza o mecanismo de banco de dados, ocorre uma interrupção. A duração da interrupção depende da versão do mecanismo e do tamanho da instância de banco de dados.
Teste completamente qualquer atualização para verificar se as aplicações funcionam corretamente antes de aplicá-la aos bancos de dados de produção. Para obter mais informações, consulte [Testar uma atualização do Oracle DB](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md).
## Datas de suporte e atualizações obrigatórias referentes ao RDS para Oracle
As versões de banco de dados do RDS para Oracle têm datas de suporte previstas. Quando uma versão principal ou secundária de um mecanismo de banco de dados do RDS para Oracle se aproxima da data de fim do suporte, o RDS inicia as atualizações obrigatórias, também conhecidas como *atualizações forçadas*. O RDS publica as seguintes informações:
+ Uma recomendação para você começar a atualizar manualmente as instâncias em versões obsoletas para versões compatíveis.
+ Uma data após a qual não é possível mais criar instâncias nas versões não compatíveis.
+ Uma data em que o RDS começa a atualizar automaticamente as instâncias para versões compatíveis durante as janelas de manutenção.
+ Uma data em que o RDS começa a atualizar automaticamente as instâncias para versões compatíveis fora das janelas de manutenção.
**Importante**
As atualizações forçadas podem gerar consequências inesperadas para as pilhas do CloudFormation. Caso dependa do RDS para atualizar suas instâncias de banco de dados automaticamente, você poderá encontrar problemas com o CloudFormation.
Esta seção contém os seguintes tópicos:
**Topics**
+ [Datas de suporte para versões principais do RDS para Oracle](#oracle-major-support-dates)
+ [Datas de suporte para versões secundárias do RDS para Oracle](#oracle-minor-support-dates)
### Datas de suporte para versões principais do RDS para Oracle
As versões principais do RDS para Oracle continuam disponíveis pelo menos até a data de fim do suporte para a versão correspondente do Oracle Database. É possível usar as seguintes datas para planejar seus ciclos de teste e atualização. Essas datas representam a data mais antiga em que uma atualização para uma versão mais recente pode ser necessária. Se a Amazon estender o suporte para uma versão do RDS para Oracle por mais tempo do que o planejado originalmente, planejamos atualizar essa tabela para refletir a data posterior.
**nota**
Você pode visualizar as versões principais dos bancos de dados Oracle executando o comando [describe-db-major-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-major-engine-versions.html) AWS CLI ou usando a operação de API [DescribeDBMajorEngineVersions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBMajorEngineVersions.html) do RDS.
| Versão principal do Oracle Database | Data esperada para atualização para uma versão mais recente |
| --- | --- |
| Oracle Database 19c | 31 de dezembro de 2029 com o BYOL Premier Support (isenção de taxas para suporte estendido) 31 de dezembro de 2032 com suporte estendido BYOL (custo adicional) ou um contrato de licença ilimitada 31 de dezembro de 2029 com Licença Incluída (LI) |
| Oracle Database 21c | 31 de julho de 2027 (não disponível para Suporte estendido) |
O RDS enviará uma notificação pelo menos 12 meses antes de você precisar atualizar para uma versão principal mais recente. A notificação descreve o processo de atualização, como o momento de marcos importantes, o impacto nas instâncias de banco de dados e as ações recomendadas. Recomendamos que você teste detalhadamente suas aplicações com as novas versões do RDS para Oracle antes de atualizar seu banco de dados para uma versão principal.
Depois desse período de notificação prévia, um upgrade automático para a versão principal subsequente poderá ser aplicado a qualquer instância de banco de dados que ainda estiver executando a versão mais antiga. Nesse caso, a atualização é iniciada durante as janelas de manutenção agendada.
Para ter mais informações, consulte [ Release Schedule of Current Database Releases](https://support.oracle.com/knowledge/Oracle%20Database%20Products/742060_1.html) no My Oracle Support.
### Datas de suporte para versões secundárias do RDS para Oracle
Em alguns casos, encerramos o suporte para versões secundárias das versões principais do RDS para Oracle. O RDS enviará uma notificação pelo menos 6 meses antes de você precisar atualizar para uma versão secundária mais recente. A notificação descreve o processo de atualização, como o momento de marcos importantes, o impacto nas instâncias de banco de dados que executam a versão secundária obsoleta e as ações recomendadas. Recomendamos que você teste detalhadamente suas aplicações com as novas versões do RDS para Oracle antes de atualizar seu banco de dados para uma nova versão secundária.
Para acessar mais informações sobre versões secundárias obsoletas e não aceitas, consulte [Notas de versão do Amazon Relational Database Service (Amazon RDS) para Oracle](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/Welcome.html).
## Oracle Engine Version Management
Com o gerenciamento de versão do mecanismo de banco de dados, você controla quando e como o mecanismo é corrigido e atualizado. Com esse recurso, você obtém flexibilidade para manter a compatibilidade com versões de patch do mecanismo de banco de dados. Também é possível testar novas versões de patch do RDS para Oracle para garantir que elas funcionem de forma eficiente com a aplicação antes de implantá-las na produção. Além disso, você atualiza as versões em seus próprios prazos e cronogramas.
**nota**
O Amazon RDS agrega periodicamente os patches oficiais de bancos de dados Oracle usando uma versão do mecanismo de banco de dados específica do Amazon RDS. Para ver uma lista de quais patches do Oracle estão contidos em uma versão de mecanismo específica do Oracle do Amazon RDS, acesse [https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/Welcome.html](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/Welcome.html).
## Instantâneos automáticos durante atualizações do mecanismo
Quando você atualiza uma instância de banco de dados Oracle, os snapshots oferecem proteção contra problemas de atualização. Se o período de retenção de backup da instância de banco de dados for maior que 0, o Amazon RDS os seguintes snapshots de banco de dados serão realizados durante a atualização:
1. Um snapshot da instância de banco de dados antes de qualquer alteração de atualização ter sido feita. Se o upgrade falhar, você poderá restaurar esse snapshot para criar uma instância de banco de dados executando a versão antiga.
1. Um snapshot da instância de banco de dados após a conclusão da atualização.
**nota**
Para alterar o período de retenção de backup, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md).
Após uma atualização, você não pode reverter para a versão anterior do mecanismo. No entanto, você pode criar uma nova instância de banco de dados Oracle restaurando o snapshot pré-atualização.
## Atualizações do Oracle em uma implantação Multi-AZ
Se a instância de banco de dados estiver em uma implantação Multi-AZ, o Amazon RDS atualizará as réplicas primária e em espera. Se nenhuma atualização do sistema operacional for necessária, as atualizações primária e em espera ocorrerão simultaneamente. As instâncias não estarão disponíveis até que a atualização seja concluída.
Se forem necessárias atualizações do sistema operacional em uma implantação multi-AZ, o Amazon RDS aplicará as atualizações quando você solicitar o upgrade do banco de dados. O Amazon RDS executa as seguintes etapas:
1. Atualiza o sistema operacional na instância de banco de dados atual em espera.
1. Executa failover na instância de banco de dados principal para a instância de banco de dados em espera.
1. Faz upgrade da versão do banco de dados na nova instância de banco de dados primária, que anteriormente era a instância em espera. O banco de dados primário fica indisponível durante a migração.
1. Atualiza o sistema operacional na nova instância de banco de dados em espera, que anteriormente era a instância de banco de dados principal.
1. Atualiza a versão do banco de dados na nova instância de banco de dados em espera.
1. Faz failover da nova instância de banco de dados primária de volta para a instância de banco de dados primária original e a nova instância de banco de dados em espera volta para a instância de banco de dados em espera original. Assim, o Amazon RDS retorna a configuração de replicação ao seu estado original.
## Atualizações do Oracle de réplicas de leitura
A versão do mecanismo de banco de dados Oracle da instância de banco de dados de origem e todas as réplicas de leitura devem ser iguais. O Amazon RDS executa a atualização nos seguintes estágios:
1. Atualiza a instância de banco de dados de origem. As réplicas de leitura estão disponíveis durante esse estágio.
1. Atualiza as réplicas de leitura em paralelo, independentemente das janelas de manutenção de réplicas. O banco de dados de origem está disponível durante esse estágio.
Para atualizações da versão principal de réplicas de leitura entre regiões, o Amazon RDS executa ações adicionais:
+ Gera um grupo de opções para a versão de destino automaticamente
+ Copia todas as opções e as configurações de opção do grupo de opções original para o novo grupo de opções
+ Associa a réplica de leitura entre regiões atualizada ao novo grupo de opções
# Atualizações da versão principal do Oracle
Para realizar uma atualização de versão principal, modifique manualmente a instância de banco de dados. As atualizações de versões principais não ocorrem automaticamente.
**Importante**
Teste completamente qualquer atualização para verificar se as aplicações funcionam corretamente antes de aplicá-la aos bancos de dados de produção. Para obter mais informações, consulte [Testar uma atualização do Oracle DB](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md).
**Topics**
+ [Versões compatíveis com atualizações principais](#USER_UpgradeDBInstance.Oracle.Major.supported-versions)
+ [Classes de instância compatíveis com atualizações principais](#USER_UpgradeDBInstance.Oracle.Major.instance-classes)
+ [Coletar estatísticas antes de atualizações principais](#USER_UpgradeDBInstance.Oracle.Major.gathering-stats)
+ [Permitir atualizações principais](#USER_UpgradeDBInstance.Oracle.Major.allowing-upgrades)
## Versões compatíveis com atualizações principais
O Amazon RDS oferece suporte às atualizações da versão principal a seguir.
****
| Versão atual | Atualização compatível |
| --- | --- |
| 19.0.0.0 usando a arquitetura CDB | 21.0.0.0 |
Uma atualização de versão principal do banco de dados Oracle deve atualizar para uma Release Update (RU) que foi lançada no mesmo mês ou posterior. Downgrades da versão principal não são compatíveis com nenhuma versão do Oracle Database.
## Classes de instância compatíveis com atualizações principais
A instância de banco de dados Oracle pode ser executada em uma classe da instância de banco de dados não compatível com a versão para a qual você está atualizando. Nesse caso, migre a instância de banco de dados para uma classe de instância de banco de dados compatível antes da atualização. Para obter mais informações sobre as classes de instância de banco de dados compatíveis de cada versão e edição do Amazon RDS for Oracle, consulte [Classes de instâncias de banco de dados do ](Concepts.DBInstanceClass.md).
## Coletar estatísticas antes de atualizações principais
Para realizar uma atualização de versão principal, a Oracle recomenda coletar estatísticas do otimizador sobre a instância de banco de dados que você está atualizando. Essa ação pode reduzir o tempo de inatividade da instância de banco de dados durante a atualização.
Para coletar estatísticas do otimizador, conecte-se à instância de banco de dados como o usuário mestre e execute o procedimento `DBMS_STATS.GATHER_DICTIONARY_STATS`, como no exemplo a seguir.
```
EXEC DBMS_STATS.GATHER_DICTIONARY_STATS;
```
Consulte mais informações em [GATHER\$1DICTIONARY\$1STATS Procedure](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_STATS.html?source=%3Aso%3Atw%3Aor%3Aawr%3Aodv%3A%3A#GUID-867989C7-ADFC-4464-8981-437CEA7F331E) na documentação da Oracle.
## Permitir atualizações principais
Uma atualização de versão principal do mecanismo pode ser incompatível com seu aplicativo. A atualização é irreversível. Se você especificar uma versão principal para o parâmetro EngineVersion diferente da versão principal atual, deverá permitir atualizações de versão principais.
Se atualizar uma versão principal usando o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da CLI, especifique `--allow-major-version-upgrade`. Essa configuração não é persistente, portanto, você deve especificar `--allow-major-version-upgrade` sempre que executar uma atualização principal. Este parâmetro não afeta as atualizações de versões secundárias do mecanismo. Para obter mais informações, consulte [Atualizar a versão de mecanismo de uma instância de banco de dados ](USER_UpgradeDBInstance.Upgrading.md).
Se você atualizar uma versão principal usando o console, não será necessário escolher uma opção para permitir a atualização. Em vez disso, o console exibe um aviso de que as atualizações principais são irreversíveis.
# Atualizações de versões secundárias Oracle
No RDS para Oracle, uma atualização de versão secundária é uma atualização feita em uma versão principal do mecanismo de banco de dados. No RDS, uma versão secundária do mecanismo é uma atualização de versão (RU) ou um pacote de patches espaciais (SPB). Por exemplo, se sua instância de banco de dados executa a versão principal do Oracle Database 19c e a versão secundária 19.0.0.0.ru-2025-10.rur-2025-10.r1, você pode atualizar o mecanismo de banco de dados para a versão secundária 19.0.0.0.ru-2026-01.rur-2026-01.r1. O RDS para Oracle não é compatível com downgrades de versões secundárias.
Você pode fazer upgrade do seu mecanismo de banco de dados para uma versão secundária manual ou automaticamente. Para saber como fazer upgrade manualmente, consulte [Atualizar manualmente a versão do mecanismo](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.Manual). Para saber como configurar upgrades automáticos, consulte [Atualizar automaticamente a versão do mecanismo espelho](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.AutoMinorVersionUpgrades). Não importa se você faz upgrade manual ou automaticamente, o upgrade de versão secundária acarreta tempo de inatividade. Considere esse tempo de inatividade ao planejar suas atualizações.
O Amazon RDS também comporta a política de implementação de atualizações para gerenciar atualizações automáticas de versões secundárias em vários recursos de banco de dados e Contas da AWS. Para obter mais informações, consulte [Usar a política de implementação de atualização do AWS Organizations para atualizações automáticas de versões secundárias](RDS.Maintenance.AMVU.UpgradeRollout.md).
**Importante**
Teste completamente qualquer atualização para verificar se as aplicações funcionam corretamente antes de aplicá-la aos bancos de dados de produção. Para obter mais informações, consulte [Testar uma atualização do Oracle DB](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md).
**Topics**
+ [Atualizações de versão (RUs) e pacotes de patches espaciais (SPBs)](#RUs-and-SPBs)
+ [Ativar as atualizações automáticas de versão secundária para Oracle](#oracle-minor-version-upgrade-tuning-on)
+ [Usar a política de implementação de atualização do AWS Organizations para atualizações automáticas de versões secundárias](#oracle-minor-version-upgrade-rollout)
+ [Notificação de atualizações automáticas de versão secundária no RDS para Oracle](#oracle-minor-version-upgrade-advance)
+ [Como o RDS programa atualizações automáticas de versão secundária](#oracle-minor-version-upgrade-scheduled)
+ [Gerenciar uma atualização automática de versão secundária no RDS para Oracle](#oracle-minor-version-upgrade-managing)
## Atualizações de versão (RUs) e pacotes de patches espaciais (SPBs)
No RDS, uma atualização de versão (RU) é uma versão secundária trimestral do mecanismo que inclui correções de segurança, correções de erros e novos recursos para o Oracle Database. Um pacote de patches espaciais (SPB) é uma RU do mecanismo que inclui patches projetados para a opção Oracle Spatial. Por exemplo, o SPB denominado 19.0.0.0.ru-2025-01.spb-1.r1 inclui todos os patches na RU 19.0.0.0.ru-2025-01.rur-2025-01.r1 correspondente, além de patches específicos para o Spatial. Os SPBs são compatíveis somente com o Oracle Database 19c.
Quando a instância estiver configurada para atualizações automáticas de versões secundárias, as RUs e os SPBs estarão em caminhos de atualização separados. Normalmente, um SPB é lançado duas a três semanas após a RU correspondente. A tabela a seguir mostra exemplos de versões secundárias do Oracle Database 19c.
| Caminho de atualização de RU padrão | Caminho de atualização de SPB |
| --- | --- |
| 19.0.0.0.ru-2025-01.rur-2025-01.r1 | 19.0.0.0.ru-2025-01.spb-1.r1 |
| 19.0.0.0.ru-2025-04.rur-2025-04.r1 | 19.0.0.0.ru-2025-04.spb-1.r1 |
| 19.0.0.0.ru-2025-07.rur-2025-07.r1 | 19.0.0.0.ru-2025-07.spb-1.r1 |
| 19.0.0.0.ru-2025-10.rur-2025-10.r1 | 19.0.0.0.ru-2025-10.spb-1.r1 |
Se sua instância de banco de dados estiver configurada para atualizações automáticas, ela estará no caminho de atualização correspondente à sua versão atual. Por exemplo, se a instância de banco de dados estiver executando a versão 19.0.0.0.ru-2025-01.rur-2025-01.r1 quando 19.0.0.0.ru-2025-04.rur-2025-04.r1 for lançada, ela será automaticamente atualizada para essa RU. Da mesma forma, se a instância de banco de dados estiver executando a versão 19.0.0.0.ru-2025-01.spb-1.r1 quando 19.0.0.0.ru-2025-04.spb-1.r1 for lançada, ela será automaticamente atualizada para esse SPB. A instância que estiver executando a versão 19.0.0.0.ru-2025-01.rur-2025-01.r1, que é uma RU, não será atualizada automaticamente para 19.0.0.0.ru-2025-04.spb-1.r1, que é um SPB em um caminho de atualização separado.
Você pode atualizar a instância de banco de dados para SPBs mesmo que ela não use patches espaciais, mas esses patches se aplicam somente ao Oracle Spatial. Você pode atualizar manualmente de uma RU para um SPB na mesma versão do mecanismo ou em uma versão posterior. Por exemplo, é possível atualizar a instância de 19.0.0.0.ru-2025-01.rur-2025-01.r1 para uma das seguintes versões do mecanismo:
+ 19.0.0.0.ru-2025-01.spb-1.r1
+ 19.0.0.0.ru-2025-04.spb-1.r1
Você pode atualizar a instância de um SPB para uma RU somente se a RU for uma versão posterior do mecanismo. Por exemplo, é possível atualizar do SPB 19.0.0.0.ru-2025-04.spb-1.r1 para a RU posterior 19.0.0.0.ru-2025-07.rur-2025-07.r1, mas não para a mesma RU 19.0.0.0.ru-2025-04.rur-2025-04.r1.
Se a instância de banco de dados estiver configurada para atualizações automáticas de versões secundárias e você fizer a atualização manualmente de uma RU para um SPB ou de um SPB para uma RU, o caminho de atualização automática será alterado. Suponha que você atualize manualmente da RU 19.0.0.0.ru-2025-01.rur-2025-01.r1 para o SPB 19.0.0.0.ru-2025-01.spb-1.r1. Sua próxima atualização automática de versão secundária será para a versão 19.0.0.0.ru-2025-04.spb-1.r1 do SPB.
Como os SPBs funcionam como RUs, as APIs do RDS para atualizar a instância para RUs e SPBs são idênticas. Os comandos a seguir demonstram a atualização para uma RU e para um SPB.
```
aws rds modify-db-instance \
--db-instance-identifier mydbinstance \
--engine-version 19.0.0.0.ru-2025-01.rur-2025-01.r1
aws rds modify-db-instance \
--db-instance-identifier mydbinstance \
--engine-version 19.0.0.0.ru-2025-01.spb-1.r1
```
Para ter mais informações sobre como especificar a opção Oracle Spatial, consulte [Como funcionam os pacotes de patches espaciais (SPBs)](Oracle.Options.Spatial.md#Oracle.Options.Spatial.SPBs). Para examinar uma lista de RUs e SPBs compatíveis com o Oracle Database 19c, consulte [Amazon RDS for Oracle Database 19c (19.0.0.0)](https://docs.aws.amazon.com/AmazonRDS/latest/OracleReleaseNotes/oracle-version-19-0.html).
## Ativar as atualizações automáticas de versão secundária para Oracle
Em um upgrade automático de versão secundária, o RDS aplica a versão secundária mais recente disponível ao seu banco de dados Oracle sem intervenção manual. Uma instância de banco de dados do Amazon RDS para Oracle agenda seu upgrade durante a próxima janela de manutenção nas seguintes circunstâncias:
+ A instância de banco de dados está com a opção **Upgrade automático de versão secundária** ativada.
+ A instância de banco de dados não está executando a versão secundária mais recente do mecanismo de banco de dados.
Para saber como ativar upgrades automáticos, consulte [Atualizar automaticamente a versão do mecanismo espelho](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.AutoMinorVersionUpgrades).
## Usar a política de implementação de atualização do AWS Organizations para atualizações automáticas de versões secundárias
O Amazon RDS para Oracle comporta a política de implementação de atualizações do AWS Organizations para gerenciar atualizações automáticas de versões secundárias em vários recursos de banco de dados e Contas da AWS. Essa política elimina os custos operacionais indiretos de coordenar atualizações automáticas de versões secundárias manualmente ou por meio de ferramentas personalizadas, ao mesmo tempo em que garante que, antes de serem implementadas na produção, as atualizações sejam aplicadas primeiro em ambientes que não sejam de produção. Quando uma nova versão secundária do mecanismo é disponibilizada, o Amazon RDS atualiza as instâncias de banco de dados com base na ordem de implementação de atualizações configurada:
| Ordem de implementação de atualizações | Caso de uso típico | Quando a atualização começa |
| --- | --- | --- |
| Primeira | Ambientes de teste e desenvolvimento | Inicial: ideal para validar novas versões |
| Segunda | Ambientes de preparação e de produção não essenciais | Após a conclusão da “primeira” fase |
| Última | Ambientes de produção essenciais | Após a conclusão da “segunda” fase |
**Importante**
Se você não configurar uma ordem de implementação de atualizações para a instância de banco de dados, o padrão será a segunda.
Para ter informações detalhadas sobre a programação e duração das fases, consulte [Como o RDS programa atualizações automáticas de versão secundária](#oracle-minor-version-upgrade-scheduled). Para ter informações sobre como configurar políticas de implementação de atualizações no AWS Organizations, consulte [Usar a política de implementação de atualização do AWS Organizations para atualizações automáticas de versões secundárias](RDS.Maintenance.AMVU.UpgradeRollout.md).
## Notificação de atualizações automáticas de versão secundária no RDS para Oracle
Se a atualização automática de versões secundárias estiver habilitada na instância de banco de dados, o RDS para Oracle criará ações de manutenção pendentes para notificar você antes de aplicar as atualizações. É possível visualizar essas ações de manutenção pendentes na guia **Manutenção e backups** da página de detalhes do banco de dados no console do Amazon RDS.
Quando a nova versão secundária é disponibilizada, o RDS para Oracle publica uma notificação antecipada (ação de manutenção pendente). A notificação antecipada tem o seguinte formato:
```
An automatic minor version upgrade to engine-version will be applied during your maintenance window on apply-date based on the upgrade rollout order rollout-order. You can change the upgrade rollout order or apply this upgrade manually at any time before the scheduled date through the AWS console or AWS CLI.
```
`apply-date` na notificação antecipada é a data em que o Amazon RDS atualizará a instância de banco de dados. `rollout-order` é a ordem de implementação de atualizações (primeira, segunda ou última). Se você não configurou uma política de implementação de atualizações, esse valor será a segunda ordem por padrão. Para obter mais informações, consulte [Usar a política de implementação de atualização do AWS Organizations para atualizações automáticas de versões secundárias](RDS.Maintenance.AMVU.UpgradeRollout.md).
Quando a fase de implementação de atualizações começa, a mensagem de ação de manutenção pendente muda para o seguinte formato:
```
Automatic minor version upgrade to engine-version
```
Essa mensagem indica que a atualização foi programada e será aplicada durante a janela de manutenção na data de aplicação programada. É possível verificar a data de aplicação programada na guia **Manutenção e backups** da página de detalhes do banco de dados no console do Amazon RDS ou no campo `CurrentApplyDate` da resposta da API `describe-pending-maintenance-actions`.
O seguinte exemplo mostra que é possível obter os detalhes sobre as ações de manutenção pendentes usando o comando `describe-pending-maintenance-actions` na AWS CLI:
```
aws rds describe-pending-maintenance-actions
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:db:orclinst1",
"PendingMaintenanceActionDetails": [
{
"Action": "db-upgrade",
"Description": "Automatic minor version upgrade to 21.0.0.0.ru-2024-07.rur-2024-07.r1",
"CurrentApplyDate": "2024-12-02T08:10:00Z"
}
]
}, ...
```
Para ter mais informações sobre [describe-pending-maintenance-actions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-pending-maintenance-actions.html), consulte a *Referência de comandos da AWS CLI*.
## Como o RDS programa atualizações automáticas de versão secundária
Quando você usa a política de implementação de atualizações do AWS Organizations, o Amazon RDS atualiza as instâncias de banco de dados em fases com base na ordem de implementação configurada. Esta seção descreve a programação e a duração de cada fase.
**Fase 0: notificação antecipada**
Quando o RDS para Oracle lança uma nova versão secundária (normalmente de três a quatro semanas após o lançamento trimestral de atualização de versão da Oracle), todas as instâncias de banco de dados com atualização automática de versão secundária habilitada recebem uma notificação antecipada. Essa notificação aparece na guia **Manutenção e backups** da página de detalhes do banco de dados no console do Amazon RDS e na resposta da API `describe-pending-maintenance-actions`. A fase de notificação antecipada dura duas semanas. Durante essa fase, não ocorre nenhuma atualização automática.
**Fase 1: primeira ordem de implementação de atualizações**
No final da fase de notificação antecipada, o RDS para Oracle começa a atualizar as instâncias de banco de dados com a primeira ordem de implementação de atualizações. Essa fase dura de duas a três semanas para as versões secundárias trimestrais de janeiro, abril e julho e de sete a oito semanas para a versão secundária trimestral de outubro. O período estendido da versão secundária de outubro oferece tempo suficiente para testar a nova versão secundária durante as festas de fim de ano. As novas instâncias de banco de dados criadas durante essa fase com a primeira ordem de implementação de atualizações serão atualizadas automaticamente.
**Fase 2: segunda ordem de implementação de atualizações**
No final da fase 1, o RDS para Oracle começa a atualizar as instâncias de banco de dados com a segunda ordem de implementação de atualizações. Essa fase dura duas semanas para todas as versões secundárias trimestrais. As novas instâncias de banco de dados criadas durante essa fase com a primeira ou segunda ordem de implementação de atualizações serão atualizadas automaticamente.
**Fase 3: última ordem de implementação de atualizações**
No final da fase 2, o RDS para Oracle começa a atualizar as instâncias de banco de dados com a última ordem de implementação de atualizações. Essa fase dura até o próximo lançamento trimestral da versão secundária. As novas instâncias de banco de dados criadas durante essa fase com a primeira, segunda ou última ordem de implementação de atualizações serão atualizadas automaticamente.
| Fase | Quando começa | Duração | Mensagem de ação de manutenção pendente |
| --- | --- | --- | --- |
| Fase 0: notificação antecipada | Quando o RDS para Oracle lança uma nova versão secundária | Duas semanas | Uma atualização automática de uma versão secundária para a versão do mecanismo será aplicada durante a janela de manutenção na apply-date com base na ordem de implementação de atualizações rollout-order. É possível alterar a ordem de implementação de atualizações ou aplicar essa atualização manualmente a qualquer momento antes da data programada por meio do Console da AWS ou da AWS CLI. |
| Fase 1: primeira ordem de implementação de atualizações | Fim da fase de notificação antecipada | De duas a quatro semanas para versões secundárias de janeiro/abril/julho e de sete a nove semanas para a versão secundária de outubro | Atualização automática da versão secundária para a versão do mecanismo |
| Fase 2: segunda ordem de implementação de atualizações | Fim da fase 1 | Duas semanas | Atualização automática da versão secundária para a versão do mecanismo |
| Fase 3: última ordem de implementação de atualizações | Fim da fase 2 | Até o próximo lançamento trimestral da versão secundária | Atualização automática da versão secundária para a versão do mecanismo |
## Gerenciar uma atualização automática de versão secundária no RDS para Oracle
Quando a atualização automática de versão secundária está habilitada na instância de banco de dados, o Amazon RDS atualiza automaticamente a instância de banco de dados para a última versão secundária durante a janela de manutenção. Mas você pode optar por aplicar a atualização manualmente antes da data programada usando a AWS CLI ou na guia **Manutenção e backups** da página de detalhes do banco de dados.
Para atualizar sua instância de banco de dados imediatamente, em vez de aguardar a janela de manutenção programada:
```
aws rds apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:orclinst1 \
--apply-action db-upgrade \
--opt-in-type immediate
```
Para aplicar a atualização durante a próxima janela de manutenção, em vez de na data de aplicação programada:
```
aws rds apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:123456789012:db:orclinst1 \
--apply-action db-upgrade \
--opt-in-type next-maintenance
```
Para cancelar a atualização automática de versão secundária, modifique a instância de banco de dados e desative a opção de atualização automática de versão secundária. Isso cancela qualquer atualização automática pendente.
Para saber como desativar atualizações automáticas de versão secundária, consulte [Atualizar automaticamente a versão do mecanismo espelho](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.AutoMinorVersionUpgrades). Se precisar de ajuda para desativar a atualização automática de versões secundárias, entre em contato com o AWS Support.
Às vezes, uma nova versão secundária fica disponível antes que o RDS aplique uma versão secundária anterior. Por exemplo, a instância está sendo executada na `21.0.0.0.ru-2025-07.rur-2025-07.r1` quando `both 21.0.0.0.ru-2025-10.rur-2025-10.r1` e `21.0.0.0.ru-2026-01.rur-2026-01.r1` está disponível como destino de atualização. Nessa situação, para evitar tempo de inatividade desnecessário para as instâncias de banco de dados, o RDS programa o upgrade automático da versão secundária para a versão mais recente, ignorando o upgrade para a versão anterior. Neste exemplo, o RDS atualiza diretamente a instância da `21.0.0.0.ru-2025-07.rur-2025-07.r1` para a `21.0.0.0.ru-2026-01.rur-2026-01.r1`.
# Considerações sobre atualizações de bancos de dados Oracle
Antes de atualizar a instância Oracle, analise as informações a seguir.
**Topics**
+ [Considerações sobre o Oracle Multitenant](#USER_UpgradeDBInstance.Oracle.multi)
+ [Considerações de grupos de opções](#USER_UpgradeDBInstance.Oracle.OGPG.OG)
+ [Considerações de grupos de parâmetros](#USER_UpgradeDBInstance.Oracle.OGPG.PG)
+ [Considerações sobre fuso horário](#USER_UpgradeDBInstance.Oracle.OGPG.DST)
+ [Considerações sobre pacote de patches espaciais (SPB)](#USER_UpgradeDBInstance.Oracle.SPB)
## Considerações sobre o Oracle Multitenant
A tabela a seguir descreve as arquiteturas do Oracle Database compatíveis em versões diferentes.
| Versão do Oracle Database | Status de suporte do RDS | Arquitetura |
| --- | --- | --- |
| Oracle Database 21c | Compatível | Somente CDB |
| Oracle Database 19c | Compatível | CDB ou não CDB |
A tabela a seguir descreve os caminhos de atualização compatíveis e incompatíveis.
| Caminho de atualização | Compatível? |
| --- | --- |
| CDB para CDB | Sim |
| Não CDB para CDB | Não, mas é possível converter uma arquitetura não CDB em CDB e depois atualizá-la |
| CDB para não CDB | Não |
Para obter mais informações sobre o Oracle Multitenant no RDS for Oracle, consulte [Configuração de locatário único da arquitetura CDB](Oracle.Concepts.CDBs.md#Oracle.Concepts.single-tenant).
## Considerações de grupos de opções
Se sua instância de banco de dados usa um grupo de opções personalizado, às vezes o Amazon RDS não pode atribuir automaticamente um novo grupo de opções. Por exemplo, isso ocorre quando você faz a atualização para uma nova versão principal. Nesses casos, especifique um novo grupo de opções ao atualizar. Recomendamos que você crie um novo grupo de opções e adicione a ele as mesmas opções que o seu grupo de opções personalizadas existente.
Para obter mais informações, consulte [Criar um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create) ou [Copiar um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Copy).
Se a instância de banco de dados usar um grupo de opções personalizado que contenha a opção as opções `APEX` e `APEX-DEV`, você pode reduzir o tempo de atualização algumas vezes. Para fazer isso, atualize sua versão do Oracle APEX ao mesmo tempo que sua instância de banco de dados. Para obter mais informações, consulte [Atualizar a versão do Oracle APEX](Appendix.Oracle.Options.APEX.UpgradeandRemove.md#Appendix.Oracle.Options.APEX.Upgrade).
## Considerações de grupos de parâmetros
Se a sua instância de banco de dados usar um grupo de parâmetros personalizado, em alguns casos, o Amazon RDS não poderá atribuir automaticamente a ela um novo grupo de parâmetros. Por exemplo, isso ocorre quando você faz a atualização para uma nova versão principal. Nesses casos, certifique-se de especificar um novo grupo de parâmetros ao atualizar. Recomendamos que você crie um novo parameter group e configure os parâmetros como no seu parameter group personalizado existente.
Para obter mais informações, consulte [Criar um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Creating.md) ou [Copiar um grupo de parâmetros de banco de dados no Amazon RDS](USER_WorkingWithParamGroups.Copying.md).
## Considerações sobre fuso horário
É possível usar a opção de fuso horário para alterar o *fuso horário do sistema* usado pela sua instância de banco de dados Oracle. Por exemplo, é possível alterar o fuso horário de uma instância de banco de dados para que ele seja compatível com um ambiente local ou um aplicativo herdado. A opção de fuso horário altera o fuso horário no nível do host. O Amazon RDS for Oracle atualiza automaticamente o fuso horário do sistema ao longo do ano. Para obter mais informações sobre o fuso horário do sistema, consulte [Fuso horário da Oracle](Appendix.Oracle.Options.Timezone.md).
Quando uma instância de banco de dados Oracle é criada, o banco de dados define automaticamente o *fuso horário do banco de dados*. O fuso horário do banco de dados também é conhecido como fuso DST (horário de verão). O fuso horário do banco de dados é diferente do fuso horário do sistema.
Entre versões do Oracle Database, conjuntos de patches ou patches individuais podem incluir novas versões do DST. Esses patches refletem as alterações nas regras de transição para várias regiões de fuso horário. Por exemplo, um governo pode mudar a data de início do DST. Alterações às regras de DST podem afetar dados existentes do tipo de dados `TIMESTAMP WITH TIME ZONE`.
Se você atualizar uma instância do RDS for Oracle, o Amazon RDS não atualizará o fuso horário do banco de dados automaticamente. Para atualizar o arquivo de fuso horário automaticamente, você pode incluir a opção `TIMEZONE_FILE_AUTOUPGRADE` no grupo de opções associado à sua instância de banco de dados durante ou após a atualização da versão do mecanismo. Para obter mais informações, consulte [Atualização automática do arquivo de fuso horário do Oracle](Appendix.Oracle.Options.Timezone-file-autoupgrade.md).
Como alternativa, para atualizar o fuso horário do arquivo de banco de dados manualmente, crie uma nova instância de banco de dados Oracle que tenha o patch de DST desejado. No entanto, recomendamos atualizar o arquivo de fuso horário do banco de dados usando a opção `TIMEZONE_FILE_AUTOUPGRADE`.
Depois de atualizar o arquivo de fuso horário, migre os dados da instância atual para a nova instância. É possível migrar dados usando várias técnicas, incluindo as seguintes:
+ AWS Database Migration Service
+ Oracle GoldenGate
+ Oracle Data Pump
+ Exportação/importação original (suporte desativado para uso geral)
**nota**
Quando dados são migrados usando o Oracle Data Pump, o utilitário gera o erro ORA-39405 quando a versão de fuso horário de destino é inferior à versão do fuso horário de origem.
Para obter mais informações, consulte [Restrições de TIMESTAMP WITH TIMEZONE](https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-overview.html#GUID-9B6C92EE-860E-43DD-9728-735B17B9DA89) na documentação da Oracle.
## Considerações sobre pacote de patches espaciais (SPB)
No RDS para Oracle, uma atualização de versão (RU) é uma versão secundária do mecanismo que inclui correções de segurança, correções de erros e novos recursos para o Oracle Database. Um pacote de patches espaciais (SPB) é uma versão secundária do mecanismo que inclui patches projetados para a opção Oracle Spatial. Por exemplo, 19.0.0.0.ru-2025-01.spb-1.r1 é uma versão secundária do mecanismo que contém os patches de RU na versão do mecanismo 19.0.0.0.ru-2025-01.rur-2025-01.r1 e patches do Spatial.
Quando você atualizar seu banco de dados par SPBs, considere o seguinte:
+ Os SPBs são compatíveis somente com o Oracle Database 19c.
+ Normalmente, um SPB é lançado duas a três semanas após a RU trimestral correspondente.
+ Você pode atualizar a instância de banco de dados para um SPB mesmo que ela não use a opção Oracle Spatial, mas os patches espaciais na versão do mecanismo se aplicam somente ao Oracle Spatial. Você pode criar uma instância em um SPB e instalar a opção Oracle Spatial posteriormente.
+ Se você habilitar a atualização automática de versões secundárias para sua instância de banco de dados, o caminho da atualização dependerá de a instância estar usando um SPB ou uma RU naquele momento. Se a instância de banco de dados estiver usando um SPB, o RDS a atualizará automaticamente para o SPB mais recente. Se a instância de banco de dados estiver usando uma RU, o RDS a atualizará automaticamente para a RU mais recente.
+ Você pode atualizar manualmente a instância de banco de dados de uma RU para um SPB somente se a versão do SPB do mecanismo for igual ou posterior à RU atual.
+ Você pode atualizar manualmente sua instância de banco de dados de um SPB para uma RU somente se a RU for uma versão posterior.
# Testar uma atualização do Oracle DB
Antes de fazer upgrade da instância de banco de dados para uma versão principal, teste exaustivamente o banco de dados e todas as aplicações que o acessam para atestar a compatibilidade com a nova versão. Recomendamos que você use o procedimento a seguir.
**Para testar um upgrade de versão principal**
1. Reveja a documentação de upgrade da Oracle para a nova versão do mecanismo de banco de dados para ver se existem problemas de compatibilidade que podem afetar seu banco de dados ou seus aplicativos. Para obter mais informações, consulte o [Database Upgrade Guide](https://docs.oracle.com/database/121/UPGRD/toc.htm), na documentação da Oracle.
1. Se a sua instância de banco de dados usar um grupo de opções personalizado, crie um novo grupo de opções compatível com a nova versão para a qual você está atualizando. Para obter mais informações, consulte [Considerações de grupos de opções](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG).
1. Se a sua instância de banco de dados usar um parameter group personalizado, crie um novo parameter group compatível com a nova versão para a qual você está atualizando. Para obter mais informações, consulte [Considerações de grupos de parâmetros](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.PG).
1. Crie um snapshot de banco de dados da instância de banco de dados a ser atualizada. Para obter mais informações, consulte [Criar um snapshot de banco de dados para uma instância de banco de dados single-AZ para o Amazon RDS](USER_CreateSnapshot.md).
1. Restaure o snapshot de banco de dados para criar uma nova instância de banco de dados de teste. Para obter mais informações, consulte [Restaurar uma instância de banco de dados](USER_RestoreFromSnapshot.md).
1. Modifique essa nova instância de banco de dados de teste para atualizá-la para a nova versão, usando um dos seguintes métodos:
+ [Console](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.Manual.Console)
+ [AWS CLI](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.Manual.CLI)
+ [API do RDS](USER_UpgradeDBInstance.Upgrading.md#USER_UpgradeDBInstance.Upgrading.Manual.API)
1. Realize testes:
+ Execute quantos testes de garantia de qualidade na instância de banco de dados atualizada forem necessários para garantir que o seu banco de dados e o seu aplicativo funcionem corretamente com a nova versão.
+ Implemente os novos testes necessários para avaliar o impacto de problemas de compatibilidade que você identificou na etapa 1.
+ Teste todos os procedimentos, funções e triggers armazenados.
+ Direcione versões de teste dos seus aplicativos à instância de banco de dados atualizada. Verifique se os aplicativos funcionam corretamente com a nova versão.
+ Avalie o armazenamento usado pela instância atualizada para determinar se o upgrade requer armazenamento adicional. Talvez você precise escolher uma classe de instância maior para dar suporte à nova versão em produção. Para obter mais informações, consulte [Classes de instâncias de banco de dados do ](Concepts.DBInstanceClass.md).
1. Se todos os testes forem aprovados, atualize a instância de banco de dados de produção. Recomendamos que você confirme se a instância de banco de dados está funcionando corretamente antes de permitir operações de gravação na instância de banco de dados.
# Atualizar a versão de uma instância de banco de dados do RDS para Oracle
Para atualizar manualmente a versão do mecanismo de banco de dados de uma instância de banco de dados do RDS para Oracle, use o Console de gerenciamento da AWS, a AWS CLI ou a API do RDS. Para ter informações gerais sobre atualizações de bancos de dados, consulte [Atualizar a versão de uma instância de banco de dados do RDS para Oracle](#USER_UpgradeDBInstance.Oracle.Upgrading). Para ter destinos de atualização válidos, use o comando [describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html) da AWS CLI.
## Console
**Como atualizar a versão do mecanismo de uma instância de banco de dados do RDS para Oracle usando o console**
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 atualizar.
1. Selecione **Modify**.
1. Em **Versão do mecanismo de banco de dados**, escolha uma versão posterior do banco de dados.
1. Escolha **Continuar** e verifique o resumo de modificações. Entenda as implicações de uma atualização de versão de banco de dados. Não é possível converter uma instância de banco de dados atualizada na versão anterior. Antes de continuar, não se esqueça de testar o banco de dados e a aplicação com a nova versão.
1. Decida quando agendar a atualização da instância de banco de dados. Para aplicar as alterações imediatamente, escolha **Apply immediately**. Escolher essa opção pode causar uma interrupção em alguns casos. Para ter mais informações, consulte [Usar a configuração de programação de modificações](USER_ModifyInstance.ApplyImmediately.md).
1. Na página de confirmação, revise suas alterações. Se estiverem corretas, escolha **Modify DB Instance (Modificar instância de banco de dados)** para salvar suas alterações.
Como alternativa, escolha **Back (Voltar)** para editar suas alterações ou escolha **Cancel (Cancelar)** para cancelar as alterações.
## AWS CLI
Para atualizar a versão do mecanismo de uma instância de banco de dados do RDS para Oracle, use o comando [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html) da CLI. Especifique os seguintes parâmetros:
+ `--db-instance-identifier`: o nome da instância de banco de dados do RDS para Oracle.
+ `--engine-version` – o número da versão do mecanismo de banco de dados para a qual será feita a atualização.
Para obter informações sobre versões de mecanismo válidas, use o comando AWS CLI [ describe-db-engine-versions](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-db-engine-versions.html).
+ `--allow-major-version-upgrade`: para atualizar a versão do mecanismo de banco de dados.
+ `--no-apply-immediately` – para aplicar alterações durante a próxima janela de manutenção. Para aplicar as alterações imediatamente, use `--apply-immediately`.
**Example**
O exemplo a seguir atualiza uma instância do CDB denominada `myorainst` da versão atual de `19.0.0.0.ru-2024-01.rur-2024-01.r1` para a versão `21.0.0.0.ru-2024-04.rur-2024-04.r1`.
Para Linux, macOS ou Unix:
```
1. aws rds modify-db-instance \
2. --db-instance-identifier myorainst \
3. --engine-version 21.0.0.0.ru-2024-04.rur-2024-04.r1 \
4. --allow-major-version-upgrade \
5. --no-apply-immediately
```
Para Windows:
```
1. aws rds modify-db-instance ^
2. --db-instance-identifier myorainst ^
3. --engine-version 21.0.0.0.ru-2024-04.rur-2024-04.r1 ^
4. --allow-major-version-upgrade ^
5. --no-apply-immediately
```
## API do RDS
Para atualizar uma instância de banco de dados do RDS para Oracle, use a ação [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html). Especifique os seguintes parâmetros:
+ `DBInstanceIdentifier` – o nome da instância de banco de dados. Por exemplo *`myorainst`*.
+ `EngineVersion` – o número da versão do mecanismo de banco de dados para a qual será feita a atualização. Para obter informações sobre versões de mecanismo válidas, use a operação [ DescribeDBEngineVersions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBEngineVersions.html).
+ `AllowMajorVersionUpgrade` – para permitir ou não uma atualização de versão principal. Para isso, defina o valor como `true`.
+ `ApplyImmediately` – se desejar aplicar as alterações imediatamente ou durante a próxima janela de manutenção. Para aplicar as alterações imediatamente, defina o valor como `true`. Para aplicar alterações durante a próxima janela de manutenção, defina o valor como `false`.
# Como atualizar para um snapshot de banco de dados Oracle
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
**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
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
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).