Oracle Application Express (APEX)

O Amazon RDS é compatível com o Oracle Application Express (APEX) com o uso das opções APEX e APEX-DEV. É possível implantar o Oracle APEX como um ambiente de execução ou como um ambiente de desenvolvimento completo para aplicações baseadas na Web. Com o Oracle APEX, você pode criar aplicações inteiramente no navegador da web. Para ter mais informações, consulte Oracle Application Express na documentação da Oracle.

Componentes de APEX

O Oracle APEX consiste nos seguintes componentes principais:

• Um repositório que armazena metadados para aplicativos e componentes APEX. O repositório consiste em tabelas, índices e outros objetos instalados na sua instância de banco de dados do Amazon RDS.

• Um ouvinte que gerencia as comunicações HTTP com clientes Oracle APEX. O receptor reside em um host separado como uma instância do Amazon EC2, um servidor on-premises na sua empresa ou no seu computador desktop. O ouvinte aceita as conexões de entrada que os navegadores da web enviam à instância de banco de dados do Amazon RDS para fins de processamento. Em seguida, ele envia os resultados do repositório de volta para os navegadores. O RDS for Oracle é compatível com os seguintes tipos de receptores:

  • Para o APEX versão 5.0 e posterior, use o Oracle Rest Data Services (ORDS) versão 19.1 e posterior. Recomendamos que você use a versão mais recente compatível do Oracle APEX e do ORDS. Essa documentação descreve versões mais antigas apenas para compatibilidade com versões anteriores.

  • Para o APEX versão 4.1.1, você pode usar o Oracle APEX Listener versão 1.1.4.

  • Você pode usar o Oracle HTTP Server e listeners mod_plsql.

    nota

    O Amazon RDS não é compatível com o servidor HTTP do banco de dados Oracle XML com o gateway PL/SQL embutido. Você não pode usá-lo como um listener do APEX. Em geral, a Oracle não recomenda o uso do gateway PL/SQL embutido para aplicativos executados na internet.

  Para ter mais informações sobre esses tipos de listener, consulte About Choosing a Web Listener (Sobre escolher um listener da Web) na documentação do Oracle.

Ao adicionar as opções APEX do Amazon RDS à sua instância de banco de dados do RDS para Oracle, o Amazon RDS instala apenas o repositório do Oracle APEX. Instale seu receptor em um host separado.

Requisitos de versões de APEX

A opção APEX usa armazenamento na classe de sua instância de banco de dados. A seguir estão as versões compatíveis e os requisitos aproximados de armazenamento para o Oracle APEX:

Versão APEX	Requisitos de armazenamento	Versões compatíveis do Oracle Database	Observações
Oracle APEX versão 23.1.v1	106 MiB	19c e não CDBs posteriores	Esta versão inclui o patch 35283657: PSE BUNDLE FOR APEX 23.1 (PSES ACIMA DE 23.1.0), PATCH_VERSION 2.
Oracle APEX versão 22.2.v1	106 MiB	Todos os que não são CDBs	Esta versão inclui o patch 34628174: PACOTE DO PSE PARA APEX 22.2 (PSES SOBRE 22.2.0), PATCH_VERSION 4.
Oracle APEX versão 22.1.v1	124 MiB	Todos os que não são CDBs	Esta versão inclui o patch 34020981: PACOTE DO PSE PARA APEX 22.1 (PSES SOBRE 22.1.0), PATCH_VERSION 6.
Oracle APEX versão 21.2.v1	125 MiB	Todos	Esta versão inclui o patch 33420059: PACOTE DO PSE PARA APEX 21.2 (PSES SOBRE 21.2.0), PATCH_VERSION 8.
Oracle APEX versão 21.1.v1	125 MiB	Todos	Esta versão inclui o patch 32598392: PACOTE PSE PARA APEX 21.1, PATCH_VERSÃO 3.
Oracle APEX versão 20.2.v1	148 MiB	Todas, exceto 21c	Esta versão inclui o patch 32006852: PACOTE PSE PARA APEX 20.2, PATCH_VERSÃO 2020.11.12. Você pode ver o número e a data do patch executando a seguinte consulta: SELECT PATCH_VERSION, PATCH_NUMBER FROM APEX_PATCHES;
Oracle APEX versão 20.1.v1	173 MiB	Todas, exceto 21c	Esta versão inclui o patch 30990551: PACOTE PSE PARA APEX 20.1, PATCH_VERSÃO 2020.07.15.
Oracle APEX versão 19.2.v1	149 MiB	Todas, exceto 21c
Oracle APEX versão 19.1.v1	148 MiB	Todas, exceto 21c
Oracle APEX versão 18.2.v1	146 MiB	Somente 12.1 e 12.2
Oracle APEX versão 18.1.v1	145 MiB	Somente 12.1 e 12.2
Oracle APEX versão 5.1.4.v1	220 MiB	Somente 12.1 e 12.2
Oracle APEX versão 5.1.2.v1	150 MiB	Somente 12.1 e 12.2
Oracle APEX versão 5.0.4.v1	140 MiB	Somente 12.1 e 12.2
Oracle APEX versão 4.2.6.v1	160 MiB	Somente 12.1

Para arquivos APEX .zip que podem ser baixados, consulte Oracle APEX Prior Release Archives (Arquivos de versões anteriores do Oracle APEX) no site da Oracle.

Requisitos e limitações do Oracle APEX e ORDS

Observe os seguintes requisitos para APEX e ORDS:

• Você precisa usar o Java Runtime Environment (JRE).

• Uma instalação de cliente Oracle deve incluir o seguinte:

  • SQL*Plus ou SQL Developer para tarefas de administração

  • Oracle Net Services, para configurar conexões com a instância de banco de dados do RDS para Oracle

Observe as seguintes limitações para APEX e ORDS:

• Não é possível usar um CDB do RDS para Oracle com o ORDS v22 e posterior. Uma alternativa é usar uma versão anterior do ORDS ou usar um Oracle Database 19c não CDB.

Adicionar as opções APEX e APEX-DEV

Para adicionar as opções de APEX e APEX-DEV a uma instância de banco de dados, faça o seguinte:

1. Crie um novo grupo de opções, ou copie ou modifique um existente.

2. Adicione as opções APEX e APEX-DEV ao grupo de opções.

3. Associe o grupo de opções à instância de banco de dados.

Quando você adiciona as opções do APEX do Amazon RDS, ocorre uma breve interrupção enquanto sua instância de banco de dados é reiniciada automaticamente.

nota

APEX_MAIL está disponível quando a opção APEX está instalada. O privilégio de execução referente ao pacote APEX_MAIL é concedido a PUBLIC. Portanto, você não precisa da conta administrativa do APEX para usá-lo.

Para adicionar as opções do APEX a uma instância do banco de dados

1. Determine o grupo de opções que você deseja usar. Você pode criar um novo grupo de opções ou usar um existente. Se você quiser usar um grupo de opções existente, vá para a próxima etapa. Caso contrário, crie um grupo de opções de banco de dados personalizado com as seguintes configurações:

   1. Para Engine (Mecanismo), escolha a edição do Oracle que deseja usar. As opções do APEX são compatíveis em todas as edições.

   2. Para Major engine version (Versão do mecanismo principal), escolha a versão da sua instância de banco de dados.

   Para ter mais informações, consulte Criar um grupo de opções.

2. Adicione opções ao grupo de opções. Se você quiser implantar somente o ambiente em tempo de execução do Oracle APEX, adicione apenas a opção APEX. Se você quiser implantar o ambiente de desenvolvimento completo, adicione as opções APEX e APEX-DEV. Para o Oracle Database 12c, adicione as opções APEX e APEX-DEV.

   Em Version (Versão), escolha a versão do APEX que você deseja usar. A versão 4.2.6.v1 é o padrão para o Oracle Database 12c, caso você não escolha uma versão.

   Importante

   Se você adiciona as opções do APEX a um grupo de opções existente que já está anexado a uma ou mais instâncias de banco de dados, ocorrerá uma breve interrupção. Durante essa interrupção, todas as instâncias de banco de dados são automaticamente reiniciadas.

   Para mais informações sobre a adição de opções, consulte Adicionar uma opção a um grupo de opções.

3. Aplique o grupo de opções a uma instância de banco de dados nova ou existente:

   • Para uma nova instância de banco de dados, você aplica o grupo de opções ao executar a instância. Para ter mais informações, consulte Criar uma instância de banco de dados do Amazon RDS.

   • Para uma instância de banco de dados existente, você aplica o grupo de opções modificando a instância e anexando o novo grupo de opções. Quando você adiciona as opções do APEX a uma instância de banco de dados existente, ocorre uma breve interrupção enquanto sua instância de banco de dados é reiniciada automaticamente. Para ter mais informações, consulte Modificar uma instância de banco de dados do Amazon RDS.

Desbloquear a conta de usuário público

Depois que as opções de APEX do Amazon RDS forem instaladas, faça o seguinte:

1. Altere a senha da conta de usuário público do APEX.

2. Desbloqueie a conta.

Você pode fazer isso usando o utilitário de linha de comando Oracle SQL*Plus. Conecte-se à sua instância de banco de dados como usuário principal e emita os comandos a seguir. Substitua new_password por uma senha da sua escolha.

ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password;
ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK;

Configuração de serviços RESTful para o Oracle APEX

Para configurar serviços RESTful no APEX (não necessário para o APEX 4.1.1.V1), use o SQL*Plus para se conectar à sua instância de banco de dados como usuário mestre. Depois que você fizer isso, execute o procedimento armazenado rdsadmin.rdsadmin_run_apex_rest_config. Ao executar o procedimento armazenado, você fornece senhas para os seguintes usuários:

• APEX_LISTENER

• APEX_REST_PUBLIC_USER

O procedimento armazenado executa o script apex_rest_config.sql que cria novas contas de banco de dados para esses usuários.

nota

A configuração não é obrigatória para o Oracle APEX versão 4.1.1.v1. Apenas para esta versão Oracle APEX, você não precisa executar o procedimento armazenado.

O comando a seguir executa o procedimento armazenado.

EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password');

Configurar o ORDS para Oracle APEX

Agora você está pronto para instalar e configurar o Oracle Rest Data Services (ORDS) para uso com o Oracle APEX. Para o APEX versão 5.0 e posterior, use o Oracle Rest Data Services (ORDS) versão 19.1 e posterior.

Instale o listener em um host separado como uma instância do Amazon EC2 em um servidor no local na sua empresa ou no seu computador desktop. Para os exemplos desta seção, vamos supor que o nome do host seja myapexhost.example.com e que o host esteja executando o Linux.

Preparar-se para instalar o ORDS

Antes de instalar o ORDS, é necessário criar um usuário de SO não privilegiado e, depois, baixar e descompactar o arquivo de instalação do APEX.

Como se preparar para a instalação do ORDS

1. Faça login em myapexhost.example.com como root.

2. Crie um usuário de SO sem privilégios para ser o proprietário da instalação do listener. O comando a seguir cria um novo usuário chamado apexuser.

   useradd -d /home/apexuser apexuser

   O comando a seguir atribui uma senha ao novo usuário.

   passwd apexuser;

3. Faça login em myapexhost.example.com como apexuser e baixe o arquivo de instalação APEX do Oracle no diretório /home/apexuser:

   • http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html

   • Oracle application Express prior release archives

4. Descompacte o arquivo no diretório /home/apexuser.

   unzip apex_<version>.zip

   Depois que você descompactar o arquivo, haverá um diretório apex no diretório /home/apexuser.

5. Enquanto você ainda está conectado no myapexhost.example.com como apexuser, baixe o arquivo do Oracle REST Data Services no diretório /home/apexuser: http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html.

Instalar e configurar o ORDS

Antes de usar o APEX, é necessário baixar o arquivo ords.war, usar o Java para instalar o ORDS e iniciar o listener.

Para instalar e configurar o ORDS para usar com o Oracle APEX

1. Crie um diretório baseado no ORDS e descompacte o arquivo do listener.

   mkdir /home/apexuser/ORDS
   cd /home/apexuser/ORDS

2. Baixe o arquivo ords.version.number.zip de Serviços de dados Oracle REST.

3. Descompacte o arquivo no diretório /home/apexuser/ORDS.

4. Se você estiver instalando ORDS em um banco de dados multilocativo, adicione a seguinte linha ao arquivo /home/apexuser/ORDS/params/ords_params.properties:

   pdb.disable.lockdown=false

5. Conceda ao usuário mestre os privilégios necessários para instalar o ORDS.

   Depois que a opção APEX do Amazon RDS for instalada, conceda ao usuário mestre os privilégios necessários para instalar o esquema do ORDS. É possível fazer isso conectando-se ao banco de dados e executando os comandos a seguir. Substitua MASTER_USER pelo nome do seu usuário mestre em letras maiúsculas.

   Importante

   Ao inserir o nome de usuário, use letras maiúsculas, a menos que você tenha criado o usuário com um identificador que diferencia letras maiúsculas de minúsculas. Por exemplo, se você executar CREATE USER myuser ou CREATE USER MYUSER, o dicionário de dados armazenará MYUSER. No entanto, se você usar aspas duplas em CREATE USER "MyUser", o dicionário de dados armazenará MyUser. Para ter mais informações, consulte Concessão de privilégios SELECT ou EXECUTE a objetos SYS.

   exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_OBJECTS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_ROLE_PRIVS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONS_COLUMNS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('USER_CONSTRAINTS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('USER_OBJECTS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('USER_PROCEDURES', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TAB_COLUMNS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('USER_TABLES', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('USER_VIEWS', 'MASTER_USER', 'SELECT', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('WPIUTL', 'MASTER_USER', 'EXECUTE', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SESSION', 'MASTER_USER', 'EXECUTE', true);
   exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_UTILITY', 'MASTER_USER', 'EXECUTE', true);

   nota

   Esses comandos se aplicam ao ORDS versão 19.1 e posterior.

6. Instale o esquema do ORDS usando o arquivo ords.war baixado.

   java -jar ords.war install advanced

   O prompt do programa solicitará as informações a seguir. Os valores padrão estão entre colchetes. Para ter mais informações, consulte o tópico de Introdução ao Oracle REST Data Services, na documentação da Oracle.

   • Insira o local para armazenar dados de configuração:

     Insira /home/apexuser/ORDS. Este é o local dos arquivos de configuração do ORDS.

   • Especifique o tipo de conexão do banco de dados a ser usado. Digite o número para [1] Basic [2] TNS [3] URL personalizado [1]:

     Escolha o tipo de conexão desejada.

   • Insira o nome do servidor de banco de dados [localhost]: DB_instance_endpoint

     Escolha o padrão ou insira o valor correto.

   • Insira a porta do listener do banco de dados [1521]: db_instance_port

     Escolha o padrão ou insira o valor correto.

   • Digite 1 para especificar o nome de serviço do banco de dados ou 2 para especificar o SID do banco de dados [1]:

     Escolha 2 para especificar o SID do banco de dados.

   • SID do banco de dados [xe]

     Escolha o padrão ou insira o valor correto.

   • Digite 1 se desejar verificar/instalar o esquema do Oracle REST Data Services ou 2 para pular esta etapa [1]:

     Selecione 1. Esta etapa cria o usuário proxy do Oracle REST Data Services chamado ORDS_PUBLIC_USER.

   • Digite a senha do banco de dados para ORDS_PUBLIC_USER:

     Digite a senha e confirme-a.

   • Requer login com privilégios de administrador para verificar o esquema do Oracle REST Data Services.

     Insira o nome do usuário administrador: master_user

     Insira a senha do banco de dados para master_user: master_user_password

     Confirme a senha: master_user_password

     nota

     Especifique uma senha diferente do prompt mostrado aqui como prática recomendada de segurança.

   • Insira o espaço de tabela padrão para ORDS_METADATA [SYSAUX].

     Insira o espaço de tabela temporário para ORDS_METADATA [TEMP].

     Insira o espaço de tabela padrão para ORDS_PUBLIC_USER [USERS].

     Insira o espaço de tabela temporário para ORDS_PUBLIC_USER [TEMP].

   • Insira 1 se quiser usar o gateway PL/SQL ou 2 para ignorar essa etapa. Se você está usando o Oracle Application Express ou migrando do mod_plsql, deve inserir 1 [1].

     Escolha o padrão.

   • Insira o nome de usuário de banco de dados do gateway PL/SQL [APEX_PUBLIC_USER]

     Escolha o padrão.

   • Digite a senha do banco de dados para APEX_PUBLIC_USER:

     Digite a senha e confirme-a.

   • Digite 1 para especificar senhas para usuários de banco de dados de serviços RESTful do Application Express (APEX_LISTENER, APEX_REST_PUBLIC_USER) ou 2 para pular esta etapa [1]:

     Escolha 2 para APEX 4.1.1.V1; escolha 1 para todas as outras versões de APEX.

   • [Não necessário para o APEX 4.1.1.v1] Senha de banco de dados para APEX_LISTENER

     Digite a senha (se necessário) e confirme-a.

   • [Não necessário para o APEX 4.1.1.v1] Senha de banco de dados para APEX_REST_PUBLIC_USER

     Digite a senha (se necessário) e confirme-a.

   • Digite um número para selecionar um recurso a ser ativado:

     Digite 1 para habilitar todos os recursos: SQL Developer Web, SQL habilitado para REST e API de banco de dados.

   • Digite 1 se desejar iniciar no modo independente ou 2 para sair [1]:

     Digite 1.

   • Insira o local dos recursos estáticos do APEX:

     Se você descompactou os arquivos de instalação do APEX em /home/apexuser, insira /home/apexuser/apex/images. Caso contrário, digite unzip_path/apex/images, onde unzip_path é o diretório onde você descompactou o arquivo.

   • Digite 1 se estiver usando HTTP ou 2 se estiver usando HTTPS [1]:

     Se você digitar 1, especifique a porta HTTP. Se você digitar 2, especifique a porta HTTPS e o nome do host SSL. A opção HTTPS solicita que você especifique como fornecerá o certificado:

     • Digite 1 para usar o certificado autoassinado.

     • Digite 2 para fornecer seu próprio certificado. Se você inserir 2, especifique o caminho para o certificado SSL e o caminho para a chave privada do certificado SSL.

7. Defina uma senha para o usuário admin do APEX. Para fazer isso, use o SQL*Plus para conectar à sua instância de banco de dados como o usuário principal e execute os comandos a seguir.

   EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
   grant APEX_ADMINISTRATOR_ROLE to master;
   @/home/apexuser/apex/apxchpwd.sql

   Substitua master pelo seu nome de usuário principal. Quando o script apxchpwd.sql solicitar, insira uma nova senha admin.

8. Inicie o listener do ORDS. Execute o código a seguir.

   java -jar ords.war

   Na primeira vez que iniciar o ORDS, você será solicitado a fornecer a localização dos recursos estáticos do APEX. Essa pasta de imagens está localizada no diretório /apex/images do diretório de instalação do APEX.

9. Volte para a janela de administração do APEX no navegador e escolha Administration (Administração). Em seguida, escolha Application Express Internal Administration (Administração interna do Application Express). Quando forem solicitadas as credenciais, insira as seguintes informações:

   • Nome de usuário – admin

   • Senha – a senha configurada com o script apxchpwd.sql

   Escolha Login (Fazer login) e, em seguida, defina uma nova senha para o usuário admin.

Agora o listener está pronto para ser usado.

Configurar o Oracle APEX Listener

nota

O Oracle APEX Listener está defasado.

O Amazon RDS for Oracle continua a oferecer suporte ao APEX versão 4.1.1 e ao Oracle APEX Listener versão 1.1.4. Recomendamos que você use as versões com suporte mais recentes do Oracle APEX e do ORDS.

Instale o Oracle APEX Listener em um host separado, como uma instância do Amazon EC2, um servidor local na sua empresa ou seu computador desktop. Supomos que o nome do host é myapexhost.example.com e o seu host está sendo executado em Linux.

Preparar-se para instalar o Oracle APEX Listener

Antes de instalar o Oracle APEX Listener, é necessário criar um usuário de SO não privilegiado e, depois, baixar e descompactar o arquivo de instalação do APEX.

Como se preparar para a instalação do Oracle APEX Listener

1. Faça login em myapexhost.example.com como root.

2. Crie um usuário de SO sem privilégios para ser o proprietário da instalação do listener. O comando a seguir cria um novo usuário chamado apexuser.

   useradd -d /home/apexuser apexuser

   O comando a seguir atribui uma senha ao novo usuário.

   passwd apexuser;

3. Faça login em myapexhost.example.com como apexuser e baixe o arquivo de instalação APEX do Oracle no diretório /home/apexuser:

   • http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html

   • Oracle application Express prior release archives

4. Descompacte o arquivo no diretório /home/apexuser.

   unzip apex_<version>.zip                

   Depois que você descompactar o arquivo, haverá um diretório apex no diretório /home/apexuser.

5. Enquanto ainda estiver conectado ao myapexhost.example.com como apexuser, baixe o arquivo do Oracle APEX Listener no diretório /home/apexuser.

Instalar e configurar o Oracle APEX Listener

Antes de usar o APEX, é necessário baixar o arquivo apex.war, usar o Java para instalar o Oracle APEX Listener e iniciar o listener.

Como instalar e configurar o Oracle APEX Listener

1. Crie um diretório baseado no Oracle APEX Listener e abra o arquivo do listener.

   Execute o seguinte código:

   mkdir /home/apexuser/apexlistener
   cd /home/apexuser/apexlistener 
   unzip ../apex_listener.version.zip

2. Execute o código a seguir.

   java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war

3. Insira as seguintes informações para os prompts do programa:

   • O nome de usuário do administrador do APEX Listener. O padrão é adminlistener.

   • A senha para o administrador do APEX Listener.

   • O nome de usuário do gerente do APEX Listener. O padrão é managerlistener.

   • A senha para o administrador do APEX Listener.

   O programa imprime um URL necessário para concluir a configuração, conforme mostrado a seguir:

   INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure
   Database is not yet configured 

4. Deixe o Oracle APEX Listener em execução para que você possa usar o Oracle Application Express. Quando você concluir o procedimento de configuração, poderá executar o ouvinte em segundo plano.

5. No navegador, acesse o URL fornecido pelo programa APEX Listener. A janela de administração do Oracle Application Express Listener é exibida. Insira as seguintes informações:

   • Nome de usuário – APEX_PUBLIC_USER

   • Senha – a senha de APEX_PUBLIC_USER. Esta é a senha que você especificou anteriormente quando configurou o repositório do APEX. Para ter mais informações, consulte Desbloquear a conta de usuário público.

   • Tipo de conexão – básica

   • Nome de host – o endpoint da instância de banco de dados do Amazon RDS, como mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com.

   • Porta – 1521

   • SID – o nome do banco de dados na sua instância de banco de dados do Amazon RDS, como mydb.

6. Escolha Apply (Aplicar). A janela de administração do APEX é exibida.

7. Defina uma senha para o usuário admin do APEX. Para fazer isso, use o SQL*Plus para conectar à sua instância de banco de dados como o usuário principal e execute os comandos a seguir.

   EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role;
   grant APEX_ADMINISTRATOR_ROLE to master;
   @/home/apexuser/apex/apxchpwd.sql

   Substitua master pelo seu nome de usuário principal. Quando o script apxchpwd.sql solicitar, insira uma nova senha admin.

8. Volte para a janela de administração do APEX no navegador e escolha Administration (Administração). Em seguida, escolha Application Express Internal Administration (Administração interna do Application Express). Quando forem solicitadas as credenciais, insira as seguintes informações:

   • Nome de usuário – admin

   • Senha – a senha configurada com o script apxchpwd.sql

   Escolha Login (Fazer login) e, em seguida, defina uma nova senha para o usuário admin.

Agora o listener está pronto para ser usado.

Atualizar a versão do APEX

Importante

Faça o backup da sua instância de banco de dados antes de atualizar o APEX. Para ter mais informações, consulte Criar um snapshot de banco de dados para uma instância de banco de dados de uma única zona de disponibilidade e Testar uma atualização do Oracle DB.

Para atualizar o APEX com a sua instância de banco de dados, faça o seguinte:

• Crie um novo grupo de opções para a versão atualizada da instância de banco de dados.

• Adicione as versões atualizadas de APEX e de APEX-DEV ao novo grupo de opções. Inclua todas as outras opções usadas pela instância de banco de dados. Para ter mais informações, consulte Considerações de grupos de opções.

• Quando você atualizar a instância de banco de dados, especifique o novo grupo de opções para a instância de banco de dados atualizada.

Depois que você atualizar a versão do APEX, o esquema do APEX da versão anterior ainda poderá existir no banco de dados. Se não precisar mais dele, você poderá ignorar o esquema do APEX anterior do banco de dados depois da atualização.

Se você atualizar a versão do APEX e os serviços RESTful não tiverem sido configurados na versão anterior do APEX, recomendamos que configure os serviços RESTful. Para ter mais informações, consulte Configuração de serviços RESTful para o Oracle APEX.

Em alguns casos, quando você planeja fazer uma atualização de versão principal de sua instância de banco de dados, talvez descubra que está usando uma versão do APEX que não é compatível com a versão do banco de dados de destino. Nesses casos, você pode atualizar sua versão do APEX antes de atualizar sua instância de banco de dados. Atualizar o APEX primeiro pode reduzir o tempo necessário para atualizar a instância de banco de dados.

nota

Depois de fazer o upgrade do APEX, instale e configure um ouvinte para uso com a versão atualizada. Para obter instruções, consulte Configurar o Oracle APEX Listener.

Remover a opção APEX

Você pode remover as opções do APEX do Amazon RDS de uma instância de banco de dados. Para remover as opções APEX de uma instância de banco de dados, siga um destes procedimentos:

• Para remover as opções APEX de várias instâncias de banco de dados, remova as opções APEX do grupo de opções a que elas pertencem. Essa alteração afeta todas as instâncias de bancos de dados que usam o grupo de opções. Quando você remove as opções APEX de um grupo de opções existente anexado a várias instâncias de banco de dados, ocorre uma breve interrupção enquanto todas as instâncias do banco de dados são reiniciadas.

  Para ter mais informações, consulte Remover uma opção de um grupo de opções.

• Para remover as opções APEX de uma única instância do banco de dados, modifique a instância do banco de dados e especifique um grupo de opções diferente que não inclui as opções APEX. Você pode especificar um grupo de opções padrão (vazio) ou criar um grupo de opções personalizado diferente. Quando você remove as opções APEX, ocorre uma breve interrupção enquanto sua instância de banco de dados é reiniciada automaticamente.

  Para ter mais informações, consulte Modificar uma instância de banco de dados do Amazon RDS.

Quando você remove as opções do APEX de uma instância de banco de dados, o esquema do APEX é removido do banco de dados.