Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Oracle Application Express (APEX) Amazon RDS supporta Oracle Application Express (APEX) tramite l'utilizzo delle opzioni `APEX` e `APEX-DEV`. Puoi implementare Oracle APEX come ambiente di runtime o come ambiente di sviluppo completo per le applicazioni basate sul web. Utilizzando Oracle APEX, puoi compilare le applicazioni interamente all'interno del browser Web. Per ulteriori informazioni, consulta [Oracle Application Express](https://apex.oracle.com/) nella documentazione di Oracle. **Topics** + [Componenti di Oracle APEX](#Appendix.Oracle.Options.APEX.components) + [Requisiti e limitazioni](Appendix.Oracle.Options.APEX.Requirements.md) + [Configurazione di Oracle APEX e Oracle Rest Data Services (ORDS)](Appendix.Oracle.Options.APEX.settingUp.md) + [Configurazione di Oracle Rest Data Services (ORDS)](Appendix.Oracle.Options.APEX.ORDSConf.md) + [Aggiornamento e rimozione di Oracle APEX](Appendix.Oracle.Options.APEX.UpgradeandRemove.md) ## Componenti di Oracle APEX Oracle APEX è costituito dai seguenti componenti principali: + Un *repository* che archivia i metadati per i componenti e le applicazioni Oracle APEX. Il repository è formato da tabelle, indici e altri oggetti che sono installati nella tua istanza database Amazon RDS. + Un *listener* che gestisce le comunicazioni HTTP con i client Oracle APEX. L'ascoltatore risiede in un host separato, come un'istanza Amazon EC2, un server on-premise della tua azienda oppure il tuo computer desktop. Il listener accetta le connessioni in entrata dai browser Web, le inoltra all'istanza database Amazon RDS per l'elaborazione e quindi invia nuovamente i risultati dal repository ai browser. RDS per Oracle supporta i seguenti tipi di ascoltatori: + Per Oracle APEX versione 5.0 e successive, utilizza Oracle REST Data Services (ORDS) versione 19.1 e successive. Si consiglia di utilizzare la versione più recente supportata di Oracle APEX e ORDS. Questa documentazione descrive le versioni precedenti solo per la compatibilità con le versioni precedenti. + Per Oracle APEX versione 4.1.1, puoi utilizzare Oracle APEX Listener versione 1.1.4. + È possibile utilizzare Oracle HTTP Server e i listener `mod_plsql`. **Nota** Amazon RDS non supporta il server HTTP Oracle XML DB con il gateway PL/SQL integrato come listener per Oracle APEX. In generale, Oracle consiglia di utilizzare il gateway PL/SQL integrato per le applicazioni eseguite su Internet. Per ulteriori informazioni su questi tipi di listener, consulta [About Choosing a Web Listener](https://docs.oracle.com/database/apex-5.1/HTMIG/choosing-web-listener.htm#HTMIG29321) nella documentazione di Oracle. Quando aggiungi le opzioni `APEX` e `APEX-DEV` all’istanza database RDS per Oracle, Amazon RDS installa solo il repository Oracle APEX. Installa l'ascoltatore su un host separato. # Requisiti e limitazioni L’argomento seguente elenca i requisiti e le limitazioni per Oracle APEX e ORDS. ## Requisiti per la versione Oracle APEX L’opzione `APEX` utilizza l’archiviazione nella classe di istanza database per l’istanza database. Di seguito si riportano le versioni supportate e i requisiti di storage approssimativi per Oracle APEX. **** | Versione di Oracle APEX | Requisiti di storage | Versioni di Oracle Database supportate | Note | | --- | --- | --- | --- | | Oracle APEX versione 24.2.v1 | 114 MiB | Tutti | Questa versione include la patch 37885097: PACCHETTO PSE PER APEX 24.2 (PSES IN AGGIUNTA ALLA 24.2.0), PATCH\$1VERSION 4. | | Oracle APEX versione 24.1.v1 | 112 MiB | Tutti | Questa versione include la patch 36695709: PACCHETTO PSE PER APEX 24.1 (PSES IN AGGIUNTA ALLA 24.1.0), PATCH\$1VERSION 3. Se hai bisogno della stessa versione esatta di immagini APEX da installare sull’istanza EC2, scarica la patch 37544819: 24.1.3 PSE BUNDLE PER APEX 24.1 (PSES SU 24.1.0). | | Oracle APEX versione 23.2.v1 | 110 MiB | Tutti | Questa versione include la patch 35895964: PSE BUNDLE PER APEX 23.2 (PSES SU 23.2.0), PATCH\$1VERSION 6. Se hai bisogno della stessa versione esatta di immagini APEX da installare sull’istanza EC2, scarica la patch 37593125: 23.2.6 PSE BUNDLE PER APEX 23.2 (PSES SU 23.2.0). | | Oracle APEX versione 23.1.v1 | 106 MiB | Tutti | Questa versione include la patch 35283657: PSE BUNDLE FOR APEX 23.1 (PSES ON TOP OF 23.1.0), PATCH\$1VERSION 2. | | Oracle APEX versione 22.2.v1 | 106 MiB | Tutti | Questa versione include la patch 34628174: PSE BUNDLE FOR APEX 22.2 (PSES SU 22.2.0), PATCH\$1VERSION 4. | | Oracle APEX versione 22.1.v1 | 124 MiB | Tutti | Questa versione include la patch 34020981: PSE BUNDLE FOR APEX 22.1 (PSES SU 22.1.0), PATCH\$1VERSION 6. | | Oracle APEX versione 21.2.v1 | 125 MiB | Tutti | Questa versione include la patch 33420059: PSE BUNDLE FOR APEX 21.2 (PSES SU 21.2.0), PATCH\$1VERSION 8. | | Oracle APEX versione 21.1.v1 | 125 MiB | Tutti | Questa versione include la patch 32598392: PSE BUNDLE FOR APEX 21.1, PATCH\$1VERSION 3. | | Oracle APEX versione 20.2.v1 | 148 MiB | Tutti tranne Oracle Database 21c | Questa versione include la patch 32006852: PSE BUNDLE FOR APEX 20.2, PATCH\$1VERSION 2020.11.12. È possibile visualizzare il numero e la data della patch eseguendo la seguente query: 
SELECT PATCH_VERSION, PATCH_NUMBER 
FROM   APEX_PATCHES;
| | Oracle APEX versione 20.1.v1 | 173 MiB | Tutti tranne Oracle Database 21c | Questa versione include la patch 30990551: PSE BUNDLE FOR APEX 20.1, PATCH\$1VERSION 2020.07.15. | | Oracle APEX versione 19.2.v1 | 149 MiB | Tutti tranne Oracle Database 21c | | | Oracle APEX versione 19.1.v1 | 148 MiB | Tutti tranne Oracle Database 21c | | Per i file .zip Oracle APEX scaricabili, consulta [Oracle APEX Prior Release Archives](https://www.oracle.com/tools/downloads/apex-all-archives-downloads.html) sul sito web di Oracle. ## Prerequisiti per Oracle APEX e ORDS Di seguito sono indicati i prerequisiti per l’utilizzo di Oracle APEX e ORDS: + È necessario che il sistema utilizzi l’ambiente di runtime Java (JRE). + L'installazione client Oracle deve includere quanto segue: + SQL\$1Plus o SQL Developer per le attività di amministrazione + Oracle Net Services per la configurazione delle connessioni all'istanza database RDS per Oracle ## Limitazioni Oracle APEX Non puoi modificare l’account utente `APEX_version`, che è gestito da Amazon RDS. Pertanto, non puoi applicare profili di database né applicare regole delle password a questo utente. I profili e le impostazioni delle password per `APEX_version` sono predefiniti da Oracle AWS e sono progettati per soddisfare i requisiti di sicurezza di Amazon RDS. # Configurazione di Oracle APEX e Oracle Rest Data Services (ORDS) L’argomento seguente elenca i passaggi necessari per configurare Oracle APEX e ORDS **Topics** + [Aggiunta delle opzioni APEX e APEX-DEV all’istanza database](#Appendix.Oracle.Options.APEX.Add) + [Sblocco dell’account utente pubblico sull’istanza database](#Appendix.Oracle.Options.APEX.PublicUser) + [Configurazione dei RESTful servizi per Oracle APEX](#Appendix.Oracle.Options.APEX.ConfigureRESTful) + [Preparazione per installare ORDS su un host separato](#Appendix.Oracle.Options.APEX.ORDS.ords-setup) + [Impostazione del listener Oracle APEX](#Appendix.Oracle.Options.APEX.Listener) ## Aggiunta delle opzioni APEX e APEX-DEV all’istanza database Per aggiungere le opzioni `APEX` e `APEX-DEV` a un’istanza database di RDS per Oracle, esegui le operazioni indicate di seguito: 1. Creare un nuovo gruppo di opzioni oppure copiare o modificare un gruppo di opzioni esistente. 1. Aggiungi le opzioni `APEX` e `APEX-DEV` al gruppo di opzioni. 1. Associa il gruppo di opzioni a questa istanza database. Quando aggiungi le opzioni `APEX` e `APEX-DEV`, si verifica una breve interruzione mentre l’istanza database viene riavviata automaticamente. **Nota** `APEX_MAIL` è disponibile se l'opzione `APEX` è installata. Il privilegio di esecuzione per il pacchetto `APEX_MAIL` è concesso a `PUBLIC` e quindi non è necessario l'account amministrativo APEX per utilizzarlo. **Per aggiungere le opzioni APEX e APEX-DEV a un’istanza database** 1. Determinare il gruppo di opzioni che si vuole usare. È possibile creare un nuovo gruppo di opzioni oppure usare un gruppo di opzioni esistente. Se si desidera usare un gruppo di opzioni esistente, puoi passare alla fase successiva. In caso contrario, creare un gruppo di opzioni database personalizzato con le seguenti impostazioni: 1. Per **Engine (Motore)**, scegliere l'edizione di Oracle da utilizzare. Le opzioni `APEX` e `APEX-DEV` sono supportate in tutte le edizioni. 1. In **Major engine version (Versione principale del motore)**, scegliere la versione dell'istanza database. Per ulteriori informazioni, consulta [Creazione di un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 1. Aggiungere le opzioni al gruppo di opzioni. Per distribuire solo l’ambiente di runtime Oracle APEX aggiungi solo l’opzione `APEX`. Per distribuire l’ambiente di sviluppo completo, aggiungi entrambe le opzioni `APEX` e `APEX-DEV`. In **Versione**, scegli la versione di Oracle APEX che desideri utilizzare. **Importante** Se aggiungi le opzioni `APEX` o `APEX-DEV` a un gruppo di opzioni esistente già associato a una o più istanze database, si verifica una breve interruzione. Durante questa interruzione, tutte le istanze database vengono riavviate automaticamente. Per ulteriori informazioni sull'aggiunta di opzioni, consulta [Aggiunta di un'opzione a un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). 1. Applicare il gruppo di opzioni a un'istanza database nuova o esistente: + Per una nuova istanza database, si applica il gruppo di opzioni quando viene avviata l'istanza. Per ulteriori informazioni, consulta [Creazione di un'istanza database Amazon RDS](USER_CreateDBInstance.md). + Per un'istanza database esistente, viene applicato il gruppo di opzioni modificando l'istanza e collegando il nuovo gruppo di opzioni. Quando aggiungi le opzioni `APEX` o `APEX-DEV` a un’istanza database esistente, si verifica una breve interruzione mentre l’istanza database viene riavviata automaticamente. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md). ## Sblocco dell’account utente pubblico sull’istanza database Dopo aver installato le opzioni `APEX` o `APEX-DEV` sull’istanza database, assicurati di eseguire le operazioni indicate di seguito: 1. Modifica della password per l’account `APEX_PUBLIC_USER`. 1. Sbloccare l'account. Per farlo, utilizza l'utilità a riga di comando Oracle SQL\$1Plus. Connettiti alla tua istanza database come utente master e utilizza i seguenti comandi. Sostituisci `new_password` con una password a tua scelta. ``` 1. ALTER USER APEX_PUBLIC_USER IDENTIFIED BY new_password; 2. ALTER USER APEX_PUBLIC_USER ACCOUNT UNLOCK; ``` ## Configurazione dei RESTful servizi per Oracle APEX Per configurare RESTful i servizi in Oracle APEX (non necessari per Oracle APEX 4.1.1.v1), usa SQL\$1Plus per connetterti all'istanza DB come utente principale. Successivamente, esegui la stored procedure `rdsadmin.rdsadmin_run_apex_rest_config`. Quando esegui la stored procedure, fornisci le password per i seguenti utenti: + `APEX_LISTENER` + `APEX_REST_PUBLIC_USER` La stored procedure esegue lo script `apex_rest_config.sql`, che crea nuovi account database per questi utenti. **Nota** Oracle APEX versione 4.1.1.v1 non necessita configurazione. Per questa versione di Oracle APEX non devi eseguire la procedura archiviata. Il comando seguente avvia la procedura archiviata. ``` 1. EXEC rdsadmin.rdsadmin_run_apex_rest_config('apex_listener_password', 'apex_rest_public_user_password'); ``` ## Preparazione per installare ORDS su un host separato Installa ORDS in un host separato, come un’istanza Amazon EC2, un server on-premises nella tua azienda oppure il tuo computer desktop. Negli esempi riportati in questa sezione si suppone che l’host esegua Linux e sia denominato `myapexhost.example.com`. Prima di poter installare ORDS, è necessario creare un utente del sistema operativo senza privilegi, quindi scaricare e decomprimere il file di installazione Oracle APEX. **Per preparare l'installazione di ORDS** 1. Accedere a `myapexhost.example.com` come `root`. 1. Creare un utente del sistema operativo senza privilegi che possieda l'installazione del listener. Il comando seguente crea un nuovo utente denominato *apexuser*. ``` useradd -d /home/apexuser apexuser ``` Il seguente comando assegna una password al nuovo utente. ``` passwd apexuser; ``` 1. Accedi a `myapexhost.example.com` come `apexuser` e scarica il file di installazione Oracle APEX da Oracle e salvalo nella directory `/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. Decomprimi il file nella directory `/home/apexuser`. ``` unzip apex_version.zip ``` Dopo aver decompresso il file, troverai una directory `apex` nella directory `/home/apexuser`. 1. [Mentre sei ancora connesso`apexuser`, scarica il file Oracle REST Data Services da Oracle `/home/apexuser` nella tua directory: http://www.oracle. `myapexhost.example.com` com/technetwork/developer-tools/apex-listener/downloads/index.html.](http://www.oracle.com/technetwork/developer-tools/apex-listener/downloads/index.html) ## Impostazione del listener Oracle APEX **Nota** Il listener Oracle APEX è obsoleto. Amazon RDS per Oracle continua a supportare Oracle APEX versione 4.1.1 e Oracle APEX Listener versione 1.1.4. Si consiglia di utilizzare le versioni più recenti supportate di Oracle APEX e ORDS. Installa Oracle APEX Listener in un host separato, come un'istanza Amazon EC2, un server locale nella tua azienda oppure il tuo computer desktop. Ipotizziamo che il nome del tuo host sia `myapexhost.example.com` e che esegua Linux. ### Preparazione all'installazione del listener Oracle APEX Prima di installare il listener Oracle APEX, è necessario creare un utente del sistema operativo senza privilegi, quindi scaricare e decomprimere il file di installazione Oracle APEX. **Per preparare l'installazione del listener Oracle APEX** 1. Accedere a `myapexhost.example.com` come `root`. 1. Creare un utente del sistema operativo senza privilegi che possieda l'installazione del listener. Il comando seguente crea un nuovo utente denominato *apexuser*. ``` useradd -d /home/apexuser apexuser ``` Il seguente comando assegna una password al nuovo utente. ``` passwd apexuser; ``` 1. Accedi a `myapexhost.example.com` come `apexuser` e scarica il file di installazione Oracle APEX da Oracle e salvalo nella directory `/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. Decomprimi il file nella directory `/home/apexuser`. ``` unzip apex_.zip ``` Dopo aver decompresso il file, troverai una directory `apex` nella directory `/home/apexuser`. 1. Rimanendo collegato a `myapexhost.example.com` come `apexuser`, scarica il file di APEX Listener da Oracle e salvalo nella directory `/home/apexuser`: #### Installazione e configurazione del listener Oracle APEX Prima di poter utilizzare Oracle APEX, è necessario scaricare il file `apex.war`, utilizzare Java per installare il listener Oracle APEX e quindi avviare il listener. **Per installare e configurare il listener Oracle APEX** 1. Creare una nuova directory basata sul listener Oracle APEX e aprire il file listener: Eseguire il seguente codice: ``` mkdir /home/apexuser/apexlistener cd /home/apexuser/apexlistener unzip ../apex_listener.version.zip ``` 1. Eseguire il seguente codice. ``` java -Dapex.home=./apex -Dapex.images=/home/apexuser/apex/images -Dapex.erase -jar ./apex.war ``` 1. Il programma richiede le seguenti informazioni. + Nome dell'utente amministratore di APEX Listener. Il valore predefinito è *adminlistener*. + Una password per l'amministratore APEX Listener. + Nome dell'utente manager di APEX Listener. Il valore predefinito è *managerlistener*. + Una password per l'amministratore APEX Listener. Il programma stampa un URL necessario per completare la configurazione nel modo seguente: ``` INFO: Please complete configuration at: http://localhost:8080/apex/listenerConfigure Database is not yet configured ``` 1. Lasciare il listener Oracle APEX in esecuzione in modo da poter utilizzare Oracle Application Express. Al termine della procedura di configurazione è possibile eseguire il listener in background. 1. Dal browser web, accedere all’URL fornito dal programma Oracle APEX Listener. Viene visualizzata la finestra di amministrazione di Oracle Application Express Listener. Immettere le seguenti informazioni: + **Username (Nome utente** – `APEX_PUBLIC_USER` + **Password** – La password per *APEX\$1PUBLIC\$1USER*. La password è una di quelle specificate in precedenza durante la configurazione del repository Oracle APEX. Per ulteriori informazioni, consulta [Sblocco dell’account utente pubblico sull’istanza database](#Appendix.Oracle.Options.APEX.PublicUser). + **Connection Type (Tipo di connessione)** – Basic (Di base) + **Hostname (Nome host)** – Endpoint dell'istanza database Amazon RDS, ad esempio `mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com`. + **Port (Porta** – 1521 + **SID** – Nome del database nell'istanza database Amazon RDS, ad esempio `mydb`. 1. Scegliere **Apply (Applica)**. Viene visualizzata la finestra di amministrazione Oracle APEX. 1. Imposta una password per l’utente `admin` di Oracle APEX. Per farlo, utilizzare SQL\$1Plus per connettersi alla propria istanza database come utente master, quindi utilizzare i seguenti comandi: ``` 1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; 2. grant APEX_ADMINISTRATOR_ROLE to master; 3. @/home/apexuser/apex/apxchpwd.sql ``` Sostituire `master` con il proprio nome utente master. Quando lo script `apxchpwd.sql` lo richiede, inserire una nuova password `admin`. 1. Torna alla finestra di amministrazione Oracle APEX nel browser e scegli l’opzione **Administration**. Scegliere quindi **Application Express Internal Administration (Amministrazione interna Application Express)**. Quando vengono richieste le credenziali, inserire le seguenti informazioni: + **User name (Nome utente** – `admin` + **Password** – La password impostata usando lo script `apxchpwd.sql` Scegliere **Login (Accedi)**, quindi impostare una nuova password per l'utente `admin`. Il listener è ora pronto per essere utilizzato. # Configurazione di Oracle Rest Data Services (ORDS) L’argomento seguente illustra le opzioni di configurazione per ORDS 21 e 22: **Topics** + [Installazione e configurazione di ORDS 21 e versioni precedenti](#Appendix.Oracle.Options.APEX.ORDS) + [Installazione e configurazione di ORDS 22 e versioni successive](#Appendix.Oracle.Options.APEX.ORDS22) ## Installazione e configurazione di ORDS 21 e versioni precedenti È ora possibile installare e configurare Oracle Rest Data Services (ORDS) per l'utilizzo con Oracle APEX. Per Oracle APEX versione 5.0 e versioni successive, utilizza ORDS versioni da 19.1 a 21. Per informazioni su come installare ORDS 22 e versioni successive, consulta [Installazione e configurazione di ORDS 22 e versioni successive](#Appendix.Oracle.Options.APEX.ORDS22). Installa il listener in un host separato, come un'istanza Amazon EC2, un server locale nella tua azienda oppure il tuo computer desktop. Per gli esempi in questa sezione, supponiamo che il nome dell'host sia `myapexhost.example.com` e che l'host esegua Linux. **Per installare e configurare ORDS 21 e versioni precedenti per l’utilizzo con Oracle APEX** 1. Vai ai [Oracle REST data services](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html) ed esamina il file Readme. Verifica che sia installata la versione richiesta di Java. 1. Crea una nuova directory per l’installazione di ORDS. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Scarica il file `ords.version.number.zip` da [Oracle REST Data Services](https://www.oracle.com/database/technologies/appdev/rest-data-services-downloads-212.html). 1. Decomprimere il file nella directory `/home/apexuser/ORDS`. 1. Se stai installando ORDS in un database multilocazione, aggiunge la riga seguente al file `/home/apexuser/ORDS/params/ords_params.properties`: ``` pdb.disable.lockdown=false ``` 1. Concedere all'utente master i privilegi necessari per installare ORDS. Una volta installate le opzioni per Oracle APEX, concedi all’utente master i privilegi necessari per installare lo schema ORDS. Questa operazione può essere eseguita collegandosi al database ed eseguendo questi comandi: Sostituisci `MASTER_USER` con il nome in maiuscolo dell'utente master. **Importante** Quando si immette il nome utente, utilizzare maiuscole a meno che l'utente non sia stato creato con un identificatore con distinzione tra maiuscole e minuscole. Ad esempio, se esegui `CREATE USER myuser` o `CREATE USER MYUSER`, il dizionario dati memorizza `MYUSER`. Tuttavia, se si utilizzano virgolette doppie in `CREATE USER "MyUser"`, il dizionario dati memorizza `MyUser`. Per ulteriori informazioni, consulta [Concedere privilegi SELECT o EXECUTE agli oggetti 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** Questi comandi si applicano a ORDS versione 19.1 e successive. 1. Installare lo schema ORDS utilizzando il file scaricato ords.war. ``` java -jar ords.war install advanced ``` Il programma richiede le seguenti informazioni. I valori predefiniti sono riportati tra parentesi. Per altre informazioni, consulta l'articolo relativo a [Introduzione a 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) nella documentazione Oracle. + Destinazione di archiviazione dei dati di configurazione Specificare (sì */home/apexuser/ORDS*. Questa è la posizione dei file di configurazione di ORDS. + Specificare il tipo di connessione al database da utilizzare. Immettere il numero per [1] Basic [2] TNS [3] URL personalizzato [1]: Scegliere il tipo di connessione desiderato. + Immettete il nome del server del database [localhost]: *DB\$1instance\$1endpoint* Scegli il valore predefinito o digita il valore corretto. + Immettete la porta del listener del database [1521]: *DB\$1instance\$1port* Scegli il valore predefinito o digita il valore corretto. + Immettere 1 per specificare il nome del servizio di database o 2 per specificare il SID del database [1]: Scegliere `2` per specificare il SID del database. + SID del database [xe] Scegli il valore predefinito o digita il valore corretto. + Immettere 1 se si desidera utilizzare lo schema verify/install Oracle REST Data Services o 2 per saltare questo passaggio [1]: Scegliere `1`. Questo passaggio crea l'utente proxy di Oracle REST Data Services denominato ORDS\$1PUBLIC\$1USER. + Immettere la password del database per ORDS\$1PUBLIC\$1USER: Immettere la password, quindi confermarla. + Richiede l’accesso con i privilegi di amministratore per verificare lo schema Oracle REST Data Services. Immettere il nome utente dell'amministratore: *master\$1user* Inserisci la password del database per*master\$1user*: *master\$1user\$1password* Conferma la password: *master\$1user\$1password* **Nota** Specifica una password diversa dal prompt mostrato qui come best practice per la sicurezza. + Inserire lo spazio tabella predefinito per ORDS\$1METADATA [SYSAUX]. Inserire lo spazio tabella temporaneo per ORDS\$1METADATA [TEMP]. Inserire lo spazio tabella predefinito per ORDS\$1PUBLIC\$1USER [USERS]. Inserire lo spazio tabella temporaneo per ORDS\$1PUBLIC\$1USER [USERS]. + Inserisci 1 se desideri utilizzare PL/SQL Gateway o 2 per saltare questo passaggio. Se si sta utilizzando Oracle Application Express o si sta migrando da mod\$1plsql, inserire 1 [1]. Scegliere il valore predefinito. + Immettete il nome utente del database PL/SQL Gateway [APEX\$1PUBLIC\$1USER] Scegliere il valore predefinito. + Inserire la password del database per APEX\$1PUBLIC\$1USER Immettere la password, quindi confermarla. + Immettete 1 per specificare le password per gli utenti del database di Application Express RESTful Services (APEX\$1LISTENER, APEX\$1REST\$1PUBLIC\$1USER) o 2 per saltare questo passaggio [1]: Scegliere `2` per APEX 4.1.1.V1 oppure scegliere `1` per tutte le altre versioni di APEX. + [Non necessario per APEX 4.1.1.v1] Password di database per APEX\$1LISTENER Immettere la password (se necessario), quindi confermarla. + [Non necessario per APEX 4.1.1.v1] Password di database per APEX\$1REST\$1PUBLIC\$1USER Immettere la password (se necessario), quindi confermarla. + Immettere un numero per selezionare una funzione da abilitare: Immettere `1` per abilitare tutte le funzioni: SQL Developer Web, REST Enabled SQL e Database API. + Immettere 1 se si desidera avviare in modalità standalone o 2 per uscire [1]: Specificare (sì `1`. + Immettere l'ubicazione delle risorse statiche APEX: Se i file di installazione APEX sono stati decompressi in `/home/apexuser`, immettere `/home/apexuser/apex/images`. Altrimenti, inserisci, dov'è la directory in cui hai decompresso il file. `unzip_path/apex/images` *unzip\$1path* + Immettere 1 se si utilizza HTTP o 2 se si utilizza HTTPS [1]: Se si immette `1`, specificare la porta HTTP. Se si immette `2`, specificare la porta HTTPS e il nome host SSL. L'opzione HTTPS richiede di specificare come si fornirà il certificato: + Immettere `1` per utilizzare il certificato autofirmato. + Immettere `2` per fornire il proprio certificato. Se si immette `2`, specificare il percorso per il certificato SSL e il percorso per la chiave privata del certificato SSL. 1. Impostare una password per l'utente `admin` APEX. Per farlo, utilizzare SQL\$1Plus per connettersi alla propria istanza database come utente master, quindi utilizzare i seguenti comandi: ``` 1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; 2. grant APEX_ADMINISTRATOR_ROLE to master; 3. @/home/apexuser/apex/apxchpwd.sql ``` Sostituire `master` con il proprio nome utente master. Quando lo script `apxchpwd.sql` lo richiede, inserire una nuova password `admin`. 1. Avviare il listener ORDS. Eseguire il seguente codice. ``` java -jar ords.war ``` Al primo avvio dell'ORDS viene richiesto di fornire la posizione delle risorse statiche APEX. Questa cartella di immagini è posizionata nella directory `/apex/images` all’interno della directory di installazione per APEX. 1. Torna alla finestra di amministrazione Oracle APEX nel browser e scegli l’opzione **Administration**. Scegliere quindi **Application Express Internal Administration (Amministrazione interna Application Express)**. Quando vengono richieste le credenziali, inserire le seguenti informazioni: + **User name (Nome utente** – `admin` + **Password** – La password impostata usando lo script `apxchpwd.sql` Scegliere **Login (Accedi)**, quindi impostare una nuova password per l'utente `admin`. Il listener è ora pronto per essere utilizzato. ## Installazione e configurazione di ORDS 22 e versioni successive È ora possibile installare e configurare Oracle Rest Data Services (ORDS) per l'utilizzo con Oracle APEX. Per gli esempi in questa sezione, supponiamo che il nome dell’host separato sia `myapexhost.example.com` e che l’host esegua Linux. Le istruzioni per ORDS 22 differiscono da quelle per le versioni precedenti. **Per installare e configurare ORDS 22 e versioni successive per l’uso con Oracle APEX** 1. Vai ai [Oracle REST data services](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html) ed esamina il file Readme per la versione di ORDS che intendi scaricare. Verifica che sia installata la versione richiesta di Java. 1. Crea una nuova directory per l’installazione di ORDS. ``` mkdir /home/apexuser/ORDS cd /home/apexuser/ORDS ``` 1. Scarica il file `ords.version.number.zip` o `ords-latest.zip` da [Oracle REST data services](http://www.oracle.com/technetwork/developer-tools/rest-data-services/downloads/index.html). 1. Decomprimere il file nella directory `/home/apexuser/ORDS`. 1. Concedere all'utente master i privilegi necessari per installare ORDS. Una volta installata l’opzione `APEX`, concedi all’utente master i privilegi necessari per installare lo schema ORDS. Questa operazione può essere eseguita collegandosi al database ed eseguendo questi comandi: Sostituisci `MASTER_USER` con il nome in maiuscolo dell'utente master. **Importante** Quando si immette il nome utente, utilizzare maiuscole a meno che l'utente non sia stato creato con un identificatore con distinzione tra maiuscole e minuscole. Ad esempio, se esegui `CREATE USER myuser` o `CREATE USER MYUSER`, il dizionario dati memorizza `MYUSER`. Tuttavia, se si utilizzano virgolette doppie in `CREATE USER "MyUser"`, il dizionario dati memorizza `MyUser`. Per ulteriori informazioni, consulta [Concedere privilegi SELECT o EXECUTE agli oggetti 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** I comandi precedenti si applicano a ORDS 22 e versioni successive. 1. Installa lo schema ORDS utilizzando lo script `ords` scaricato. Specifica le directory in cui inserire i file di configurazione e i file di log. Oracle Corporation consiglia di non inserire queste directory nella directory che contiene il software del prodotto 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 ``` Per le istanze database che eseguono l’architettura del database dei container (CDB), utilizza ORDS 23.3 o versioni successive e passa l’argomento `--pdb-skip-disable-lockdown` durante l’installazione di ORDS. ``` /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config \ install --interactive --log-folder /home/apexuser/ords_logs --pdb-skip-disable-lockdown ``` Il programma richiede le seguenti informazioni. I valori predefiniti sono riportati tra parentesi. Per altre informazioni, consulta l'articolo relativo a [Introduzione a 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) nella documentazione Oracle. + `Choose the type of installation:` Sceglie **2** per installare gli schemi ORDS nel database e creare un pool di connessioni al database nei file di configurazione ORDS locali. + `Specify the database connection type to use. Enter number for [1] Basic [2] TNS [3] Custom URL:` Scegliere il tipo di connessione desiderato. Questo esempio presuppone che tu scelga **1**. + `Enter the name of the database server [localhost]:` ***DB\$1instance\$1endpoint*** Scegli il valore predefinito o digita il valore corretto. + `Enter the database listener port [1521]:` ***DB\$1instance\$1port*** Scegli il valore predefinito **1521** o digita il valore corretto. + `Enter the database service name [orcl]:` Immetti il nome del database utilizzato dall’istanza database RDS per Oracle. + `Provide database user name with administrator privileges` Inserisci il nome utente master per l’istanza database RDS per Oracle. + `Enter the database password for [username]:` Inserisci la password dell’utente master per l’istanza database RDS per 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]: ` Scegli **2** per saltare immediatamente l’avvio di ORDS in modalità standalone. + `Enter a number to select the protocol [1] HTTP` + `Enter the HTTP port [8080]:` + `Enter the APEX static resources location:` Immetti il percorso ai file di installazione di Oracle APEX (`/home/apexuser/apex/images`). 1. Imposta una password per l’utente `admin` di Oracle APEX. Per farlo, utilizzare SQL\$1Plus per connettersi alla propria istanza database come utente master, quindi utilizzare i seguenti comandi: ``` 1. EXEC rdsadmin.rdsadmin_util.grant_apex_admin_role; 2. grant APEX_ADMINISTRATOR_ROLE to master; 3. @/home/apexuser/apex/apxchpwd.sql ``` Sostituire `master` con il proprio nome utente master. Quando lo script `apxchpwd.sql` lo richiede, inserire una nuova password `admin`. 1. Esegui ORDS in modalità standalone utilizzando lo script `ords` con il comando `serve`. Per le implementazioni di produzione, prendi in considerazione l'utilizzo di server applicativi Java EE supportati come Apache Tomcat o Oracle Server. WebLogic Per altre informazioni, consulta l’articolo [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) nella documentazione Oracle. ``` /home/apexuser/ORDS/bin/ords \ --config /home/apexuser/ords_config serve \ --port 8193 \ --apex-images /home/apexuser/apex/images ``` Se ORDS è in esecuzione, ma non è possibile accedere all’installazione di Oracle APEX, è possibile che venga visualizzato il seguente errore, in particolare sulle istanze non 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. ``` Per correggere questo errore, modifica la funzione di convalida della richiesta utilizzata da ORDS eseguendo lo script `ords` con il comando `config`. Per impostazione predefinita, ORDS utilizza la procedura `ords_util.authorize_plsql_gateway`, che è supportata solo sulle istanze CDB. Per le istanze non CDB, puoi modificare questa procedura nel pacchetto `wwv_flow_epg_include_modules.authorize`. Consulta la documentazione di Oracle Database e Oracle Support per le best practice sulla configurazione della funzione di convalida delle richieste appropriata per il tuo caso d’uso. 1. Torna alla finestra di amministrazione Oracle APEX nel browser e scegli l’opzione **Administration**. Scegliere quindi **Application Express Internal Administration (Amministrazione interna Application Express)**. Quando vengono richieste le credenziali, inserire le seguenti informazioni: + **User name (Nome utente** – `admin` + **Password** – La password impostata usando lo script `apxchpwd.sql` Scegliere **Login (Accedi)**, quindi impostare una nuova password per l'utente `admin`. Il listener è ora pronto per essere utilizzato. # Aggiornamento e rimozione di Oracle APEX Per aggiornare o rimuovere Oracle APEX, segui le istruzioni riportate in questo argomento: **Topics** + [Aggiornamento della versione di Oracle APEX](#Appendix.Oracle.Options.APEX.Upgrade) + [Aggiunta delle opzioni APEX e APEX-DEV](#Appendix.Oracle.Options.APEX.Remove) ## Aggiornamento della versione di Oracle APEX **Importante** Effettua il backup della tua istanza database prima di aggiornare Oracle APEX. Per ulteriori informazioni, consultare [Creazione di uno snapshot del database per un’istanza database Single-AZ per Amazon RDS](USER_CreateSnapshot.md) e [Verifica di un aggiornamento del database Oracle](USER_UpgradeDBInstance.Oracle.UpgradeTesting.md). Per aggiornare Oracle APEX con l’istanza database, utilizza la seguente procedura: + Creare un nuovo gruppo di opzioni per la versione aggiornata dell'istanza database. + Aggiungi le versioni aggiornate di `APEX` e `APEX-DEV` al nuovo gruppo di opzioni. Assicurarsi di includere eventuali altre opzioni utilizzate dall'istanza database. Per ulteriori informazioni, consulta [Considerazioni su gruppi di opzioni](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG). + Al momento dell'aggiornamento dell'istanza database, specificare il nuovo gruppo di opzioni per la propria istanza database aggiornata. Dopo l’aggiornamento della versione di Oracle APEX, lo schema Oracle APEX per la precedente versione potrebbe comunque rimanere all’interno del database. Se non ne hai più bisogno, puoi eliminare il vecchio schema Oracle APEX dal database dopo l’aggiornamento. Se si aggiorna la versione di Oracle APEX e RESTful i servizi non erano configurati nella versione precedente di Oracle APEX, si consiglia di configurare RESTful i servizi. Per ulteriori informazioni, consulta [Configurazione dei RESTful servizi per Oracle APEX](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.ConfigureRESTful). In alcuni casi, quando pianifichi di eseguire un aggiornamento della versione principale dell’istanza database, è possibile che la versione APEX in uso non sia compatibile con la versione del database di destinazione. In questi casi, puoi aggiornare la versione di Oracle APEX prima di aggiornare l’istanza database. In questo modo, puoi ridurre il tempo necessario per aggiornare l’istanza database. **Nota** Dopo l’aggiornamento di Oracle APEX, installa e configura un listener da utilizzare con la versione aggiornata. Per istruzioni, consulta [Impostazione del listener Oracle APEX](Appendix.Oracle.Options.APEX.settingUp.md#Appendix.Oracle.Options.APEX.Listener). ## Aggiunta delle opzioni APEX e APEX-DEV Puoi rimuovere le opzioni `APEX` e `APEX-DEV` dall’istanza database. Per rimuovere queste opzioni dall’istanza database, procedi in uno dei seguenti modi: + Per rimuovere le opzioni `APEX` e `APEX-DEV` da più istanze database, rimuovile dal gruppo di opzioni a cui appartengono. Questa modifica coinvolge tutte le istanze database che usano il gruppo di opzioni. Quando rimuovi le opzioni da un gruppo di opzioni associato a più istanze database, si verifica una breve interruzione mentre le istanze database vengono riavviate. Per ulteriori informazioni, consulta [Rimozione di un'opzione da un gruppo di opzioni](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Per rimuovere le opzioni `APEX` e `APEX-DEV` da una singola istanza database, modifica l’istanza database e specifica un gruppo di opzioni diverso che non comprenda queste opzioni. È possibile specificare il gruppo di opzioni predefinito (vuoto) o un gruppo di opzioni personalizzato diverso. Quando rimuovi le opzioni, si verifica una breve interruzione mentre l’istanza database viene riavviata automaticamente. Per ulteriori informazioni, consulta [Modifica di un'istanza database Amazon RDS](Overview.DBInstance.Modifying.md). Quando rimuovi le opzioni `APEX` e `APEX-DEV` da un’istanza database, lo schema APEX viene rimosso dal database.