Oracle Cloud Infrastructure-Dokumentation

Daten mit "CREDENTIAL" in Objektspeicher mit Oracle Data Pump exportieren

Zeigt die Schritte zum Exportieren von Daten aus Ihrer autonomen KI-Datenbank in Cloud Object Storage mit Oracle Data Pump-Export mit dem Parameter credential an.

Oracle empfiehlt, die neueste Oracle Data Pump-Version für das Exportieren von Daten aus einer autonomen KI-Datenbank in andere Oracle-Datenbanken zu verwenden, da dies Verbesserungen und Fixes für eine bessere Erfahrung enthält. Laden Sie die neueste Version von Oracle Instant Client herunter, und laden Sie das Toolpackage, das Oracle Data Pump enthält, für Ihre Plattform von Oracle Instant Client-Downloads herunter. Die Installationsschritte, die nach dem Herunterladen von Oracle Instant Client und dem Toolpackage erforderlich sind, finden Sie in den Installationsanweisungen auf der Downloadseite für die Plattforminstallation.

Hinweis

Hinweis:

  • Oracle Autonomous AI Database Serverless unterstützt Resource-Principal-Zugangsdaten und native OCI-Authentifizierung für Data Pump-Exporte nur in Oracle AI Database 26ai, nicht in Oracle AI Database 19c.

  • Database Actions stellt einen Link für Oracle Instant Client bereit. Um über Database Actions auf diesen Link zuzugreifen, klicken Sie unter Downloads auf Oracle Instant Client herunterladen.

Wenn Sie Oracle Data Pump Version 19.9 oder höher verwenden, können Sie den Parameter credential wie in diesen Schritten gezeigt verwenden. Anweisungen zur Verwendung von Oracle Data Pump-Versionen 19.8 und früher finden Sie unter Daten mit Oracle Data Pump in Objektspeicher exportieren - Einstellung DEFAULT_CREDENTIAL festlegen.

  1. Stellen Sie eine Verbindung zu Ihrer Datenbank her.

  2. Speichern Sie Ihre Zugangsdaten für Cloud-Objektspeicher mit DBMS_CLOUD.CREATE_CREDENTIAL. Beispiel:

    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, hängen die verfügbaren Authentifizierungsmethoden von der Datenbankversion ab:

    • In Oracle AI Database 26ai können Sie native URIs von Oracle Cloud Infrastructure mit nativer OCI-Authentifizierung verwenden, einschließlich Resource Principal Credntials.

    • In Oracle AI Database 19c können Sie native URIs oder Swift-URIs von Oracle Cloud Infrastructure verwenden. Die Zugangsdaten müssen jedoch Authentifizierungstoken sein.

    Weitere Informationen finden Sie unter CREATE_CREDENTIAL Procedure.

  3. Führen Sie Data Pump Export aus, wobei der Parameter dumpfile auf die URL für einen vorhandenen Bucket in Ihrem Cloud-Objektspeicher gesetzt ist und mit einem Dateinamen oder einem Dateinamen mit einer Substitutionsvariable, wie exp%L.dmp, endet, und der Parameter credential auf den Namen der im vorherigen Schritt erstellten Zugangsdaten gesetzt ist. Beispiel:

    expdp admin/password@db2022adb_high \
     filesize=5GB \
     credential=def_cred_name \
     dumpfile=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 Oracle 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 die Platzhalter %L und %l. Dieser Platzhalter erweitert den Namen der Dumpdatei in eine 3-stellige Ganzzahl mit variabler Breite, die bei 100 beginnt und bei 2147483646 endet.

    • Wenn sich Ihr Bucket und Ihre Daten nicht in einer kommerziellen Realm 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

    In diesem Beispiel wird für dumpfile das empfohlene URI-Format mit OCI Dedicated Endpoints für die kommerzielle Realm verwendet. 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.

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

    Informationen dazu, welcher Datenbankserviceiname für die Ausführung des Data Pump-Exports verbunden werden soll, finden Sie unter Datenbankservicenamen für autonome KI.

    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 einer autonomen KI-Datenbank angezeigt. Beachten Sie für diese expdp-Parameter Folgendes:

    • Der maximale Parameterwert filesize beträgt 10000 MB für Oracle Cloud Infrastructure Object Storage-Exporte.

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

    • Wenn die angegebene filesize zu groß ist, zeigt der Export die Fehlermeldung an:

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

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

    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. Beispiel:

    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. Beispiel:

    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 Parameter format type mit dem Wert "datapump" unterstützen, müssen Sie nur den Namen der primären Datei angeben. Die Prozeduren, die den Formattyp datapump unterstützen, ermitteln die Chunks und laden Sie sie automatisch herunter.

    Wenn Sie DBMS_CLOUD.DELETE_OBJECT verwenden, erkennt und löscht die Prozedur automatisch die Chunks, wenn die Prozedur die primäre Datei löscht.

  4. Führen Sie die erforderlichen Schritte aus, um den Oracle Data Pump-Import und die Bereinigung zu verwenden.

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

Hinweis

Hinweis: Um einen vollständigen Export durchzuführen oder Objekte zu exportieren, deren Eigentümer andere Benutzer sind, benötigen Sie die Rolle DATAPUMP_CLOUD_EXP.

Ausführliche Informationen zu Oracle Data Pump-Exportparametern finden Sie in Oracle AI Database-Utilitys.