Daten mit der neuesten Version von Oracle Data Pump oder einer älteren Version importieren

Oracle empfiehlt, die neueste Oracle Data Pump-Version für das Importieren von Daten aus Data Pump-Dateien in Ihre autonome KI-Datenbank zu verwenden, da sie Verbesserungen und Fixes für eine bessere Erfahrung enthält.

1. Speichern Sie Ihre Zugangsdaten für die Cloud-Objektspeicher mit DBMS_CLOUD.CREATE_CREDENTIAL.

   Beispiel: So erstellen Sie Zugangsdaten für Oracle Cloud Infrastructure-Authentifizierungstoken mit der Standardidentitätsdomain:

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

   Für OCI Object Storage muss der Parameterwert username die Identitätsdomain und den Benutzernamen aus Ihrem Profil enthalten. Die mit einem Benutzer verknüpfte Identitätsdomain finden Sie in der Oracle Cloud Infrastructure-Konsole. Beispiel: Bei der Identitätsdomain oracleidentitycloudservice:

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

   Weitere Informationen zur Authentifizierung des Oracle Cloud Infrastructure-Authentifizierungstokens finden Sie unter Prozedur CREATE_CREDENTIAL.

   Beispiel: So erstellen Sie Oracle Cloud Infrastructure-Signaturschlüssel-basierte Zugangsdaten:

   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;
   /

   Weitere Informationen zu auf dem Oracle Cloud Infrastructure-Signaturschlüssel basierenden Zugangsdaten finden Sie unter Prozedur CREATE_CREDENTIAL.

   Unterstützte Zugangsdatentypen:

   • Data Pump Import unterstützt auf Oracle Cloud Infrastructure-Authentifizierungstoken basierende Zugangsdaten und auf Oracle Cloud Infrastructure-Signaturschlüsseln basierende Zugangsdaten.

     Weitere Informationen zu den Zugangsdatentypen für Oracle Cloud Infrastructure Cloud Object Storage finden Sie unter Prozedur CREATE_CREDENTIAL.

   • Data Pump unterstützt die Verwendung einer vorab authentifizierten Oracle Cloud Infrastructure Object Storage-URL für den Parameter dumpfile. Wenn Sie eine vorab authentifizierte URL verwenden, ist die Angabe des Parameters credential erforderlich, und der Wert für credential kann NULL lauten. Weitere Informationen finden Sie unter Vorab authentifizierte Anforderungen verwenden.

   • Data Pump unterstützt die Verwendung von Resource Principal-Zugangsdaten mit impdp. Weitere Informationen finden Sie unter Daten mit Oracle Data Pump Version 18.3 oder höher mit OCI Resource Principal importieren.

2. Führen Sie Data Pump Import aus, wobei der Parameter dumpfile auf die Liste der Datei-URLs in Ihrem Cloud-Objektspeicher gesetzt ist und der Parameter credential auf den Namen der Zugangsdaten gesetzt ist, die Sie im vorherigen Schritt erstellt haben. Beispiel:

   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

   Hinweise zu Data Pump-Parametern:

   • Wenn Sie während des Exports mit expdp den Parameter encryption_pwd_prompt=yes verwenden, verwenden Sie encryption_pwd_prompt=yes mit dem Import und dasselbe Kennwort beim impdp-Prompt, das Sie beim Export angegeben haben.

   • Der Parameter dumpfile unterstützt zusätzlich zu den Legacy-Platzhaltern %U und %u die Platzhalter %L und %l. Beispiel: dumpfile=export%L.dmp. Verwenden Sie den Platzhalter %L oder %l für Exporte aus Oracle AI Database Release 12.2 und höher. Dieser Platzhalter erweitert den Namen der Dumpdatei in eine 3-stellige Ganzzahl mit variabler Breite, die bei 100 beginnt und bei 2147483646 endet.

     Verwenden Sie den Legacy-Platzhalter %U oder %u für Exporte aus Oracle Database vor Release 12.2. Wenn Sie diese Option verwenden und mehr als 99 Dumpdateien erforderlich sind, müssen Sie mehrere Dumpdateinamen angeben, die jeweils den Parameter %U oder %u enthalten.

   • Wenn sich Ihr Bucket und Ihre Daten nicht in einer kommerziellen Realm (OC1) befinden, in der OCI Dedicated Endpoints nicht unterstützt werden, verwenden Sie das folgende URI-Format für dumpfile:

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

   • Der Parameter credential kann kein Azure-Service-Principal, Amazon Resource Name (ARN) oder Google-Serviceaccount sein. Weitere Informationen zur Authentifizierung auf Basis von Resource Principals finden Sie unter Policys und Rollen für den Zugriff auf Ressourcen konfigurieren.

   • Wenn Sie den Wert dumpfile als vorab authentifizierte URL angeben, ist der Parameter credential erforderlich, und der Wert kann NULL lauten.

     Weitere Informationen zu den Schritten, die zur Verwendung einer vorab authentifizierten URL erforderlich sind, finden Sie unter Oracle Data Pump-Import mit einer vorab authentifizierten URL verwenden.

   Bei dumpfile verwendet dieses Beispiel das empfohlene URI-Format mit OCI Dedicated Endpoints für die kommerzielle Realm (OC1). namespace-string ist der Oracle Cloud Infrastructure-Objektspeicher-Namespace, und bucketname ist der Bucket-Name. Weitere Informationen finden Sie unter Dedizierte Object Storage-Endpunkte, Regionen und Availability-Domains und Object Storage-Namespaces.

   Informationen zum URL-Format der Dumpdatei für verschiedene Cloud Object Storage-Services finden Sie unter URI-Formate für DBMS_CLOUD.

   In diesem Beispiel werden beim Data Pump-Import folgende Elemente ausgeschlossen:

   • Cluster

   • Indextypen

   • Datenbanklinks

   Um einen vollständigen Import durchzuführen oder Objekte zu importieren, deren Eigentümer andere Benutzer sind, benötigen Sie die Rolle DATAPUMP_CLOUD_IMP.

   Informationen zu nicht zulässigen Objekten in Autonomous AI Database finden Sie unter SQL-Befehle.

   Weitere Hinweise zur Verwendung von Oracle Data Pump-Import finden Sie unter Hinweise zum Importieren mit Oracle Data Pump.

   Details zur Tabellenkomprimierung mit dem Oracle Data Pump-Import in Autonomous AI Database finden Sie unter Oracle Data Pump-Import und -Tabellenkomprimierung.

   Ausführliche Informationen zu Oracle Data Pump Import-Parametern finden Sie unter Oracle Database-Utilitys.

Oracle Data Pump unterstützt den Import von Data Pump-Dateien in Ihre autonome KI-Datenbank mit einem Oracle Cloud Infrastructure-Resource Principal als Zugangsdatenobjekt.

1. Konfigurieren Sie die dynamischen Gruppen und Policys, und ermöglichen Sie dem Resource Principal von Oracle Cloud Infrastructure den Zugriff auf den Objektspeicherort, in dem sich die zu importierenden Data Pump-Dateien befinden.

   Weitere Informationen finden Sie unter Resource Principal für den Zugriff auf Oracle Cloud Infrastructure-Ressourcen nutzen.

2. Führen Sie Data Pump Import aus, wobei der Parameter dumpfile auf die Liste der Datei-URLs in Ihrem Cloud-Objektspeicher gesetzt ist und der Parameter credential auf OCI$RESOURCE_PRINCIPAL gesetzt ist.

   Beispiel:

   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

   Hinweise zu Data Pump-Parametern:

   • Wenn Sie beim Export mit expdp den Parameter encryption_pwd_prompt=yes verwendet haben, verwenden Sie auch encryption_pwd_prompt=yes, und geben Sie dasselbe Kennwort an der Eingabeaufforderung impdp ein, die Sie beim Export angegeben haben.

   • Der Parameter dumpfile unterstützt zusätzlich zu den Legacy-Platzhaltern %U und %u die Platzhalter %L und %l. Beispiel: dumpfile=export%L.dmp. Verwenden Sie den Platzhalter %L oder %l für Exporte aus Oracle AI Database Release 12.2 und höher. Dieser Platzhalter erweitert den Namen der Dumpdatei in eine 3-stellige Ganzzahl mit variabler Breite, die bei 100 beginnt und bei 2147483646 endet.

     Verwenden Sie den Legacy-Platzhalter %U oder %u für Exporte aus Oracle Database vor Release 12.2. Wenn Sie diese Option verwenden und mehr als 99 Dumpdateien erforderlich sind, müssen Sie mehrere Dumpdateinamen angeben, die jeweils den Parameter %U oder %u enthalten.

   • Wenn sich Ihr Bucket und Ihre Daten nicht in einer kommerziellen Realm (OC1) befinden, in der OCI Dedicated Endpoints nicht unterstützt werden, verwenden Sie das folgende URI-Format für dumpfile:

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

   • Wenn Sie den Wert dumpfile als vorab authentifizierte URL angeben, ist der Parameter credential erforderlich, und der Wert kann NULL lauten.

     Weitere Informationen zu den Schritten, die zur Verwendung einer vorab authentifizierten URL erforderlich sind, finden Sie unter Oracle Data Pump-Import mit einer vorab authentifizierten URL verwenden.

   Bei dumpfile verwendet dieses Beispiel das empfohlene URI-Format mit OCI Dedicated Endpoints für die kommerzielle Realm (OC1). namespace-string ist der Oracle Cloud Infrastructure-Objektspeicher-Namespace, und bucketname ist der Bucket-Name. Weitere Informationen finden Sie unter Dedizierte Object Storage-Endpunkte, Regionen und Availability-Domains und Object Storage-Namespaces.

   Informationen zum URL-Format der Dumpdatei für verschiedene Cloud Object Storage-Services finden Sie unter URI-Formate für DBMS_CLOUD.

   In diesem Beispiel werden beim Data Pump-Import folgende Elemente ausgeschlossen:

   • Cluster

   • Indextypen

   • Datenbanklinks

   Um einen vollständigen Import durchzuführen oder Objekte zu importieren, deren Eigentümer andere Benutzer sind, benötigen Sie die Rolle DATAPUMP_CLOUD_IMP.

   Informationen zu nicht zulässigen Objekten in Autonomous AI Database finden Sie unter SQL-Befehle.

   Weitere Hinweise zur Verwendung von Oracle Data Pump-Import finden Sie unter Hinweise zum Importieren mit Oracle Data Pump.

   Ausführliche Informationen zu Oracle Data Pump Import-Parametern finden Sie unter Oracle Database-Utilitys.

Sie können Daten aus Data Pump-Dateien mit den Data Pump-Clientversionen 12.2.0.1 und früher in die autonome KI-Datenbank importieren, indem Sie den Parameter default_credential festlegen.

1. Speichern Sie Ihre Zugangsdaten für Cloud-Objektspeicher mit DBMS_CLOUD.CREATE_CREDENTIAL.

   Beispiel: So erstellen Sie Zugangsdaten für das Oracle Cloud Infrastructure-Authentifizierungstoken:

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

   Weitere Informationen zur Authentifizierung des Oracle Cloud Infrastructure-Authentifizierungstokens finden Sie unter Prozedur CREATE_CREDENTIAL.

   Beispiel: So erstellen Sie Oracle Cloud Infrastructure-Signaturschlüssel-basierte Zugangsdaten:

   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;
   /

   Weitere Informationen zu auf dem Oracle Cloud Infrastructure-Signaturschlüssel basierenden Zugangsdaten finden Sie unter Prozedur CREATE_CREDENTIAL.

   Unterstützte Zugangsdatentypen:

   • Data Pump-Import unterstützt auf Oracle Cloud Infrastructure-Authentifizierungstoken basierende Zugangsdaten und auf Oracle Cloud Infrastructure-Signaturschlüsseln basierende Zugangsdaten.

     Weitere Informationen zu den Zugangsdatentypen für Oracle Cloud Infrastructure Cloud Object Storage finden Sie unter Prozedur CREATE_CREDENTIAL.

   • Data Pump unterstützt die Verwendung einer vorab authentifizierten Oracle Cloud Infrastructure Object Storage-URL für die dumpfile. Wenn Sie eine vorab authentifizierte URL verwenden, ist die Festlegung von DEFAULT_CREDENTIAL erforderlich, und der Wert für DEFAULT_CREDENTIAL kann NULL lauten. Weitere Informationen finden Sie unter Vorab authentifizierte Anforderungen verwenden.

   • Data Pump unterstützt die Verwendung von Resource Principal-Zugangsdaten mit impdp.

2. Legen Sie die Zugangsdaten als Standardzugangsdaten für die autonome KI-Datenbank als ADMIN-Benutzer fest. Beispiel:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   Die DEFAULT_CREDENTIAL kann ein OCI-Resource Principal sein. Beispiel:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'OCI$RESOURCE_PRINCIPAL'

   Weitere Informationen zur Authentifizierung auf Basis von Resource Principals finden Sie unter Policys und Rollen für den Zugriff auf Ressourcen konfigurieren.

   Hinweis
   
   Der Wert DEFAULT_CREDENTIAL kann kein Azure-Service-Principal, Amazon Resource Name (ARN) oder Google-Serviceaccount sein.

   Der Wert DEFAULT_CREDENTIAL kann auf NULL gesetzt werden, wenn Sie eine vorab authentifizierte URL verwenden.

3. Führen Sie Data Pump Import aus, wobei der Parameter dumpfile auf die Liste der Datei-URLs in Ihrem Cloud-Objektspeicher gesetzt ist, und legen Sie das Schlüsselwort default_credential fest. Beispiel:

   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
   

   Hinweise zu den Data Pump-Parametern:

   • Wenn Sie während des Exports mit expdp den Parameter encryption_pwd_prompt=yes verwenden, verwenden Sie encryption_pwd_prompt=yes mit dem Import und dasselbe Kennwort beim impdp-Prompt, das Sie beim Export angegeben haben.

   • Der Parameter dumpfile unterstützt zusätzlich zu den Legacy-Platzhaltern %U und %u die Platzhalter %L und %l. Beispiel: dumpfile=export%L.dmp. Verwenden Sie den Platzhalter %L oder %l für Exporte aus Oracle AI Database Release 12.2 und höher. Dieser Platzhalter erweitert den Namen der Dumpdatei in eine 3-stellige Ganzzahl mit variabler Breite, die bei 100 beginnt und bei 2147483646 endet.

     Verwenden Sie den Legacy-Platzhalter %U oder %u für Exporte aus Oracle Database vor Release 12.2. Wenn Sie diese Option verwenden und mehr als 99 Dumpdateien erforderlich sind, müssen Sie mehrere Dumpdateinamen angeben, die jeweils den Parameter %U oder %u enthalten.

   • Wenn sich Ihr Bucket und Ihre Daten nicht in einer kommerziellen Realm (OC1) befinden, in der OCI Dedicated Endpoints nicht unterstützt werden, verwenden Sie das folgende URI-Format für dumpfile:

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

   • Wenn Sie den Wert dumpfile als vorab authentifizierte URL angeben, ist die Einstellung des Parameters default_credential erforderlich, und der Wert kann NULL lauten.

     Weitere Informationen zu den Schritten, die zur Verwendung einer vorab authentifizierten URL erforderlich sind, finden Sie unter Oracle Data Pump-Import mit einer vorab authentifizierten URL verwenden.

   Bei dumpfile verwendet dieses Beispiel das empfohlene URI-Format mit OCI Dedicated Endpoints für die kommerzielle Realm (OC1). namespace-string ist der Oracle Cloud Infrastructure-Objektspeicher-Namespace, und bucketname ist der Bucket-Name. Weitere Informationen finden Sie unter Dedizierte Object Storage-Endpunkte, Regionen und Availability-Domains und Object Storage-Namespaces.

   Informationen zum URL-Format der Dumpdatei für verschiedene Cloud Object Storage-Services finden Sie unter URI-Formate für DBMS_CLOUD.

   In diesem Beispiel werden beim Data Pump-Import folgende Elemente ausgeschlossen:

   • Cluster

   • Indextypen

   • Datenbanklinks

Enthält die Schritte zur Verwendung einer vorab authentifizierten URL (PAR-URL) mit Oracle Data Pump Import.

1. Verwenden Sie Oracle Data Pump expdp, und exportieren Sie in den lokalen Speicher.

   Weitere Informationen finden Sie unter Vorhandene Oracle Database in eine lokale Datenbankdatei exportieren (ohne Zugangsdatenparameter exportieren).

2. Laden Sie die Dumpdateien in Oracle Cloud Infrastructure Object Storage hoch.

   Beispiel: Verwenden Sie DBMS_CLOUD.PUT_OBJECT, um die Dumpdateien hochzuladen.

3. Erstellen Sie eine vorab authentifizierte URL in Oracle Cloud Infrastructure Object Storage, entweder im Objektspeicher-Bucket, wenn mehrere Dumpdateien vorhanden sind, oder in der Dumpdatei, wenn nur eine Datei vorhanden ist.

   Weitere Informationen finden Sie unter Vorab authentifizierte Anforderungen für Object Storage.

4. Importieren Sie die Dumpdateien, deren Parameterwert dumpfile auf die vorab authentifizierte URL gesetzt ist.

   Weitere Informationen finden Sie unter Daten mit Oracle Data Pump Version 18.3 oder höher importieren.