# 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 tempo 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](https://apex.oracle.com/) na documentação da Oracle. **Topics** + [ ## Componentes do Oracle APEX ](#Appendix.Oracle.Options.APEX.components) + [ # Requisitos e limitações ](Appendix.Oracle.Options.APEX.Requirements.md) + [ # Configurar o Oracle APEX e o Oracle Rest Data Services (ORDS) ](Appendix.Oracle.Options.APEX.settingUp.md) + [ # Configurar o Oracle Rest Data Services (ORDS) ](Appendix.Oracle.Options.APEX.ORDSConf.md) + [ # Atualizar e remover o Oracle APEX ](Appendix.Oracle.Options.APEX.UpgradeandRemove.md) ## Componentes do Oracle APEX O Oracle APEX consiste nos seguintes componentes principais: + Um *repositório* que armazena metadados para aplicações e componentes do 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 Oracle 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 Oracle 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 incorporado como um listener do Oracle 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](https://docs.oracle.com/database/apex-5.1/HTMIG/choosing-web-listener.htm#HTMIG29321) (Sobre escolher um listener da Web) na documentação do Oracle. Ao adicionar as opções `APEX` e `APEX-DEV` à 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 e limitações O tópico a seguir lista os requisitos e limitações para o Oracle APEX e o ORDS. ## Requisitos de versão do Oracle APEX A opção `APEX` usa armazenamento na classe de instância de banco de dados para 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 do Oracle APEX | Requisitos de armazenamento | Versões compatíveis do Oracle Database | Observações | | --- | --- | --- | --- | | Oracle APEX versão 24.2.v1 | 114 MiB | Todos | Esta versão inclui o patch 37885097: PACOTE DO PSE PARA APEX 24.2 (PSES SOBRE 24.2.0), PATCH\$1VERSION 4. | | Oracle APEX versão 24.1.v1 | 112 MiB | Todos | Esta versão inclui o patch 36695709: PSE BUNDLE FOR APEX 24.1 (PSES ON TOP OF 24.1.0), PATCH\$1VERSION 3. Se você precisar instalar exatamente a mesma versão de imagens do APEX em sua instância do EC2, baixe o Patch 37544819: 24.1.3 PSE BUNDLE FOR APEX 24.1 (PSES ON TOP OF 24.1.0). | | Oracle APEX versão 23.2.v1 | 110 MiB | Todos | Esta versão inclui o patch 35895964: PACOTE DE PSEs PARA APEX 23.2 (PSEs ACIMA DE 23.2.0), PATCH\$1VERSION 6. Se você precisar instalar exatamente a mesma versão de imagens do APEX em sua instância do EC2, baixe o Patch 37593125: 23.2.6 PSE BUNDLE FOR APEX 23.2 (PSES ON TOP OF 23.2.0). | | Oracle APEX versão 23.1.v1 | 106 MiB | Todos | Esta versão inclui o patch 35283657: PSE BUNDLE FOR APEX 23.1 (PSES ACIMA DE 23.1.0), PATCH\$1VERSION 2. | | Oracle APEX versão 22.2.v1 | 106 MiB | Todos | Esta versão inclui o patch 34628174: PACOTE DO PSE PARA APEX 22.2 (PSES SOBRE 22.2.0), PATCH\$1VERSION 4. | | Oracle APEX versão 22.1.v1 | 124 MiB | Todos | Esta versão inclui o patch 34020981: PACOTE DO PSE PARA APEX 22.1 (PSES SOBRE 22.1.0), PATCH\$1VERSION 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\$1VERSION 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\$1VERSÃO 3. | | Oracle APEX versão 20.2.v1 | 148 MiB | Todas, exceto Oracle Database 21c | Esta versão inclui o patch 32006852: PACOTE PSE PARA APEX 20.2, PATCH\$1VERSÃ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 Oracle Database 21c | Esta versão inclui o patch 30990551: PACOTE PSE PARA APEX 20.1, PATCH\$1VERSÃO 2020.07.15. | | Oracle APEX versão 19.2.v1 | 149 MiB | Todas, exceto Oracle Database 21c | | | Oracle APEX versão 19.1.v1 | 148 MiB | Todas, exceto Oracle Database 21c | | Com relação a arquivos .zip do Oracle APEX que podem ser baixados, consulte [Oracle APEX Prior Release Archives](https://www.oracle.com/tools/downloads/apex-all-archives-downloads.html) no site da Oracle. ## Pré-requisitos para Oracle APEX e ORDS Observe os seguintes pré-requisitos para usar o Oracle APEX e o ORDS: + O sistema precisa usar o Ambiente de Execução Java (JRE). + Uma instalação de cliente Oracle deve incluir o seguinte: + SQL\$1Plus 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 ## Limitações do Oracle APEX Você não pode modificar a conta de usuário `APEX_version`, que é gerenciada pelo Amazon RDS. Portanto, você não pode aplicar perfis de banco de dados nem impor regras de senha a esse usuário. Os perfis e as configurações de senha para `APEX_version` são predefinidos pela Oracle e pela AWS e projetados para satisfazer os requisitos de segurança do Amazon RDS. # Configurar o Oracle APEX e o Oracle Rest Data Services (ORDS) O tópico a seguir lista as etapas necessárias para configurar o Oracle APEX e o ORDS. **Topics** + [ ## Adicionar as opções APEX e APEX-DEV à sua instância de banco de dados ](#Appendix.Oracle.Options.APEX.Add) + [ ## Desbloquear a conta de usuário público em sua instância de banco de dados ](#Appendix.Oracle.Options.APEX.PublicUser) + [ ## Configuração de serviços RESTful para o Oracle APEX ](#Appendix.Oracle.Options.APEX.ConfigureRESTful) + [ ## Preparar-se para instalar o ORDS em um host separado ](#Appendix.Oracle.Options.APEX.ORDS.ords-setup) + [ ## Configurar o Oracle APEX Listener ](#Appendix.Oracle.Options.APEX.Listener) ## Adicionar as opções APEX e APEX-DEV à sua instância de banco de dados Para adicionar as opções `APEX` e `APEX-DEV` à instância de banco de dados do RDS para Oracle, faça o seguinte: 1. Crie um novo grupo de opções, ou copie ou modifique um existente. 1. Adicione as opções `APEX` e `APEX-DEV` ao grupo de opções. 1. Associe o grupo de opções à instância de banco de dados. Quando você adiciona as opções `APEX` e `APEX-DEV`, ocorre uma breve interrupção enquanto a 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. **Como adicionar as opções APEX e APEX-DEV à instância de 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 `APEX` e `APEX-DEV` podem usadas em todas as edições. 1. 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](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 1. Adicione opções ao grupo de opções. Se você quiser implantar somente o ambiente de tempo de execução do Oracle APEX, adicione apenas a opção `APEX`. Para implantar o ambiente de desenvolvimento completo, adicione as opções `APEX` e `APEX-DEV`. Em **Versão**, escolha a versão do Oracle APEX que você deseja usar. **Importante** Se você adicionar as opções `APEX` e `APEX-DEV` a um grupo de opções existente que já esteja 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](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). 1. 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](USER_CreateDBInstance.md). + 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 `APEX` e `APEX-DEV` a uma instância de banco de dados existente, ocorre uma breve interrupção enquanto a instância de banco de dados é reiniciada automaticamente. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). ## Desbloquear a conta de usuário público em sua instância de banco de dados Depois que as opções `APEX` e `APEX-DEV` da instância de banco de dados forem instaladas, faça o seguinte: 1. Altere a senha para a conta `APEX_PUBLIC_USER`. 1. Desbloqueie a conta. Você pode fazer isso usando o utilitário de linha de comando Oracle SQL\$1Plus. 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. ``` 1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password; 2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK; ``` ## Configuração de serviços RESTful para o Oracle APEX Para configurar serviços RESTful no Oracle APEX (não necessário para o Oracle APEX 4.1.1.V1), use o SQL\$1Plus para se conectar à instância de banco de dados como usuário principal. 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. ``` 1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password'); ``` ## Preparar-se para instalar o ORDS em um host separado Instale o ORDS em um host separado, como uma instância do Amazon EC2 em um servidor on-premises na sua empresa ou no seu computador desktop. Nos exemplos desta seção, suponha que o host execute Linux e tenha o nome `myapexhost.example.com`. 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 Oracle APEX. **Como se preparar para a instalação do ORDS** 1. Faça login em `myapexhost.example.com` como `root`. 1. 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; ``` 1. Faça login em `myapexhost.example.com` como `apexuser` e baixe o arquivo de instalação do Oracle APEX no Oracle no diretório `/home/apexuser`: + [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html) + [Oracle application Express prior release archives](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html) 1. 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`. 1. 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](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html). ## Configurar o Oracle APEX Listener **nota** O Oracle APEX Listener está defasado. O Amazon RDS para Oracle continua a oferecer suporte ao Oracle 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 Oracle APEX. **Como se preparar para a instalação do Oracle APEX Listener** 1. Faça login em `myapexhost.example.com` como `root`. 1. 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; ``` 1. Faça login em `myapexhost.example.com` como `apexuser` e baixe o arquivo de instalação do Oracle APEX no Oracle no diretório `/home/apexuser`: + [http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html](http://www.oracle.com/technetwork/developer-tools/apex/downloads/index.html) + [Oracle application Express prior release archives](http://www.oracle.com/technetwork/developer-tools/apex/downloads/all-archives-099381.html) 1. Descompacte o arquivo no diretório `/home/apexuser`. ``` unzip apex_.zip ``` Depois que você descompactar o arquivo, haverá um diretório `apex` no diretório `/home/apexuser`. 1. 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 Oracle 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 ``` 1. Execute o código a seguir. ``` java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war ``` 1. 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 ``` 1. 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. 1. No navegador, acesse o URL fornecido pelo programa Oracle 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\$1PUBLIC\$1USER*. Essa é a senha que você especificou anteriormente quando configurou o repositório do Oracle APEX. Para obter mais informações, consulte [Desbloquear a conta de usuário público em sua instância de banco de dados](#Appendix.Oracle.Options.APEX.PublicUser). + **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`. 1. Escolha **Apply (Aplicar)**. A janela de administração do Oracle APEX é exibida. 1. Defina uma senha para o usuário `admin` do Oracle APEX. Para fazer isso, use o SQL\$1Plus para conectar à sua instância de banco de dados como o usuário principal e execute os comandos a seguir. ``` 1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; 2. grant APEX_ADMINISTRATOR_ROLE to master; 3. @/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`. 1. Volte para a janela de administração do Oracle APEX no navegador e escolha **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 Rest Data Services (ORDS) O tópico a seguir lista as opções de configuração para o ORDS 21 e 22: **Topics** + [ ## Instalar e configurar o ORDS 21 e anterior ](#Appendix.Oracle.Options.APEX.ORDS) + [ ## Instalar e configurar o ORDS 22 e posterior ](#Appendix.Oracle.Options.APEX.ORDS22) ## Instalar e configurar o ORDS 21 e anterior Agora você está pronto para instalar e configurar o Oracle Rest Data Services (ORDS) para uso com o Oracle APEX. Em relação ao Oracle APEX versão 5.0 e posterior, use o ORDS versões 19.1 a 21. Para saber como instalar o ORDS 22 e posterior, consulte [Instalar e configurar o ORDS 22 e posterior](#Appendix.Oracle.Options.APEX.ORDS22). 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. **Como instalar e configurar o ORDS 21 e anterior para usar com o Oracle APEX** 1. Acesse [Oracle REST Data Services](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html) e examine o Readme. Verifique se você tem a versão necessária do Java instalada. 1. Crie um diretório para a instalação do ORDS. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Baixe o arquivo `ords.version.number.zip` de [Serviços de dados Oracle REST](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html). 1. Descompacte o arquivo no diretório `/home/apexuser/ORDS`. 1. 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 ``` 1. Conceda ao usuário mestre os privilégios necessários para instalar o ORDS. Depois que as opções para o Oracle APEX forem instaladas, conceda ao usuário principal 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](Appendix.Oracle.CommonDBATasks.TransferPrivileges.md). ``` 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. 1. 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](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/20.2/aelig/installing-REST-data-services.html#GUID-6F7B4E61-B730-4E73-80B8-F53299123730), 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\$1instance\$1endpoint* Escolha o padrão ou insira o valor correto. + Insira a porta do listener do banco de dados [1521]: *db\$1instance\$1port* 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\$1PUBLIC\$1USER. + Digite a senha do banco de dados para ORDS\$1PUBLIC\$1USER: 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\$1user* Insira a senha do banco de dados para *master\$1user*: *master\$1user\$1password* Confirme a senha: *master\$1user\$1password* **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\$1METADATA [SYSAUX]. Insira o espaço de tabela temporário para ORDS\$1METADATA [TEMP]. Insira o espaço de tabela padrão para ORDS\$1PUBLIC\$1USER [USERS]. Insira o espaço de tabela temporário para ORDS\$1PUBLIC\$1USER [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\$1plsql, deve inserir 1 [1]. Escolha o padrão. + Insira o nome de usuário de banco de dados do gateway PL/SQL [APEX\$1PUBLIC\$1USER] Escolha o padrão. + Digite a senha do banco de dados para APEX\$1PUBLIC\$1USER: 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\$1LISTENER, APEX\$1REST\$1PUBLIC\$1USER) 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\$1LISTENER 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\$1REST\$1PUBLIC\$1USER 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\$1path* é 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. 1. Defina uma senha para o usuário `admin` do APEX. Para fazer isso, use o SQL\$1Plus para conectar à sua instância de banco de dados como o usuário principal e execute os comandos a seguir. ``` 1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; 2. grant APEX_ADMINISTRATOR_ROLE to master; 3. @/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`. 1. 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. 1. Volte para a janela de administração do Oracle APEX no navegador e escolha **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. ## Instalar e configurar o ORDS 22 e posterior Agora você está pronto para instalar e configurar o Oracle Rest Data Services (ORDS) para uso com o Oracle APEX. Para os exemplos desta seção, vamos supor que o nome do host separado seja `myapexhost.example.com` e que o host esteja executando o Linux. As instruções do ORDS 22 são diferentes das instruções das versões anteriores. **Como instalar e configurar o ORDS 22 e posterior para usar com o Oracle APEX** 1. Acesse [Oracle REST Data Services](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html) e examine o Readme da versão do ORDS que você planeja baixar. Verifique se você tem a versão necessária do Java instalada. 1. Crie um diretório para a instalação do ORDS. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Baixe o arquivo `ords.version.number.zip` ou `ords-latest.zip` em [Oracle REST Data Services](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html). 1. Descompacte o arquivo no diretório `/home/apexuser/ORDS`. 1. Conceda ao usuário mestre os privilégios necessários para instalar o ORDS. Depois que a opção `APEX` for instalada, conceda ao usuário principal os privilégios necessários para instalar o esquema do ORDS. É possível fazer isso fazendo login no 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 obter mais informações, consulte [Concessão de privilégios SELECT ou EXECUTE a objetos SYS](Appendix.Oracle.CommonDBATasks.TransferPrivileges.md). ``` 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); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_LOB', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_ASSERT', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_OUTPUT', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SCHEDULER', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('HTP', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('OWA', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('WPG_DOCLOAD', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_CRYPTO', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_METADATA', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_SQL', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('UTL_SMTP', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBMS_NETWORK_ACL_ADMIN', 'MASTER_USER', 'EXECUTE', true); exec rdsadmin.rdsadmin_util.grant_sys_object('SESSION_PRIVS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_USERS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACL_PRIVILEGES', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_NETWORK_ACLS', 'MASTER_USER', 'SELECT', true); exec rdsadmin.rdsadmin_util.grant_sys_object('DBA_REGISTRY', 'MASTER_USER', 'SELECT', true); ``` **nota** Os comandos anteriores se aplicam ao ORDS 22 e posterior. 1. Instale o esquema do ORDS usando o script `ords` baixado. Especifique os diretórios para conter arquivos de configuração e arquivos de log. A Oracle Corporation recomenda não colocar esses diretórios dentro do diretório que contém o software do produto ORDS. ``` mkdir -p /home/apexuser/ords_config /home/apexuser/ords_logs /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config \ install --interactive --log-folder /home/apexuser/ords_logs ``` Em relação a instâncias de banco de dados que executam a arquitetura de banco de dados de contêiner (CDB), use o ORDS 23.e ou posterior e transmita o argumento `--pdb-skip-disable-lockdown` ao instalar o ORDS. ``` /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config \ install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown ``` 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](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/20.2/aelig/installing-REST-data-services.html#GUID-6F7B4E61-B730-4E73-80B8-F53299123730), na documentação da Oracle. + `Choose the type of installation:` Escolha **2** instalar esquemas do ORDS no banco de dados e criar um grupo de conexões de banco de dados nos arquivos de configuração do ORDS local. + `Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:` Escolha o tipo de conexão desejada. Este exemplo pressupõe que você escolha **1**. + `Enter the name of the database server [localhost]:` ***DB\$1instance\$1endpoint*** Escolha o padrão ou insira o valor correto. + `Enter the database listener port [1521]:` ***DB\$1instance\$1port*** Escolha o padrão **1521** ou insira o valor correto. + `Enter the database service name [orcl]:` Insira o nome do banco de dados usado pela instância de banco de dados do RDS para Oracle. + `Provide database user name with administrator privileges` Digite o nome do usuário mestre da instância de banco de dados do RDS para Oracle. + `Enter the database password for [username]:` Digite a senha do usuário mestre da instância de banco de dados do RDS para Oracle. + `Enter the default tablespace for ORDS_METADATA and ORDS_PUBLIC_USER [SYSAUX]:` + `Enter the temporary tablespace for ORDS_METADATA [TEMP]. Enter the default tablespace for ORDS_PUBLIC_USER [USERS]. Enter the temporary tablespace for ORDS_PUBLIC_USER [TEMP].` + `Enter a number to select additional feature(s) to enable [1]:` + `Enter a number to configure and start ORDS in standalone mode [1]: ` Escolha **2** para ignorar a inicialização do ORDS imediatamente no modo autônomo. + `Enter a number to select the protocol [1] HTTP` + `Enter the HTTP port [8080]:` + `Enter the APEX static resources location:` Insira o caminho para os arquivos de instalação do Oracle APEX (`/home/apexuser/apex/images`). 1. Defina uma senha para o usuário `admin` do Oracle APEX. Para fazer isso, use o SQL\$1Plus para conectar à sua instância de banco de dados como o usuário principal e execute os comandos a seguir. ``` 1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; 2. grant APEX_ADMINISTRATOR_ROLE to master; 3. @/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`. 1. Execute o ORDS no modo autônomo usando o script `ords` com o comando `serve`. Em relação a implantações de produção, pense em usar servidores de aplicações Java EE compatíveis, como Apache Tomcat ou Oracle WebLogic Server. Para ter mais informações, consulte [Deploying and Monitoring Oracle REST Data Services](https://docs.oracle.com/en/database/oracle/oracle-rest-data-services/23.1/ordig/deploying-and-monitoring-oracle-rest-data-services.html#GUID-6791F5DF-AC67-4885-BFFA-B80964C17EC9), na documentação do Oracle Database. ``` /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config serve \ --port 8193 \ --apex-images /home/apexuser/apex/images ``` Se o ORDS estiver em execução e não conseguir acessar a instalação do Oracle APEX, você poderá ver o erro a seguir, principalmente em instâncias que não sejam de CDB. ``` The procedure named apex_admin could not be accessed, it may not be declared, or the user executing this request may not have been granted execute privilege on the procedure, or a function specified by security.requestValidationFunction configuration property has prevented access. ``` Para corrigir esse erro, altere a função de validação de solicitação usada pelo ORDS executando o script `ords` com o comando `config`. Por padrão, o ORDS usa o procedimento `ords_util.authorize_plsql_gateway`, que só é compatível com instâncias do CDB. Em relação a instâncias que não sejam de CDB, é possível alterar esse procedimento para o pacote `wwv_flow_epg_include_modules.authorize`. Consulte a documentação do Oracle Database e do Oracle Support para conhecer as práticas recomendadas sobre como configurar a função de validação de solicitações adequada para seu caso de uso. 1. Volte para a janela de administração do Oracle APEX no navegador e escolha **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 e remover o Oracle APEX Para atualizar ou remover o Oracle APEX, siga as instruções neste tópico: **Topics** + [ ## Atualizar a versão do Oracle APEX ](#Appendix.Oracle.Options.APEX.Upgrade) + [ ## Remover as opções APEX e APEX-DEV ](#Appendix.Oracle.Options.APEX.Remove) ## Atualizar a versão do Oracle APEX **Importante** Faça backup da instância de banco de dados antes de atualizar o Oracle APEX. 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) e [Testar uma atualização do Oracle DB](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md). Para atualizar o Oracle APEX com 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 do `APEX` e `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](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG). + 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 Oracle APEX, o esquema do Oracle APEX da versão anterior ainda poderá estar no banco de dados. Se não precisar mais dele, após a atualização você poderá ignorar o esquema do Oracle APEX anterior de seu banco de dados. Se você atualizar a versão do Oracle APEX e os serviços RESTful não tiverem sido configurados na versão anterior do Oracle APEX, recomendamos que configure os serviços RESTful. Para obter mais informações, consulte [Configuração de serviços RESTful para o Oracle APEX](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.ConfigureRESTful). Em alguns casos, quando estiver pensando em fazer uma atualização de versão principal da instância de banco de dados, é possível que descubra que está usando uma versão do Oracle 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 Oracle APEX antes de atualizar a instância de banco de dados. Atualizar o Oracle APEX primeiro pode reduzir o tempo necessário para atualizar a instância de banco de dados. **nota** Depois de atualizar o Oracle APEX, instale e configure um receptor para ser usado com a versão atualizada. Para instruções, consulte [Configurar o Oracle APEX Listener](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.Listener). ## Remover as opções APEX e APEX-DEV Você pode remover as opções `APEX` e `APEX-DEV` de uma instância de banco de dados. Para remover as opções de uma instância de banco de dados, faça o seguinte: + Para remover as opções `APEX` e `APEX-DEV` de várias instâncias de bancos de dados, remova as opções do grupo de opções ao qual 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 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 obter mais informações, consulte [Remover uma opção de um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Para remover as opções `APEX` e `APEX-DEV` de uma única instância de banco de dados, modifique a instância e especifique um grupo de opções diferente que não inclua essas opções. 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, ocorre uma breve interrupção enquanto a instância de banco de dados é reiniciada automaticamente. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). Quando você remove as opções `APEX` e `APEX-DEV` de uma instância de banco de dados, o esquema do APEX é removido do banco de dados.