Controlar Upgrades do Oracle APEX

A Oracle mantém a instância do Oracle APEX em seu Autonomous AI Database aplicando novas releases e Pacotes de Conjuntos de Patches. Quando uma nova release do APEX estiver disponível na sua região, você poderá escolher quando aplicá-la durante a janela de upgrade. A Oracle aplica Pacotes de Conjuntos de Patches automaticamente durante os períodos de manutenção programados.

Sobre Atualizações e Patches do Oracle APEX

O Autonomous AI Database recebe dois tipos de atualizações do Oracle APEX:

Novas releases atualizam o APEX para uma nova release de recurso, por exemplo, de 24.2.17 para 26.1.0. Eles incluem correções de bugs e novos recursos do produto. Pode levar de 2 a 5 semanas para que a sua região da Oracle Cloud Infrastructure (OCI) receba a nova versão depois que ela ficar disponível para download no oracle.com. Quando uma nova release estiver disponível na sua região, você poderá aplicá-la durante a janela de upgrade de 45 dias. Os clientes com instâncias pagas podem estender a janela para 90 dias. Se você não fizer nenhuma ação, a Oracle aplicará a release automaticamente no final da janela de upgrade.
Pacotes de Conjuntos de Patches atualizam o APEX na mesma família de releases, por exemplo, de 26.1.0 para 26.1.1. Os Pacotes de Patches de Conjuntos incluem correções de bugs e nenhuma nova funcionalidade. O sistema Oracle aplica patches automaticamente durante as janelas de manutenção programadas do banco de dados quando o componente Dicionário é submetido a patch.

Os Autonomous AI Databases no nível de patch Antecipado recebem novas releases do APEX e Pacotes de Conjuntos de Patches uma semana antes dos bancos de dados no nível de patch Regular. Consulte Definir o Nível de Patch para obter mais informações.

Para validar uma nova release do APEX antes de fazer upgrade do banco de dados de produção, clone o banco de dados, aplique a nova release ao clone e teste os aplicativos no clone. Consulte Clonar uma Instância do Autonomous AI Database para obter mais informações.

Notificações de Upgrade e Patch do Oracle APEX

A Oracle usa três canais de notificação para anunciar as versões do Oracle APEX e os Pacotes de Conjuntos de Patches:

Banner no APEX App Builder: Quando uma nova release do APEX estiver disponível para o seu Autonomous AI Database, os desenvolvedores verão um banner de anúncio quando acessarem o APEX App Builder.
Notificações por e-mail: A Oracle envia um e-mail aos contatos do cliente para cada Autonomous AI Database quando uma nova release do APEX é disponibilizada nessa região. Este e-mail descreve as novidades desta release do APEX e explica como implantá-la no seu banco de dados. Para se inscrever, consulte Exibir e Gerenciar Contatos do Cliente para Problemas Operacionais e Anúncios.
Eventos de informações da OCI: o Autonomous AI Database emite o evento APEXUpgradeAvailable quando uma nova release do APEX é disponibilizada. Ele emite o evento APEXUpgradeBegin quando um upgrade ou patch do APEX começa a implantação e o evento APEXUpgradeEnd quando conclui a implantação. Consulte Eventos de Informações no Autonomous AI Database e Seja Notificado sobre Eventos do Autonomous AI Database.

Se o seu banco de dados não usar o APEX, o Autonomous AI Database não emitirá eventos de Informações relacionados ao APEX.

Exibir Janela de Upgrade Atual do Oracle APEX

Você pode exibir a janela de upgrade atual do Oracle APEX nos seguintes locais:

Administration Services: A seção Atualizações Disponíveis exibe se uma nova release está disponível, a data de upgrade automático programado e a janela de upgrade atual.
App Builder: Quando uma nova release estiver disponível, a home page do App Builder exibirá o status do upgrade. Os desenvolvedores podem exibir o status, mas somente administradores de instâncias podem aplicar o upgrade.

Para exibir a janela de upgrade atual no Administration Services:

Abra o APEX Administration Services.

Consulte Acessar o Oracle APEX Administration Services para obter mais informações.
Revise a seção Atualizações Disponíveis na barra lateral direita.

Definir Janela de Upgrade do Oracle APEX

Use a caixa de diálogo Atualizações Disponíveis no Oracle APEX Administration Services para definir a janela de upgrade para releases futuras.

Você só poderá alterar a janela de upgrade no Administration Services quando nenhum upgrade estiver disponível no momento. Se quiser estender a janela de upgrade depois que uma nova release estiver disponível, use a API PL/SQL.

Para definir a janela de upgrade do APEX:

Abra o APEX Administration Services.

Consulte Acessar o Oracle APEX Administration Services para obter mais informações.
Abra a caixa de diálogo Atualizações Disponíveis clicando no ícone de engrenagem ao lado de Atualizações Disponíveis.
Selecione a Janela de Upgrade desejada.

Descrição da ilustração adb_apex_available_updates.png
Clique em Aplicar Alterações.

Observações para Definir a Janela de Upgrade do Oracle APEX

Você não pode programar um upgrade do APEX para uma data e hora específicas. Quando uma nova versão estiver disponível, você poderá permitir que a Oracle a aplique automaticamente na data programada ou aplicá-la manualmente a qualquer momento antes dessa data.
Se o seu banco de dados não tiver uma atividade do APEX nos últimos 6 meses, a Oracle aplicará o próximo upgrade do APEX automaticamente, independentemente da configuração da janela de upgrade.

Aplicar Upgrades do Oracle APEX

Quando uma nova release do APEX estiver disponível, você poderá aplicá-la a qualquer momento antes da data de upgrade programada. Se você não aplicá-lo manualmente, a Oracle o aplicará automaticamente na data programada mostrada em Atualizações Disponíveis.

O upgrade é executado em segundo plano e prossegue nestas fases:

Criar esquemas de banco de dados e objetos de banco de dados.
Migrar metadados do aplicativo.
Migre dados de runtime e alterne para a nova versão do APEX.
Migre dados adicionais de log e resumo.

As fases 1 e 4 não bloqueiam os usuários finais do aplicativo. A Fase 2 afeta os desenvolvedores que modificam aplicativos. A fase 3 afeta todo o acesso ao APEX e espera-se que leve até 3 minutos. A Oracle instala suporte adicional ao idioma para o ambiente de desenvolvimento APEX após a fase 4.

Para aplicar um upgrade do APEX manualmente:

Abra o APEX Administration Services.

Consulte Acessar o Oracle APEX Administration Services para obter mais informações.
Em Atualizações Disponíveis, clique em Fazer Upgrade Agora.

Se a seção Atualizações Disponíveis exibir O sistema está atualizado, o Autonomous AI Database já estará executando a release mais recente do APEX disponível na sua região.

Veja a seguir a descrição da ilustração adb_apex_updates_deferred.png

Descrição da ilustração adb_apex_updates_deferred.png

Após o início do upgrade, os administradores podem continuar a monitorar o status no Administration Services ou usando a API PL/SQL, e os desenvolvedores podem exibir o status no App Builder.

Sobre a API PL/SQL de Upgrade do Oracle APEX

Use a API PL/SQL do Oracle APEX para exibir o status do upgrade, alterar a janela de upgrade e aplicar um upgrade disponível de forma programática.

Os seguintes parâmetros de instância controlam as atualizações do APEX no Autonomous AI Database:

UPGRADE_DATE: A data programada para o próximo upgrade do APEX ou NULL quando nenhum upgrade for programado. O valor usa o formato ISO 8601 no UTC.
UPGRADE_DEFERRED: Controla a janela de upgrade para releases futuras do APEX. Defina-o como N para a janela padrão ou Y para a janela estendida. Se a próxima versão já estiver programada, a alteração desse valor reagendará essa versão. A definição do valor como Y novamente não estende ainda mais a janela de upgrade.
UPGRADE_STATUS: Mostra o status do próximo upgrade do APEX. Os valores possíveis são UP-TO-DATE, SCHEDULED e RUNNING. Defina-o como RUN para aplicar o upgrade disponível.
UPGRADE_VERSION: A versão do APEX que o próximo upgrade programado instalará ou será NULL quando nenhum upgrade for programado.

Para examinar os valores de parâmetro atuais, use a API PL/SQL APEX_INSTANCE_ADMIN.GET_PARAMETER. Para definir valores de parâmetro, use APEX_INSTANCE_ADMIN.SET_PARAMETER. Consulte Valores de Parâmetro Disponíveis no Oracle APEX API Reference para obter mais informações.

Para exibir o status atual de upgrade do APEX usando a API PL/SQL:

Estabeleça conexão com o banco de dados como ADMIN ou como outro usuário do banco de dados com a atribuição APEX_ADMINISTRATOR_ROLE.

Execute a seguinte consulta:

select APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_STATUS') as upgrade_status,
       APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_DEFERRED') as upgrade_deferred,
       APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_VERSION') as upgrade_version,
       APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_DATE') as upgrade_date
  from dual;

Se nenhuma atualização estiver disponível, o resultado da consulta será semelhante ao seguinte:

UPGRADE_STATUS UPGRADE_DEFERRED UPGRADE_VERSION UPGRADE_DATE
-------------- ---------------- --------------- ------------
UP-TO-DATE     Y                null            null

Se um upgrade estiver disponível, o resultado será semelhante ao seguinte:

UPGRADE_STATUS UPGRADE_DEFERRED UPGRADE_VERSION UPGRADE_DATE
-------------- ---------------- --------------- --------------------
SCHEDULED      Y                26.1.0          2026-08-30T19:06:11Z

Para definir a janela de upgrade do APEX usando a API PL/SQL:

Estabeleça conexão com o banco de dados como ADMIN ou como outro usuário do banco de dados com a atribuição APEX_ADMINISTRATOR_ROLE.
Defina o valor UPGRADE_DEFERRED como N para a janela de upgrade padrão ou Y para a janela de upgrade estendido.
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_DEFERRED', 'Y');
  commit;
end;
```

Verifique a configuração.

select APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_DEFERRED') as upgrade_deferred
  from dual;

Para aplicar o upgrade do APEX disponível usando a API PL/SQL:

Estabeleça conexão com o banco de dados como ADMIN ou como outro usuário do banco de dados com a atribuição APEX_ADMINISTRATOR_ROLE.
Execute o seguinte bloco PL/SQL:
```
begin
  APEX_INSTANCE_ADMIN.set_parameter('UPGRADE_STATUS', 'RUN');
  commit;
end;
```
O bloco PL/SQL inicia o upgrade e retorna imediatamente.

Verifique se o upgrade foi iniciado.

select APEX_INSTANCE_ADMIN.get_parameter('UPGRADE_STATUS') as upgrade_status
  from dual;

Se o upgrade tiver sido iniciado, o resultado será semelhante ao seguinte:

UPGRADE_STATUS
--------------
RUNNING

Documentação do Oracle Cloud Infrastructure