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 de upgrade para um máximo de 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.

As novas releases do APEX e os Pacotes de Conjuntos de Patches ficam disponíveis na seguinte ordem:

• Autonomous AI Databases Always Free, Autonomous AI Databases para Desenvolvedores, bancos de dados no nível de patch Antecipado.

• Uma semana depois, bancos de dados no nível de patch Regular.

Consulte Definir o Nível de Patch para mais informações sobre os níveis de patch do banco de dados.

Os Autonomous AI Databases nos serviços Oracle Multicloud recebem novas versões do APEX e Pacotes de Conjuntos de Patches ao mesmo tempo que os bancos de dados na OCI. Consulte Autonomous AI Database em ambientes multicloud 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 seu banco de dados não usar o APEX, o Autonomous AI Database não enviará notificações por e-mail e não emitirá eventos de Informações do OCI 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:

1. Abra o APEX Administration Services.

   Consulte Acessar o Oracle APEX Administration Services para obter mais informações.

2. 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. Consulte Sobre a API PL/SQL de Upgrade do Oracle APEX para obter mais informações.

Para definir a janela de upgrade do APEX:

1. Abra o APEX Administration Services.

   Consulte Acessar o Oracle APEX Administration Services para obter mais informações.

2. Abra a caixa de diálogo Atualizações Disponíveis clicando no ícone de engrenagem ao lado de Atualizações Disponíveis.

3. Para Janela de Upgrade, selecione 45 dias ou 90 dias.

   

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

4. Clique em Aplicar Alterações.

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

• A definição da janela de upgrade do APEX não está disponível para Autonomous AI Databases Always Free ou Autonomous AI Databases para Desenvolvedores. Essas instâncias usam a janela de upgrade padrão de 45 dias.

• 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 pelas seguintes fases:

1. Criar esquemas de banco de dados e objetos de banco de dados.

2. Migrar metadados do aplicativo.

3. Migre dados de runtime e alterne para a nova versão do APEX.

4. Migre dados adicionais de log e resumo.

5. Instale suporte adicional ao idioma para o mecanismo de runtime do APEX e o ambiente de desenvolvimento do APEX.

6. Instale todos os Pacotes de Conjuntos de Patches disponíveis para a nova release do APEX.

As fases 1 e 4-6 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.

Para aplicar um upgrade do APEX manualmente:

1. Abra o APEX Administration Services.

   Consulte Acessar o Oracle APEX Administration Services para obter mais informações.

2. 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.

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.

Observação

Observação: Para aplicar um upgrade do APEX ao usar a Imagem do Contêiner Livre do Autonomous AI Database, migre para uma versão mais recente da imagem do Contêiner Livre. Consulte Usar a Imagem do Contêiner do Autonomous AI Database Free para obter mais informações.

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 parâmetros de instância a seguir controlam os upgrades do APEX no Autonomous AI Database.

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:

1. 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.

2. 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:

1. 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.

2. 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;

3. 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:

1. 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.

2. 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.

3. 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