Importa dati con la versione più recente o precedente di Oracle Data Pump

Oracle consiglia di utilizzare la versione più recente di Oracle Data Pump per importare i dati dai file Data Pump nell'Autonomous Database, poiché 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 Procedure.

   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 Procedure.

   Tipi di credenziali supportati:

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

     Per ulteriori informazioni sui tipi di credenziali per Oracle Cloud Infrastructure Cloud Object Storage, vedere CREATE_CREDENTIAL Procedure.

   • 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, fornire il parametro credential obbligatorio e il valore credential può essere NULL. Per ulteriori informazioni, vedere Utilizzo delle richieste preautenticate.

   • Data Pump supporta l'uso di una credenziale principal risorsa con impdp. Per ulteriori informazioni, vedere Importare i dati utilizzando Oracle Data Pump versione 18.3 o successive con OCI Resource Principal.

2. Eseguire l'importazione di Data Pump con il parametro dumpfile impostato sulla lista degli URL di file nello storage degli oggetti cloud e il parametro credential 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 è stato 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 legacy %U e %u. 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 a 3 cifre a 10 cifre e a larghezza variabile, a partire da 100 e terminando a 2147483646.

     Utilizzare il carattere jolly legacy %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 su principal risorsa, 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 informazioni dettagliate 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, vedere Endpoint dedicati dello storage degli oggetti, Aree e domini di disponibilità e Informazioni sugli 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'uso dell'importazione di Oracle Data Pump, vedere Note per l'importazione con Oracle Data Pump.

   Per informazioni dettagliate sulla compressione delle tabelle mediante l'importazione di Oracle Data Pump in Autonomous Database, vedere Importazione e compressione delle tabelle di Oracle Data Pump.

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

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

1. Configurare i gruppi dinamici e i criteri e abilitare il principal risorsa di Oracle Cloud Infrastructure per accedere alla posizione dell'area di memorizzazione degli oggetti in cui risiedono i file Data Pump che si desidera importare.

   Per ulteriori informazioni, consulta la sezione Usa principal risorsa per accedere alle risorse di Oracle Cloud Infrastructure.

2. Eseguire l'importazione di Data Pump con il parametro dumpfile impostato sulla lista degli URL di 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 legacy %U e %u. 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 a 3 cifre a 10 cifre e a larghezza variabile, a partire da 100 e terminando a 2147483646.

     Utilizzare il carattere jolly legacy %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 informazioni dettagliate 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, vedere Endpoint dedicati dello storage degli oggetti, Aree e domini di disponibilità e Informazioni sugli 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'uso 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 Procedure.

   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 Procedure.

   Tipi di credenziali supportati:

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

     Per ulteriori informazioni sui tipi di credenziali per Oracle Cloud Infrastructure Cloud Object Storage, vedere CREATE_CREDENTIAL Procedure.

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

   • Data Pump supporta l'uso di una credenziale 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 su principal risorsa, vedere Configura criteri e ruoli per accedere alle risorse.

   Nota
   
   Il valore DEFAULT_CREDENTIAL non può essere un principal del servizio Azure, un nome risorsa Amazon (ARN) o un account del 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 di Data Pump:

   • Se durante l'esportazione con expdp è stato 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 legacy %U e %u. 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 a 3 cifre a 10 cifre e a larghezza variabile, a partire da 100 e terminando a 2147483646.

     Utilizzare il carattere jolly legacy %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 informazioni dettagliate 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, vedere Endpoint dedicati dello storage degli oggetti, Aree e domini di disponibilità e Informazioni sugli 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 PAR preautenticato con l'importazione di Oracle Data Pump.

1. Utilizzare Oracle Data Pump expdp ed eseguire l'esportazione nello storage locale.

   Per ulteriori informazioni, vedere Esportazione di Oracle Database esistente in un file di database locale (esportazione 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 dello 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.