Zeigt die Schritte zum Exportieren von Daten aus Autonomous Database in Cloud-Objektspeicher mit Oracle Data Pump-Export und zum Festlegen der Eigenschaft DEFAULT_CREDENTIAL an.

1. Stellen Sie eine Verbindung zur autonomen Datenbank her.
2. Speichern Sie die Zugangsdaten für den Cloudobjektspeicher mit DBMS_CLOUD.CREATE_CREDENTIAL. Beispiele:

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

   Die Werte, die Sie für username und password angeben, hängen vom verwendeten Cloud-Objektspeicherservice ab.

   Wenn Sie in Oracle Cloud Infrastructure Object Storage exportieren, können Sie die nativen Oracle Cloud Infrastructure-URIs oder Swift-URIs verwenden. Die Zugangsdaten müssen jedoch Authentifizierungstoken sein. Weitere Informationen finden Sie unter Prozedur CREATE_CREDENTIAL.

3. Legen Sie als ADMIN-Benutzer die in Schritt 2 definierten Zugangsdaten als Standardzugangsdaten für Ihre Datenbank fest. Beispiele:

   ALTER DATABASE PROPERTY SET DEFAULT_CREDENTIAL = 'ADMIN.DEF_CRED_NAME'

   Der Wert DEFAULT_CREDENTIAL kann kein OCI-Resource Principal, Azure-Service-Principal, Amazon-Ressourcenname (ARN) oder Google-Serviceaccount sein. Weitere Informationen zur Resource Principal-basierten Authentifizierung finden Sie unter Policys und Rollen für den Zugriff auf Ressourcen konfigurieren.

4. Führen Sie den Data Pump-Export aus, wobei der Parameter dumpfile auf die URL für einen vorhandenen Bucket in Ihrem Cloud-Objektspeicher gesetzt ist (mit einem Dateinamen oder einem Dateinamen mit einer Substitutionsvariable, wie exp%L.dmp). Beispiele:

   expdp admin/password@db2022adb_high \
        filesize=5GB \
        dumpfile=default_credential:https://namespace-string.objectstorage.us-ashburn-1.oci.customer-oci.com/n/namespace-string/b/bucketname/o/exp%L.dmp \
        parallel=16 \
        encryption_pwd_prompt=yes \
        logfile=export.log \
        directory=data_pump_dir
   

   Hinweise zu Data Pump-Parametern:

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

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

   • Wenn sich der Bucket und die Daten nicht in einer kommerziellen Realm (OC1) befinden, in der dedizierte OCI-Endpunkte 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

   Für 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 der Bucket-Name. Weitere Informationen finden Sie unter Dedizierte Object Storage-Endpunkte, Regionen und Availability-Domains und Object Storage-Namespaces.

   Das Schlüsselwort default_credential im Parameter dumpfile ist erforderlich.

   Um die beste Exportperformance zu erzielen, verwenden Sie den Datenbankservice HIGH für die Exportverbindung, und setzen Sie den Parameter parallel auf ein Quartal mit der Anzahl der ECPUs (.25 x ECPU-Anzahl). Wenn Sie das OCPU-Compute-Modell verwenden, setzen Sie den parallelen Parameter auf die Anzahl der OCPUs (1 x OCPU-Anzahl).

   Informationen dazu, welcher Datenbankservicename für die Ausführung des Data Pump-Exports verbunden werden soll, finden Sie unter Nebenläufigkeit und Prioritäten in Autonomous Database verwalten.

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

   In diesem Beispiel werden die empfohlenen Parameter für den Export aus Autonomous Database gezeigt. Beachten Sie bei diesen expdp-Parametern Folgendes:

   • Der maximale Wert des Parameters filesize beträgt 100000 MB für Oracle Cloud Infrastructure Object Storage-Exporte.

   • Der maximale Wert des Parameters filesize beträgt 20 GB für Oracle Cloud Infrastructure Object Storage Classic-Exporte.

   • Wenn die angegebene filesize zu groß ist, wird beim Export folgende Fehlermeldung angezeigt:

     ORA-17500: ODM err:ODM HTTP Request Entity Too Large

   • Der Parameter directory gibt das Verzeichnis data_pump_dir für die angegebene Logdatei export.log an. Weitere Informationen finden Sie unter Logdateien für Data Pump-Export aufrufen.

   Oracle Data Pump unterteilt jeden Teil der Dumpdatei in kleinere Chunks, um schnellere Uploads zu ermöglichen. In der Oracle Cloud Infrastructure Object Storage-Konsole werden für jeden exportierten Teil der Dumpdatei mehrere Dateien angezeigt. Die Größe der tatsächlichen Dumpdateien wird als null (0) angezeigt und die Größe der zugehörigen Datei-Chunks als 10 MB oder weniger. Beispiele:

   exp100.dmp
   exp100.dmp_aaaaaa
   exp101.dmp
   exp101.dmp_aaaaaa

   Wenn Sie die Null-Byte-Dumpdatei aus der Oracle Cloud Infrastructure-Konsole oder mit der Oracle Cloud Infrastructure-CLI herunterladen, erhalten Sie nicht die vollständigen Dumpdateien. Um die vollständigen Dumpdateien aus dem Objektspeicher herunterzuladen, verwenden Sie ein Tool wie cURL, das Swift unterstützt. Geben Sie Ihre Benutzeranmeldung und Ihr Swift-Authentifizierungstoken an. Beispiele:

   curl -O -v -X GET -u 'user1@example.com:auth_token' \
      https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/namespace-string/bucketname/exp100.dmp

   Wenn Sie eine Datei mit den DBMS_CLOUD-Prozeduren importieren, die den format-Parameter type mit dem Wert datapump unterstützen, müssen Sie nur den primären Dateinamen angeben. Die Prozeduren, die den Formattyp "datapump" unterstützen, ermitteln die Chunks und laden sie automatisch herunter.

   Wenn Sie DBMS_CLOUD.DELETE_OBJECT verwenden, werden die Chunks automatisch von der Prozedur erkannt und gelöscht, wenn die Prozedur die primäre Datei löscht.

5. Führen Sie die erforderlichen Schritte aus, um den Oracle Data Pump-Import auszuführen und die Bereinigung vorzunehmen.

   Weitere Informationen finden Sie unter Dumpdateien herunterladen, Data Pump-Import ausführen und Objektspeicher löschen.