È possibile accedere all'immagine del contenitore gratuito di Autonomous Database da un repository ed eseguirla nell'ambiente locale.

Autonomous Database offre un Oracle Database completamente gestito disponibile su Oracle Cloud Infrastructure. Su Oracle Cloud Infrastructure, esegui le operazioni di gestione del ciclo di vita ed esegui Autonomous Database utilizzando la console di Oracle Cloud Infrastructure e ti connetti al database tramite la rete Internet pubblica o tramite una rete privata impostata (a seconda della configurazione di rete e delle esigenze di sicurezza).

L'immagine container gratuita di Autonomous Database fornisce un'alternativa all'esecuzione di Autonomous Database in un container nel proprio ambiente, senza richiedere l'accesso alla console di Oracle Cloud Infrastructure o a Internet. Quando esegui Autonomous Database in un container, il container fornisce un ambiente locale e isolato con opzioni aggiuntive per lo sviluppo, il test e l'esplorazione delle funzioni di Oracle Autonomous Database.

• Autonomous Database Free Container Image License
  Descrive le licenze per Autonomous Database Free Container Image.
• Funzioni di Autonomous Database Free Container Image
  Autonomous Database Free Container Image fornisce molte delle funzioni disponibili con Autonomous Database Serverless.
• Consigli e limitazioni per l'immagine gratuita del contenitore di Autonomous Database
  Descrivono i requisiti e le limitazioni per l'immagine gratuita del contenitore.

Sono disponibili più posizioni in cui è possibile ottenere l'immagine del contenitore gratuito di Autonomous Database, tra cui Oracle Cloud Infrastructure Registry (Container Registry) e GitHub.

1. Avviare una macchina virtuale podman.
   Ad esempio:

   podman machine init 
   podman machine set --cpus 4 --memory 8192 
   podman machine start 

2. Ottenere l'immagine del contenitore libero.

   Oracle Cloud Infrastructure Registry:

   Ad esempio, utilizzare il comando podman per estrarre l'immagine più recente di Free Container Image:

   podman pull container-registry.oracle.com/database/adb-free:latest-23ai

   Nota
   
   

   Oracle Autonomous Database Serverless supporta anche le immagini dei container 19c.

   • Per i nomi delle immagini del contenitore 19c, specificare la tag latest come versione del database.

   • Nell'esempio precedente, per estrarre l'immagine 19c del contenitore libero di Autonomous Database, utilizzare il comando seguente nella tag del nome dell'immagine:

     podman pull container-registry.oracle.com/database/adb-free:latest

   In tutto il documento, il tag nome immagine fa riferimento alla versione latest-23ai.

   Per ulteriori dettagli e ulteriori informazioni, cerca "Oracle Autonomous Database Free" su Oracle Cloud Infrastructure Registry.

   GitHub Pacchetti:

   Ad esempio, utilizzare il comando podman per estrarre l'immagine del contenitore libero da: GitHub Package:

   podman pull ghcr.io/oracle/adb-free:latest-23ai

3. Verificare l'immagine.

   Ad esempio:

   podman images container-registry.oracle.com/database/adb-free:latest-23ai

Dopo aver scaricato l'immagine del contenitore gratuito di Autonomous Database, è possibile avviare l'immagine in un contenitore.

1. Avviare un contenitore per eseguire l'immagine del contenitore libero.

   Ad esempio, con podman:

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name adb-free \
   container-registry.oracle.com/database/adb-free:latest-23ai

   Note di comando:

   • Autonomous Database Serverless supporta anche le immagini dei container 19c.

     • Per i nomi delle immagini del contenitore 19c, specificare la tag latest come versione del database.

     • Nell'esempio precedente, per avviare un contenitore per eseguire l'immagine 19c del contenitore gratuito di Autonomous Database, utilizzare il comando seguente nella tag nome immagine:

       container-registry.oracle.com/database/adb-free:latest

   • In tutto il documento, il tag nome immagine fa riferimento alla versione latest-23ai.

   • Il valore WORKLOAD_TYPE può essere ATP o ADW. Il valore predefinito è ATP.

   • Per impostazione predefinita, il database viene denominato MYATP o MYADW, a seconda del valore WORKLOAD_TYPE passato. Facoltativamente, se si desidera un nome di database diverso da quello predefinito, è possibile impostare il parametro DATABASE_NAME. Il nome del database può contenere solo caratteri alfanumerici.

   • All'avvio del contenitore, il file MY<WORKLOAD_TYPE>.pdb corrispondente viene scaricato e collegato da un bucket di storage degli oggetti pubblico.

   • Il wallet viene generato utilizzando il file WALLET_PASSWORD fornito.

   • È necessario modificare ADMIN_PASSWORD al login iniziale.

   • Quando si crea o si modifica il file ADMIN_PASSWORD, verificare i seguenti requisiti:
     • La password deve avere una lunghezza compresa tra 12 e 30 caratteri e deve includere almeno una lettera maiuscola, una lettera bassa e un carattere numerico.
     • La password non può contenere il nome utente.
   • Quando si crea o si modifica il file WALLET_PASSWORD, verificare i seguenti requisiti:
     • La password deve avere una lunghezza compresa tra 8 e 30 caratteri e includere caratteri alfabetici in combinazione con caratteri numerici o speciali.

   • Per l'attivazione OFS, il contenitore inizia con la funzionalità SYS_ADMIN. Inoltre, il dispositivo virtuale /dev/fuse deve essere accessibile.

   • Queste opzioni -p specificano che le seguenti porte vengono inoltrate al processo contenitore:

     Porta	descrizione;
     1.521	TLS
     1.522	mTLS
     8.443	Porta HTTPS per ORDS/APEX e Database Actions
     27.017	API Mongo

   Se si è dietro un proxy aziendale, includere le opzioni -e per specificare le variabili di ambiente per i proxy. Ad esempio, con podman:

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   -e http_proxy=http://example-corp-proxy.com:80/ \
   -e https_proxy=http://example-corp-proxy.com:80/ \
   -e no_proxy=localhost,127.0.0.1 \
   -e HTTP_PROXY=http://example-corp-proxy.com:80/  \
   -e HTTPS_PROXY=http://example-corp-proxy.com:80/  \
   -e NO_PROXY=localhost,127.0.0.1 \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name adb-free \
   container-registry.oracle.com/database/adb-free:latest-23ai

La utility della riga di comando adb-cli può essere utilizzata per eseguire le operazioni del database dopo che il contenitore è attivo e in esecuzione.

alias adb-cli="podman exec <container_name> adb-cli"

adb-cli --help 
Usage: adb-cli [OPTIONS] COMMAND [ARGS]... 
    ADB-S Command Line Interface (CLI) to perform container-runtime database operations 
Options: 
    -v, --version Show the version and exit. 
    --help Show this message and exit. 
Commands: 
    add-database 
    change-password 

adb-cli add-database --workload-type "ATP" --admin-password "Welcome_MY_ATP_1234" 

adb-cli change-password --database-name "MYATP" 
    --old-password "Welcome_MY_ATP_1234" --new-password "Welcome_12345"

Quando l'immagine del contenitore libero è in esecuzione in un contenitore, è possibile connettersi a un'istanza di Autonomous Database.

Per connettersi a un'istanza di Autonomous Database in esecuzione in un contenitore, è possibile impostare il wallet e connettersi oppure utilizzare una connessione senza wallet TLS.

• Connettersi a ORDS, APEX o Database Actions da un'immagine del contenitore di Autonomous Database
  Il contenitore hostname viene utilizzato per generare certificati SSL autofirmati per servire il traffico HTTPS sulla porta 8443. È possibile accedere a Oracle APEX e Database Actions utilizzando l'host del contenitore (o semplicemente localhost).
• Alias TNS disponibili per la connessione a un'immagine del contenitore di Autonomous Database
  Per connettersi a un'immagine del contenitore di Autonomous Database, è possibile utilizzare uno degli alias riportati di seguito.
• Connettersi a un'immagine contenitore di Autonomous Database con un wallet
  Verranno descritti i passi per connettersi a un'immagine contenitore di Autonomous Database con un wallet.
• Connettersi a un'immagine contenitore di Autonomous Database senza un wallet (TLS)
  Descrive i passi per connettersi a un'immagine contenitore di Autonomous Database senza un wallet (TLS).

1. Creare un volume podman.

   Ad esempio:

   podman volume create adb_container_volume

2. Verificare il punto di attivazione del volume.

   Il punto di attivazione è una posizione di directory gestita da podman.

   podman inspect adb_container_volume
    
   [
        {
             "Name": "adb_container_volume",
             "Driver": "local",
             "Mountpoint": "/share/containers/storage/volumes/adb_container_volume/_data",
             "CreatedAt": "2023-09-11T21:23:34.305877073Z",
             "Labels": {},
             "Scope": "local",
             "Options": {},
             "MountCount": 0,
             "NeedsCopyUp": true,
             "NeedsChown": true
        }
   ]

3. Avviare il contenitore di origine, attivando il volume in /u01/data nel contenitore.

   Ad esempio:

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name source_adb_container \
   --volume adb_container_volume:/u01/data \
   container-registry.oracle.com/database/adb-free:latest-23ai

   Nota
   
   

   Autonomous Database Serverless supporta anche le immagini dei container 19c.

   • Per i nomi delle immagini del contenitore 19c, specificare la tag latest come versione del database.

   • Nell'esempio precedente, per avviare Autonomous Database Free Container Image 19c , utilizzare il seguente comando nella tag nome immagine:

     container-registry.oracle.com/database/adb-free:latest

   In tutto il documento, il tag nome immagine fa riferimento alla versione latest-23ai.

4. In questo esempio si presume che i dati siano stati creati in precedenza nello schema app_user.
5. Esportare i dati dallo schema di app_user nel volume contenitore.
   1. Connettersi come ADMIN e creare la directory ORA_EXP_DIR che punta a /u01/data.

      sqlplus admin/**************@myadw_high
       
      SQL> exec DBMS_CLOUD_CONTAINER_ADMIN.create_export_directory('/u01/data');
      

      SQL> select directory_path from dba_directories where directory_name='ORA_EXP_DIR';
      
      DIRECTORY_PATH
      --------------------------------------------------------------------------------
      /u01/data

   2. Eseguire il job di esportazione in modalità schema e per gli schemi ADMIN e APP_USER.

      SET scan off
      SET serveroutput ON
      SET escape off
        
      DECLARE
          h1 NUMBER;
          s VARCHAR2(1000):=NULL;
          errorvarchar VARCHAR2(100):= 'ERROR';
          tryGetStatus NUMBER := 0;
          success_with_info EXCEPTION;
          PRAGMA EXCEPTION_INIT(success_with_info, -31627);
      BEGIN
          h1 := dbms_datapump.OPEN(operation => 'EXPORT', job_mode => 'SCHEMA', job_name => 'EXPORT_MY_ADW_4', version => 'COMPATIBLE');
          tryGetStatus := 1;
          dbms_datapump.add_file(handle => h1, filename => 'EXPORT_MY_ADW.LOG', directory => 'ORA_EXP_DIR', filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);
          dbms_datapump.metadata_filter(handle => h1, name => 'SCHEMA_EXPR', VALUE => 'IN(''ADMIN'', ''APP_USER'')');
          dbms_datapump.add_file(handle => h1, filename => 'MY_ADW_%L.DMP', directory => 'ORA_EXP_DIR', filesize => '500M',  filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_DUMP_FILE);
          dbms_datapump.start_job(handle => h1, skip_current => 0, abort_step => 0);
          dbms_datapump.detach(handle => h1);
          errorvarchar := 'NO_ERROR';
      EXCEPTION
          WHEN OTHERS THEN
          BEGIN
              IF ((errorvarchar = 'ERROR')AND(tryGetStatus=1)) THEN
                  DBMS_DATAPUMP.DETACH(h1);
              END IF;
          EXCEPTION
          WHEN OTHERS THEN
              NULL;
          END;
          RAISE;
      END;
      /

6. Verificare l'esportazione.

   Elencare i file nel contenitore /u01/data.

   podman exec -it source_adb_container bash
   cd /u01/data

   Verificare il log di esportazione (export log), verificare la presenza di errori e completare il processo.

7. Arrestare e rimuovere il contenitore di origine.

   podman stop source_adb_container
   podman rm source_adb_container

   Nota
   
   adb_container_volume verrà attivato tra i riavvii e le rimozioni del contenitore
8. Avviare un contenitore di destinazione con lo stesso volume in /u01/data nel contenitore.

   podman run -d \
   -p 1521:1522 \
   -p 1522:1522 \
   -p 8443:8443 \
   -p 27017:27017 \
   -e WORKLOAD_TYPE='ATP' \
   -e WALLET_PASSWORD=*** \
   -e ADMIN_PASSWORD=*** \
   --cap-add SYS_ADMIN \
   --device /dev/fuse \
   --name dest_adb_container \
   --volume adb_container_volume:/u01/data \
   container-registry.oracle.com/database/adb-free:latest-23ai

9. Importa dati nel contenitore di destinazione.

   Connettersi come ADMIN e creare la directory ORA_EXP_DIR che punta a /u01/data.

   SQL> exec DBMS_CLOUD_CONTAINER_ADMIN.create_export_directory('/u01/data');
    
   PL/SQL procedure successfully completed.
    
   SQL> select directory_path from dba_directories where directory_name='ORA_EXP_DIR';
    
   DIRECTORY_PATH
   --------------------------------------------------------------------------------
   /u01/data

10. Eseguire i comandi di importazione PL/SQL.

    SET scan off
    SET serveroutput ON
    SET escape off
      
    DECLARE
        h1 NUMBER;
        s VARCHAR2(1000):=NULL;
        errorvarchar VARCHAR2(100):= 'ERROR';
        tryGetStatus NUMBER := 0;
        success_with_info EXCEPTION;
        PRAGMA EXCEPTION_INIT(success_with_info, -31627);
    BEGIN
        h1 := dbms_datapump.OPEN(operation => 'IMPORT', job_mode => 'SCHEMA', job_name => 'IMPORT_MY_ADW_4', version => 'COMPATIBLE');
        tryGetStatus := 1;
        dbms_datapump.add_file(handle => h1, filename => 'IMPORT_MY_ADW.LOG', directory => 'ORA_EXP_DIR', filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);
        dbms_datapump.metadata_filter(handle => h1, name => 'SCHEMA_EXPR', VALUE => 'IN(''ADMIN'', ''APP_USER'')');
        dbms_datapump.add_file(handle => h1, filename => 'MY_ADW_%L.DMP', directory => 'ORA_EXP_DIR', filesize => '500M',  filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_DUMP_FILE);
        dbms_datapump.start_job(handle => h1, skip_current => 0, abort_step => 0);
        dbms_datapump.detach(handle => h1);
        errorvarchar := 'NO_ERROR';
    EXCEPTION
        WHEN OTHERS THEN
        BEGIN
            IF ((errorvarchar = 'ERROR')AND(tryGetStatus=1)) THEN
                DBMS_DATAPUMP.DETACH(h1);
            END IF;
        EXCEPTION
        WHEN OTHERS THEN
            NULL;
        END;
        RAISE;
    END;
    /

11. Verificare il log di importazione.
12. Verificare i dati di importazione.