Richiama procedure esterne come funzioni SQL

Le procedure esterne sono funzioni scritte in un linguaggio di terza generazione e richiamabili dall'interno di PL/SQL o SQL come se fossero una routine o una funzione PL/SQL.

È possibile richiamare e utilizzare procedure esterne in Autonomous Database con funzioni definite dall'utente.

Definire la procedura C utilizzando uno di questi prototipi.

Creare una libreria di oggetti condivisi (file .so). La libreria di oggetti condivisi contiene la procedura C (procedura esterna) definita nel passo precedente.

gcc -I/u01/app/oracle/extproc_libs/ -shared -fPIC -o extproc.so UpdateSalary.c

Mostra i passi per ottenere l'applicazione stack EXTPROC di OCI Marketplace.

1. Connettersi a OCI Console all'indirizzo http://cloud.oracle.com. Per ulteriori informazioni, consulta la sezione Accedi alla console di Oracle Cloud Infrastructure.
2. Nel menu di navigazione a sinistra di Oracle Cloud Infrastructure fare clic su Marketplace, quindi in Marketplace fare clic su Tutte le applicazioni. In questo modo è possibile accedere alla dashboard Tutte le applicazioni di Marketplace.
3. Immettere EXTPROC nel campo di ricerca e fare clic su cerca.
4. Fare clic sul widget EXTPROC di Tipo: stack.
   
   

   
   Descrizione dell'immagine adbs_extproc_application.png

   
   

Avviare l'applicazione stack EXTPROC dalla pagina Dettagli applicazione EXTPROC.

1. Nella pagina Agente EXTPROC di Oracle Autonomous Database, in Type Stack, effettuare le operazioni riportate di seguito.

   • Dall'elenco a discesa Versione, selezionare la versione del pacchetto dello stack. Per impostazione predefinita, nel menu viene visualizzata la versione più recente.

   • Dall'elenco a discesa Compartimento selezionare il nome del compartimento in cui si desidera avviare l'istanza.

     Nota
     
     Se non si dispone dell'autorizzazione per avviare l'istanza nel compartimento selezionato, l'istanza viene avviata nel compartimento radice.

   • Selezionare la casella di controllo Ho preso visione e accetto le condizioni generali Oracle e le restrizioni.

2. Fare clic su Launch Stack.
   
   

   
   Descrizione dell'immagine adb_launch_stack.png

   
   

Mostra i passi per creare lo stack per l'istanza EXTPROC.

1. Nella pagina Informazioni stack rivedere e modificare le informazioni riportate di seguito in base alle esigenze.

   • Informazioni sullo stack

   • Provider personalizzati

   • Nome (facoltativo): è possibile modificare il nome dello stack predefinito. Evitare di fornire informazioni riservate.

   • Descrizione (facoltativa): è possibile modificare la descrizione dello stack predefinito. Evitare di fornire informazioni riservate.

   • Crea nel compartimento

   • Versione di Terraform

   • Tag: fornire le seguenti informazioni per assegnare tag allo stack.

     • Spazio di nomi tag: per aggiungere una tag definita, selezionare uno spazio di nomi esistente. Per aggiungere un tag free-from, lasciare vuoto il valore.

     • Tasto tag: per aggiungere una tag definita, selezionare una chiave tag esistente. Per aggiungere un tag in formato libero, digitare il nome della chiave desiderata.

     • Valore tag: digitare il valore del tag desiderato.

     Aggiungi tag: fare clic per aggiungere un'altra tag.

     Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa.

   
   

   
   Descrizione dell'immagine adbs_extproc_createstack_updated.png

   
   
2. Fare clic su Avanti.
   Viene visualizzata la pagina Configura variabili, che consente di configurare le variabili per le risorse dell'infrastruttura create dallo stack quando si esegue il job di applicazione per questo piano di esecuzione.
3. Nella pagina Configura variabili immettere le informazioni nelle aree: Configura agente EXTPROC, Configurazione di rete e Configurazione di computazione.
   1. Fornire informazioni nell'area Configura agente EXTPROC.

      • Librerie esterne: fornire una lista di librerie separate da virgole (,), che si desidera consentire di richiamare da Autonomous Database. Ad esempio, extproc.so, extproc1.so.

        Dopo aver creato lo stack, è necessario copiare le librerie nella directory /u01/app/oracle/extproc_libs nella VM dell'agente EXTPROC.

      • Password wallet: fornire la password del wallet.

        Il wallet e un certificato autofirmato vengono generati per l'autenticazione TLS reciproca tra Autonomous Database e la VM dell'agente EXTPROC. Il wallet viene creato nella directory /u01/app/oracle/extproc_wallet.

        Nota
        
        Dopo la creazione del wallet, la password del wallet non può essere modificata.

      
      

      
      Descrizione dell'immagine adbs_configure_var_extproc_agent.png

      
      
   2. Fornire informazioni nell'area Configurazione di rete.

      • Compartimento: dall'elenco a discesa, scegliere il compartimento in cui si desidera posizionare la configurazione.

      • Strategia di rete: scegliere una delle opzioni dall'elenco a discesa Crea nuova VCN e subnet o Usa VCN e subnet esistenti.

        • Crea nuova VCN e subnet: scegliere questa opzione se un endpoint privato non è configurato per Autonomous Database. In questo modo viene creata una nuova VCN con subnet pubblica e privata preconfigurata con regole di sicurezza.

          Se si seleziona questa opzione, nella pagina viene visualizzato anche l'elenco a discesa Strategia di configurazione.

          Scegliere Usa configurazione consigliata dall'elenco a discesa Strategia di configurazione.

          
          

          
          Descrizione dell'immagine adb_extproc_network_config.png

          
          

        • Usa VCN e subnet esistenti: selezionare questa opzione per creare l'agente EXTPROC utilizzando una VCN esistente. In questo modo viene creata l'istanza dell'agente EXTPROC nella subnet fornita.

          Quando si seleziona questa opzione, fornire le informazioni riportate di seguito per la VCN e la subnet esistenti.

          • In rete cloud virtuale effettuare le operazioni riportate di seguito.

            Dall'elenco a discesa VCN esistente scegliere una VCN esistente. Se la VCN specificata non esiste, viene creata una nuova VCN.

          • In Sottorete EXTPROC effettuare le operazioni riportate di seguito.

            Dall'elenco a discesa Sottorete esistente scegliere una sottorete esistente.

            Quando si sceglie di utilizzare una VCN e una subnet esistenti, aggiungere una regola di entrata per la porta 16000 dell'istanza dell'agente EXTPROC. È inoltre possibile aggiungere una regola di uscita nella subnet pubblica.

            Per ulteriori informazioni, vedere Configurazione dell'accesso di rete con endpoint privati.

          
          

          
          Descrizione dell'immagine adbs_extproc_network_configuration_existing_vcn.png

          
          

      • Tipo di accesso agente EXTPROC: scegliere una delle opzioni riportate di seguito dall'elenco a discesa.

        • Accesso sicuro da database di endpoint privati ADB-S specifici nella VCN: scegliere questa opzione per consentire la connessione all'agente EXTPROC solo agli IP di endpoint privati specificati all'interno della rete cloud virtuale (VCN).

          Quando si sceglie questa opzione, si fornisce una lista di indirizzi IP dell'endpoint privato consentiti nel passo successivo.

        • Accesso sicuro da tutti i database endpoint privati ADB-S nella VCN: scegliere questa opzione per consentire a qualsiasi endpoint privato all'interno della rete cloud virtuale (VCN) di connettersi all'agente EXTPROC.

      • Indirizzi IP degli endpoint privati

        Fornire una lista di indirizzi IP degli endpoint privati separati da virgole (,) per la variabile Indirizzi IP degli endpoint privati. Ad esempio, 10.0.0.0, 10.0.0.1.

        Nota
        
        Questo campo viene visualizzato solo quando si seleziona Accesso sicuro da database di endpoint privati ADB-S specifici nella VCN per il tipo di accesso agente EXTPROC.
   3. Fornire le informazioni sulla configurazione di computazione.

      • Compartimento: selezionare il compartimento in cui si desidera creare lo stack.

      • Forma: selezionare una forma in base ai requisiti del carico di lavoro dell'istanza agente EXTPROC. La forma determina le risorse allocate all'istanza dell'agente EXTPROC.

      • Numero di OCPU: scegliere il numero di OCPU che si desidera allocare all'istanza dell'agente EXTPROC.

      • Dimensione memoria (GB): scegliere la quantità di memoria in gigabyte (GB) che si desidera allocare all'istanza agente EXTPROC.

      • Aggiungi chiavi SSH: caricare una chiave pubblica SSH o incollare la chiave pubblica. Selezionare una delle opzioni seguenti.

        • Scegli file di chiavi SSH: consente di caricare la parte di chiave pubblica della coppia di chiavi. Cercare il file chiave che si desidera caricare oppure trascinare la selezione del file nella casella.

        • Incollare la chiave SSH: incollare la parte della chiave pubblica nella casella.

      
      

      
      Descrizione dell'immagine adbs_extproc_compute_config.png

      
      
4. Fare clic su Avanti.

   Viene visualizzata la pagina Revisione.

5. Nella pagina Revisione effettuare le operazioni riportate di seguito.
   1. Verificare le variabili di configurazione.
   2. Selezionare la casella di controllo Esegui applicazione in Esegui applicazione nello stack creato?
   3. Fare clic su Crea.
   Nota
   
   In quest'area non vengono visualizzate le variabili con valori o variabili predefiniti che non sono state modificate.

   
   

   
   Descrizione dell'immagine adbs_extproc_review.png

   
   

   Resource Manager esegue il job di applicazione per creare le risorse dello stack di conseguenza. Viene visualizzata la pagina Dettagli job e lo stato del job è Accettato. Quando viene avviato il job di applicazione, lo stato viene aggiornato a In corso.

   
   

   
   Descrizione dell'immagine adbs_extproc_job_details.png

   
   

   Nota
   
   Le informazioni necessarie per connettersi all'istanza creata come parte dello stack sono disponibili nella scheda Informazioni sull'applicazione.

Viene creato un wallet con firma automatica nell'ambito della creazione dell'applicazione agente EXTPROC. Questo wallet consente di accedere all'istanza dell'agente Extrpoc.

1. Importare il wallet, cwallet.sso, contenente i certificati per l'istanza dell'agente EXTPROC dallo storage degli oggetti nell'Autonomous Database. Tenere presente quanto riportato di seguito per il file wallet.

   • Il file wallet, insieme all'ID utente e alla password del database, fornisce l'accesso all'istanza dell'agente EXTPROC. Memorizzare i file wallet in una posizione sicura e condividerli solo con gli utenti autorizzati.

   • Non rinominare il file wallet. Il file wallet nello storage degli oggetti deve essere denominato cwallet.sso.

2. Creare le credenziali per accedere allo storage degli oggetti in cui memorizzare il file wallet cwallet.sso. Per informazioni sui parametri di nome utente e password per diversi servizi di storage degli oggetti, vedere CREATE_CREDENTIAL Procedure.
   La creazione di una credenziale per accedere all'area di memorizzazione degli oggetti di Oracle Cloud Infrastructure non è necessaria se si abilitano le credenziali del principal risorsa. Per ulteriori informazioni, vedere Informazioni sull'uso del principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure.
3. Creare una directory in Autonomous Database per il file wallet cwallet.sso.

   CREATE DIRECTORY wallet_dir AS 'directory_location';

   Per ulteriori informazioni sulla creazione di directory, vedere Crea directory in Autonomous Database.

4. Utilizzare DBMS_CLOUD.GET_OBJECT per caricare il wallet. Ad esempio:

   BEGIN
     DBMS_CLOUD.GET_OBJECT (
       credential_name     => 'DEF_CRED_NAME',
       object_uri          => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/cwallet.sso',
       directory_name      => 'WALLET_DIR'
   );
   END;
   /

   In questo esempio, namespace-string è lo spazio di nomi di Oracle Cloud Infrastructure Object Storage e bucketname è il nome del bucket. Per ulteriori informazioni, vedere Spazi di nomi dello storage degli oggetti.

   Il wallet viene copiato nella directory creata nel passo precedente, WALLET_DIR. Il wallet che consente di connettersi all'istanza dell'agente EXTPROC è ora disponibile nell'istanza di Autonomous Database.

Mostra i passi per richiamare una procedura esterna come funzione SQL.

1. Creare una libreria.

   Una procedura esterna è una routine di lingua C memorizzata in una libreria. Per richiamare procedure esterne con Autonomous Database, creare una libreria.

   Eseguire DBMS_CLOUD_FUNCTION.CREATE_CATALOG per creare una libreria. Ad esempio:

   BEGIN
       DBMS_CLOUD_FUNCTION.CREATE_CATALOG (
           library_name               => 'demolib',
           library_listener_url       => 'remote_extproc_hostname:16000',
           library_wallet_dir_name    => 'wallet_dir',
           library_ssl_server_cert_dn => 'CN=VM Hostname',
           library_remote_path        => '/u01/app/oracle/extproc_libs/library name'
   );
   END;
   /
   

   In questo modo, viene creata la libreria demolib nell'Autonomous Database e viene registrata la libreria di collegamenti dinamici nel database. L'istanza dell'agente EXTPROC è preconfigurata per ospitare procedure esterne sulla porta 16000.

   Per ulteriori informazioni, vedere CREATE_CATALOG Procedure.

   Eseguire una query sulle viste DBA_CLOUD_FUNCTION_CATALOG View e USER_CLOUD_FUNCTION_CATALOG View per recuperare la lista di tutti i cataloghi e le librerie nel database.

   Eseguire una query sulla vista USER_CLOUD_FUNCTION_ERRORS View per elencare gli eventuali errori generati durante la convalida della connessione alla posizione della libreria remota.

2. Creare la funzione.

   Ad esempio:

   CREATE OR REPLACE FUNCTION ftest(
         x VARCHAR2, 
         y VARCHAR2) 
   RETURN VARCHAR2 AS LANGUAGE C
         LIBRARY test
         NAME "demolib"
         PARAMETERS(
             x STRING, 
             y STRING)
         AGENT IN (x);
   /

3. È possibile eliminare una libreria esistente utilizzando la procedura DROP_CATALOG. Ad esempio:

   BEGIN
       DBMS_CLOUD_FUNCTION.DROP_CATALOG (
         LIBRARY_NAME  => 'demolib'
     );
   END;
   /
   

   Viene eliminata la libreria DEMOLIB.

   Per ulteriori informazioni, vedere DROP_CATALOG Procedure.