Oracle consiglia di utilizzare la versione più recente di Oracle Data Pump per importare i dati dai file di Data Pump nell'Autonomous Database in quanto contiene miglioramenti e correzioni per un'esperienza migliore.

1. Memorizzare le credenziali dello storage degli oggetti cloud utilizzando DBMS_CLOUD.CREATE_CREDENTIAL.

   Ad esempio, per creare le credenziali del token di autenticazione di Oracle Cloud Infrastructure con il dominio di Identity predefinito:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com',
       password => 'password'
     );
   END;
   /

   Per lo storage degli oggetti OCI, il valore del parametro username deve includere il dominio di Identity e il nome utente del profilo. È possibile trovare il dominio di Identity associato a un utente nella console di Oracle Cloud Infrastructure. Ad esempio, con il dominio di Identity oracleidentitycloudservice, si verifica quanto riportato di seguito.

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'oracleidentitycloudservice/adb_user@example.com',
       password => 'password'
     );
   END;
   /

   Per ulteriori informazioni sull'autenticazione del token di autenticazione di Oracle Cloud Infrastructure, vedere CREATE_CREDENTIAL Procedura.

   Ad esempio, per creare credenziali basate sulla chiave di firma di Oracle Cloud Infrastructure:

   BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL (
          credential_name => 'DEF_CRED_NAME',
          user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
          tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
          private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
          fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
   END;
   /

   Per ulteriori informazioni sulle credenziali basate sulla chiave di firma di Oracle Cloud Infrastructure, vedere CREATE_CREDENTIAL Procedura.

   Tipi di credenziali supportati:

   • L'importazione di Data Pump supporta le credenziali basate su token di autenticazione di Oracle Cloud Infrastructure e le credenziali basate su chiave di firma di Oracle Cloud Infrastructure.

     Per ulteriori informazioni sui tipi di credenziali per lo storage degli oggetti Oracle Cloud Infrastructure Cloud, vedere CREATE_CREDENTIAL Procedura.

   • Data Pump supporta l'uso di un URL preautenticato di Oracle Cloud Infrastructure Object Storage per il parametro dumpfile. Quando si utilizza un URL preautenticato, è necessario fornire il parametro credential e il valore credential può essere NULL. Per ulteriori informazioni, vedere Utilizzo delle richieste preautenticate.

   • Data Pump supporta l'utilizzo di una credenziale di principal risorsa con impdp. Per ulteriori informazioni, vedere Importa dati mediante Oracle Data Pump versione 18.3 o successive con il principal delle risorse OCI.

2. Eseguire l'importazione di Data Pump con il parametro dumpfile impostato sulla lista di URL file nello storage degli oggetti cloud e il parametro credenziale impostato sul nome della credenziale creata nel passo precedente. Ad esempio:

   impdp admin/password@db2022adb_high \       
        directory=data_pump_dir \       
        credential=def_cred_name \       
        dumpfile= https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link

   Note per i parametri Data Pump:

   • Se durante l'esportazione con expdp si è utilizzato il parametro encryption_pwd_prompt=yes, utilizzare encryption_pwd_prompt=yes e immettere la stessa password al prompt impdp specificato durante l'esportazione.

   • Il parametro dumpfile supporta i caratteri jolly %L e %l oltre ai caratteri jolly %U e %u precedenti. Ad esempio, dumpfile=export%L.dmp. Utilizzare il carattere jolly %L o %l per le esportazioni da Oracle Database Release 12.2 e successive. Questo carattere jolly espande il nome del file di dump in un numero intero incrementale di 3 cifre a 10 cifre e larghezza variabile, a partire da 100 e terminando con 2147483646.

     Utilizzare il carattere jolly precedente %U o %u per le esportazioni da Oracle Database prima della release 12.2. Se si utilizza questa opzione e sono necessari più di 99 file di dump, è necessario specificare più nomi di file di dump, ciascuno con il parametro %U o %u.

   • Se il bucket e i dati non risiedono in un realm commerciale (OC1), in cui gli endpoint dedicati OCI non sono supportati, utilizzare il seguente formato URI per dumpfile:

     https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename

   • Il parametro credential non può essere un principal del servizio Azure, un nome risorsa Amazon (ARN) o un account del servizio Google. Per ulteriori informazioni sull'autenticazione basata sul principal delle risorse, vedere Configura criteri e ruoli per accedere alle risorse.

   • Quando si specifica il valore dumpfile come URL preautenticato, il parametro credential è obbligatorio e il valore può essere NULL.

     Per i dettagli sui passi necessari per utilizzare un URL preautenticato, vedere Usa importazione di Oracle Data Pump con un URL preautenticato.

   Per dumpfile, questo esempio utilizza il formato URI consigliato utilizzando gli endpoint dedicati OCI per il realm commerciale (OC1). namespace-string è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, consulta la sezione relativa agli endpoint dedicati dello storage degli oggetti, alle aree e ai domini di disponibilità e comprensione degli spazi di nomi dello storage degli oggetti.

   Per il formato dell'URL del file di dump per diversi servizi di storage degli oggetti cloud, vedere DBMS_CLOUD Formati URI.

   In questo esempio, durante l'importazione di Data Pump vengono esclusi i seguenti elementi:

   • Cluster

   • Tipi di indice

   • Database link

   Per eseguire un'importazione completa o per importare oggetti di proprietà di altri utenti, è necessario disporre del ruolo DATAPUMP_CLOUD_IMP.

   Per informazioni sugli oggetti non consentiti in Autonomous Database, vedere Comandi SQL.

   Per ulteriori note sull'utilizzo dell'importazione di Oracle Data Pump, vedere Note per l'importazione con Oracle Data Pump.

   Per i dettagli sulla compressione delle tabelle mediante l'importazione di Oracle Data Pump su Autonomous Database, vedere Oracle Data Pump Import and Table Compression.

   Per informazioni dettagliate sui parametri di importazione di Oracle Data Pump, vedere Oracle Database Utilities.

Oracle Data Pump supporta l'importazione di file di Data Pump nell'Autonomous Database utilizzando un principal delle risorse Oracle Cloud Infrastructure come oggetto delle credenziali.

1. Configura i gruppi dinamici e i criteri e abilita il principal delle risorse Oracle Cloud Infrastructure ad accedere alla posizione dell'area di memorizzazione degli oggetti in cui risiedono i file di Data Pump che si desidera importare.

   Per ulteriori informazioni, consulta la sezione relativa all'uso del principal delle risorse per accedere alle risorse di Oracle Cloud Infrastructure.

2. Eseguire l'importazione di Data Pump con il parametro dumpfile impostato sulla lista di URL file nello storage degli oggetti cloud e il parametro credential impostato su OCI$RESOURCE_PRINCIPAL.

   Ad esempio:

   impdp admin/password@db2022adb_high \       
        directory=data_pump_dir \ 
        credential= 'OCI$RESOURCE_PRINCIPAL' \ 
        dumpfile= https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link

   Note per i parametri Data Pump:

   • Se durante l'esportazione con expdp è stato utilizzato il parametro encryption_pwd_prompt=yes, utilizzare anche encryption_pwd_prompt=yes e immettere la stessa password al prompt impdp specificato durante l'esportazione.

   • Il parametro dumpfile supporta i caratteri jolly %L e %l oltre ai caratteri jolly %U e %u precedenti. Ad esempio, dumpfile=export%L.dmp. Utilizzare il carattere jolly %L o %l per le esportazioni da Oracle Database Release 12.2 e successive. Questo carattere jolly espande il nome del file di dump in un numero intero incrementale di 3 cifre a 10 cifre e larghezza variabile, a partire da 100 e terminando con 2147483646.

     Utilizzare il carattere jolly precedente %U o %u per le esportazioni da Oracle Database prima della release 12.2. Se si utilizza questa opzione e sono necessari più di 99 file di dump, è necessario specificare più nomi di file di dump, ciascuno con il parametro %U o %u.

   • Se il bucket e i dati non risiedono in un realm commerciale (OC1), in cui gli endpoint dedicati OCI non sono supportati, utilizzare il seguente formato URI per dumpfile:

     https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename

   • Quando si specifica il valore dumpfile come URL preautenticato, il parametro credential è obbligatorio e il valore può essere NULL.

     Per i dettagli sui passi necessari per utilizzare un URL preautenticato, vedere Usa importazione di Oracle Data Pump con un URL preautenticato.

   Per dumpfile, questo esempio utilizza il formato URI consigliato utilizzando gli endpoint dedicati OCI per il realm commerciale (OC1). namespace-string è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, consulta la sezione relativa agli endpoint dedicati dello storage degli oggetti, alle aree e ai domini di disponibilità e comprensione degli spazi di nomi dello storage degli oggetti.

   Per il formato dell'URL del file di dump per diversi servizi di storage degli oggetti cloud, vedere DBMS_CLOUD Formati URI.

   In questo esempio, durante l'importazione di Data Pump vengono esclusi i seguenti elementi:

   • Cluster

   • Tipi di indice

   • Database link

   Per eseguire un'importazione completa o per importare oggetti di proprietà di altri utenti, è necessario disporre del ruolo DATAPUMP_CLOUD_IMP.

   Per informazioni sugli oggetti non consentiti in Autonomous Database, vedere Comandi SQL.

   Per ulteriori note sull'utilizzo dell'importazione di Oracle Data Pump, vedere Note per l'importazione con Oracle Data Pump.

   Per informazioni dettagliate sui parametri di importazione di Oracle Data Pump, vedere Oracle Database Utilities.

È possibile importare i dati dai file Data Pump in Autonomous Database utilizzando le versioni del client Data Pump 12.2.0.1 e precedenti impostando il parametro default_credential.

1. Memorizzare le credenziali dello storage degli oggetti cloud utilizzando DBMS_CLOUD.CREATE_CREDENTIAL.

   Ad esempio, per creare le credenziali del token di autenticazione di Oracle Cloud Infrastructure:

   BEGIN
     DBMS_CLOUD.CREATE_CREDENTIAL(
       credential_name => 'DEF_CRED_NAME',
       username => 'adb_user@example.com',
       password => 'password'
     );
   END;
   /

   Per ulteriori informazioni sull'autenticazione del token di autenticazione di Oracle Cloud Infrastructure, vedere CREATE_CREDENTIAL Procedura.

   Ad esempio, per creare credenziali basate sulla chiave di firma di Oracle Cloud Infrastructure:

   BEGIN
      DBMS_CLOUD.CREATE_CREDENTIAL (
          credential_name => 'DEF_CRED_NAME',
          user_ocid       => ‘ocid1.user.oc1..aaaaaaaauq54mi7zdyfhw33ozkwuontjceel7fok5nq3bf2vwetkpqsoa’,
          tenancy_ocid    => ‘ocid1.tenancy.oc1..aabbbbbbaafcue47pqmrf4vigneebgbcmmoy5r7xvoypicjqqge32ewnrcyx2a’,
          private_key     => ‘MIIEogIBAAKCAQEAtUnxbmrekwgVac6FdWeRzoXvIpA9+0r1.....wtnNpESQQQ0QLGPD8NM//JEBg=’,
          fingerprint     => ‘f2:db:f9:18:a4:aa:fc:94:f4:f6:6c:39:96:16:aa:27’);
   END;
   /

   Per ulteriori informazioni sulle credenziali basate sulla chiave di firma di Oracle Cloud Infrastructure, vedere CREATE_CREDENTIAL Procedura.

   Tipi di credenziali supportati:

   • L'importazione di Data Pump supporta le credenziali basate su token di autenticazione di Oracle Cloud Infrastructure e le credenziali basate su chiave di firma di Oracle Cloud Infrastructure.

     Per ulteriori informazioni sui tipi di credenziali per lo storage degli oggetti Oracle Cloud Infrastructure Cloud, vedere CREATE_CREDENTIAL Procedura.

   • Data Pump supporta l'uso di un URL preautenticato di Oracle Cloud Infrastructure Object Storage per dumpfile. Quando si utilizza un URL preautenticato, è necessario impostare DEFAULT_CREDENTIAL e il valore DEFAULT_CREDENTIAL può essere NULL. Per ulteriori informazioni, vedere Utilizzo delle richieste preautenticate.

   • Data Pump supporta l'utilizzo di una credenziale di principal risorsa con impdp.

2. Impostare la credenziale come credenziale predefinita per Autonomous Database come utente ADMIN. Ad esempio:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   DEFAULT_CREDENTIAL può essere un principal risorsa OCI. Ad esempio:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'OCI$RESOURCE_PRINCIPAL'

   Per ulteriori informazioni sull'autenticazione basata sul principal delle risorse, vedere Configura criteri e ruoli per accedere alle risorse.

   Nota
   
   Il valore DEFAULT_CREDENTIAL non può essere un principal di servizio di Azure, un nome risorsa Amazon (ARN) o un account di servizio Google.

   Il valore DEFAULT_CREDENTIAL può essere impostato su NULL se si utilizza un URL preautenticato.

3. Eseguire l'importazione di Data Pump con il parametro dumpfile impostato sulla lista degli URL di file nello storage degli oggetti cloud e impostare la parola chiave default_credential. Ad esempio:

   impdp admin/password@db2022adb_high \      
        directory=data_pump_dir \
        dumpfile=default_credential:https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/export%l.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        exclude=cluster,indextype,db_link
   

   Note per i parametri Data Pump:

   • Se durante l'esportazione con expdp si è utilizzato il parametro encryption_pwd_prompt=yes, utilizzare encryption_pwd_prompt=yes e immettere la stessa password al prompt impdp specificato durante l'esportazione.

   • Il parametro dumpfile supporta i caratteri jolly %L e %l oltre ai caratteri jolly %U e %u precedenti. Ad esempio, dumpfile=export%L.dmp. Utilizzare il carattere jolly %L o %l per le esportazioni da Oracle Database Release 12.2 e successive. Questo carattere jolly espande il nome del file di dump in un numero intero incrementale di 3 cifre a 10 cifre e larghezza variabile, a partire da 100 e terminando con 2147483646.

     Utilizzare il carattere jolly precedente %U o %u per le esportazioni da Oracle Database prima della release 12.2. Se si utilizza questa opzione e sono necessari più di 99 file di dump, è necessario specificare più nomi di file di dump, ciascuno con il parametro %U o %u.

   • Se il bucket e i dati non risiedono in un realm commerciale (OC1), in cui gli endpoint dedicati OCI non sono supportati, utilizzare il seguente formato URI per dumpfile:

     https://objectstorage.region.oraclecloud.com/n/namespace-string/b/bucketname/o/filename

   • Quando si specifica il valore dumpfile come URL preautenticato, l'impostazione del parametro default_credential è obbligatoria e il valore può essere NULL.

     Per i dettagli sui passi necessari per utilizzare un URL preautenticato, vedere Usa importazione di Oracle Data Pump con un URL preautenticato.

   Per dumpfile, questo esempio utilizza il formato URI consigliato utilizzando gli endpoint dedicati OCI per il realm commerciale (OC1). namespace-string è lo spazio di nomi dello storage degli oggetti Oracle Cloud Infrastructure e bucketname è il nome del bucket. Per ulteriori informazioni, consulta la sezione relativa agli endpoint dedicati dello storage degli oggetti, alle aree e ai domini di disponibilità e comprensione degli spazi di nomi dello storage degli oggetti.

   Per il formato dell'URL del file di dump per diversi servizi di storage degli oggetti cloud, vedere DBMS_CLOUD Formati URI.

   In questo esempio, durante l'importazione di Data Pump vengono esclusi i seguenti elementi:

   • Cluster

   • Tipi di indice

   • Database link

Fornisce i passi per utilizzare un URL preautenticato (URL PAR) con l'importazione di Oracle Data Pump.

1. Utilizzare Oracle Data Pump expdp ed eseguire l'esportazione nella memoria locale.

   Per ulteriori informazioni, vedere Esporta l'Oracle Database esistente in un file di database locale (Esporta senza parametro delle credenziali).

2. Caricare i file di dump in Oracle Cloud Infrastructure Object Storage.

   Ad esempio, utilizzare DBMS_CLOUD.PUT_OBJECT per caricare i file di dump.

3. Creare un URL preautenticato in Oracle Cloud Infrastructure Object Storage, nel bucket dell'area di memorizzazione degli oggetti se sono presenti più file di dump o nel file di dump, se è presente un solo file.

   Per ulteriori informazioni, vedere Richieste preautenticate di storage degli oggetti.

4. Importare i file di dump con il valore del parametro dumpfile impostato nell'URL preautenticato.

   Per ulteriori informazioni, vedere Importazione di dati mediante Oracle Data Pump versione 18.3 o successive.