JSON-Daten in Cloud-Objektspeicher exportieren

Zeigt die Schritte zum Exportieren von Tabellendaten aus Autonomous Database in Cloud-Objektspeicher als JSON-Daten an, indem eine Abfrage angegeben wird.

Diese Exportmethode unterstützt alle von Autonomous Database unterstützten Cloud-Objektspeicher. Sie können mit einem Oracle Cloud Infrastructure-Resource Principal auf Ihren Oracle Cloud Infrastructure-Objektspeicher, mit Amazon-Ressourcennamen (ARNs) auf AWS Simple Storage Service (S3), mit einem Azure-Service-Principal für den Zugriff auf Azure-BLOB-Speicher oder mit Azure-Data Lake-Speicher oder mit einem Google-Serviceaccount für den Zugriff auf Google Cloud Platform-(GCP-)Ressourcen zugreifen.

  1. Melden Sie sich bei Ihrer Autonomous Database-Instanz an.

    Weitere Informationen finden Sie unter Verbindung zu Autonomous Database herstellen.

  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.

    Das Erstellen von Zugangsdaten für den Zugriff auf Oracle Cloud Infrastructure Object Storage ist nicht erforderlich, wenn Sie Ressourcen-Principal-Zugangsdaten aktivieren. Weitere Informationen finden Sie unter Resource Principal für den Zugriff auf Oracle Cloud Infrastructure-Ressourcen verwenden.

  3. Führen Sie DBMS_CLOUD.EXPORT_DATA aus, und geben Sie den Parameter format type mit dem Wert json an, um die Ergebnisse als JSON-Dateien in Cloud Object Storage zu exportieren.
    Zum Generieren der JSON-Ausgabedateien gibt es zwei Optionen für den Parameter file_uri_list:
    • Setzen Sie den Wert file_uri_list auf die URL für einen vorhandenen Bucket in Ihrem Cloud-Objektspeicher.

    • Setzen Sie den Wert file_uri_list auf die URL für einen vorhandenen Bucket in Ihrem Cloud Object Storage, und fügen Sie ein Dateinamenpräfix hinzu, das beim Generieren der Dateinamen für die exportierte JSON verwendet werden soll.

    Wenn Sie das Dateinamenspräfix nicht in die file_uri_list aufnehmen, stellt DBMS_CLOUD.EXPORT_DATA ein Dateinamenpräfix bereit. Weitere Informationen finden Sie unter Dateibenennung für Textausgabe (CSV, JSON, Parquet oder XML).

    Beispiel: Im Folgenden wird DBMS_CLOUD.EXPORT_DATA mit einem Dateinamenpräfix gezeigt, das in file_uri_list angegeben wird:

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        credential_name => 'DEF_CRED_NAME',
        file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
        query           => 'SELECT * FROM DEPT',
        format          => JSON_OBJECT('type' value 'json'));
    END;
    /

    In diesem Beispiel ist namespace-string der Oracle Cloud Infrastructure-Objektspeicher-Namespace und bucketname der Bucket-Name. Weitere Informationen finden Sie unter Object Storage-Namespaces.

    Wenn Datensatzbegrenzungszeichen Escape-Zeichen enthalten, wie \r\n oder \t, setzen Sie die Datensatzbegrenzungszeichen in doppelte Anführungszeichen. Beispiel: Um das Datensatztrennzeichen \r\n zu verwenden, setzen Sie den Wert in doppelte Anführungszeichen:"\r\n".

    BEGIN
      DBMS_CLOUD.EXPORT_DATA(
        credential_name => 'DEF_CRED_NAME',
        file_uri_list   => 'https://objectstorage.us-phoenix-1.oraclecloud.com/n/namespace-string/b/bucketname/o/dept_export',
        query => 'SELECT * FROM DEPT',
        format => JSON_OBJECT('type' value 'json', 'recorddelimiter' value '"\r\n"' format json));
    END;
    /

    In diesem Beispiel ist namespace-string der Oracle Cloud Infrastructure-Objektspeicher-Namespace und bucketname der Bucket-Name. Weitere Informationen finden Sie unter Object Storage-Namespaces.

    Ausführliche Informationen zu den Parametern finden Sie unter Prozedur EXPORT_DATA.

    Ausführliche Informationen zu den verfügbaren format-Parametern, die Sie mit DBMS_CLOUD.EXPORT_DATA verwenden können, finden Sie unter DBMS_CLOUD-Paketformatoptionen für EXPORT_DATA.

Hinweise zum Export mit DBMS_CLOUD.EXPORT_DATA:

  • Bei dem von Ihnen angegebenen query-Parameter kann es sich bei Bedarf um eine erweiterte Abfrage handeln, z.B. eine Abfrage, die Joins oder Unterabfragen enthält.

  • Geben Sie den Parameter format mit der Option compression an, um die Ausgabedateien zu komprimieren.

  • Geben Sie den Parameter format mit der Option encryption an, um Daten beim Export zu verschlüsseln. Weitere Informationen finden Sie unter Daten beim Export in Object Storage verschlüsseln.

  • Wenn Sie die exportierten Dateien nicht mehr benötigen, verwenden Sie die Prozedur DBMS_CLOUD.DELETE_OBJECT, oder löschen Sie die Dateien mit nativen Cloud-Objektspeicherbefehlen.