Daten mit DBMS_CLOUD.EXPORT_DATA als Text in Objektspeicher exportieren

Verwenden Sie DBMS_CLOUD.EXPORT_DATA, um Daten als Text aus einer autonomen KI-Datenbank in den Cloud-Objektspeicher zu exportieren. Die Exportoptionen für das Textformat sind CSV, JSON oder XML.

JSON-Daten in Cloud-Objektspeicher exportieren

Zeigt die Schritte zum Exportieren von Tabellendaten aus Ihrer autonomen KI-Datenbank in Cloud Object Storage als JSON-Daten durch Angabe einer Abfrage an.

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

  1. Stellen Sie eine Verbindung zur autonomen KI-Datenbankinstanz her.

    Weitere Informationen finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.

  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.

  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.

    Um die JSON-Ausgabedateien zu generieren, 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-Objektspeicher, und fügen Sie ein Dateinamenpräfix hinzu, das beim Generieren der Dateinamen für das exportierte JSON verwendet werden soll.

    Wenn Sie das Dateinamenprä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 dargestellt, das in file_uri_list angegeben ist:

     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 wie \r\n oder \t enthalten, 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 Package Format Options for EXPORT_DATA.

Hinweise zum Exportieren mit DBMS_CLOUD.EXPORT_DATA:

Daten als CSV in Cloud-Objektspeicher exportieren

Zeigt die Schritte zum Exportieren von Tabellendaten aus Ihrer autonomen KI-Datenbank in Cloud Object Storage als CSV-Daten durch Angabe einer Abfrage an.

Diese Exportmethode unterstützt alle Cloud-Objektspeicher, die von der autonomen KI-Datenbank unterstützt werden. Sie können auch Amazon Resource Names (ARNs) verwenden, um auf AWS Simple Storage Service (S3) zuzugreifen, einen Azure-Service-Principal für den Zugriff auf Azure BLOB-Speicher oder einen Google-Serviceaccount für den Zugriff auf Google Cloud Platform (GCP)-Ressourcen.

  1. Stellen Sie eine Verbindung zur autonomen KI-Datenbankinstanz her.

    Weitere Informationen finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.

  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.

  3. Führen Sie DBMS_CLOUD.EXPORT_DATA aus, und geben Sie den Parameter format type mit dem Wert csv an, um die Ergebnisse als CSV-Dateien in Cloud Object Storage zu exportieren.

    Um die CSV-Ausgabedateien zu generieren, 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 exportierten CSV-Dateien verwendet werden soll.

    Wenn Sie das Dateinamenprä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 dargestellt, das in file_uri_list angegeben ist:

     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 'csv', 'delimiter' value '|', 'compression' value 'gzip'));
 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 Package Format Options for EXPORT_DATA.

Hinweise zum Exportieren mit DBMS_CLOUD.EXPORT_DATA:

Daten als Parquet in Cloud-Objektspeicher exportieren

Zeigt die Schritte zum Exportieren von Tabellendaten aus Ihrer autonomen KI-Datenbank in Cloud Object Storage als Parquet-Daten durch Angabe einer Abfrage an.

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

  1. Stellen Sie eine Verbindung zur autonomen KI-Datenbankinstanz her.

    Weitere Informationen finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.

  2. Speichern Sie Ihre Zugangsdaten für die 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.

  3. Führen Sie DBMS_CLOUD.EXPORT_DATA aus, und geben Sie den Parameter format type mit dem Wert parquet an, um die Ergebnisse als Parkettdateien in Cloud Object Storage zu exportieren.

    Um die Parkettausgabedateien zu generieren, 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-Objektspeicher, und fügen Sie ein Dateinamenpräfix hinzu, das beim Generieren der Dateinamen für die exportierten Parkettdateien verwendet werden soll.

    Wenn Sie das Dateinamenprä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 dargestellt, das in file_uri_list angegeben ist:

     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 'parquet', 'compression' value 'snappy'));
 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 Package Format Options for EXPORT_DATA.

Hinweise zum Exportieren mit DBMS_CLOUD.EXPORT_DATA:

Daten als XML in Cloud-Objektspeicher exportieren

Zeigt die Schritte zum Exportieren von Tabellendaten aus Ihrer autonomen KI-Datenbank in Cloud Object Storage als XML-Daten durch Angabe einer Abfrage an.

Diese Exportmethode unterstützt alle Cloud-Objektspeicher, die von der autonomen KI-Datenbank unterstützt werden. Sie können auch Amazon Resource Names (ARNs) verwenden, um auf AWS Simple Storage Service (S3) zuzugreifen, einen Azure-Service-Principal für den Zugriff auf Azure BLOB-Speicher oder einen Google-Serviceaccount für den Zugriff auf Google Cloud Platform (GCP)-Ressourcen.

  1. Stellen Sie eine Verbindung zur autonomen KI-Datenbankinstanz her.

    Weitere Informationen finden Sie unter Verbindung zur autonomen KI-Datenbank herstellen.

  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.

  3. Führen Sie DBMS_CLOUD.EXPORT_DATA aus, und geben Sie den Parameter format type mit dem Wert xml an, um die Ergebnisse als XML-Dateien in Cloud Object Storage zu exportieren.

    Um die XML-Ausgabedateien zu generieren, 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-Objektspeicher, und fügen Sie ein Dateinamenpräfix hinzu, das beim Generieren der Dateinamen für das exportierte JSON verwendet werden soll.

    Wenn Sie das Dateinamenpräfix nicht in die Datei 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 dargestellt, das in file_uri_list angegeben ist:

     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 'xml', 'compression' value 'gzip'));
 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 Package Format Options for EXPORT_DATA.

Hinweise zum Exportieren mit DBMS_CLOUD.EXPORT_DATA:

Dateibenennung für Textausgabe (CSV, JSON, Parquet oder XML)

Beschreibt die Benennung der Ausgabedatei mit DBMS_CLOUD.EXPORT_DATA und CSV-, JSON-, Parquet- oder XML-Textdateiausgabe.

DBMS_CLOUD.EXPORT_DATA führt die mit dem Parameter query angegebene Abfrage aus und sendet die Ergebnisse entweder im Cloud-Objektspeicher-Bucket oder in ein Verzeichnis an Textdateien. Das Ausgabeformat hängt vom angegebenen format-Parameter type ab (eines von CSV, JSON, Parquet oder XML).

Um die Prozedur zu beschleunigen und die Ausgabe so schnell wie möglich zu generieren, teilt DBMS_CLOUD.EXPORT_DATA ihre Arbeit auf. Das bedeutet, dass bei der Ausführung von DBMS_CLOUD.EXPORT_DATA je nach Systemressourcen mehrere Ausgabedateien entweder im Cloud-Objektspeicher-Bucket oder im Verzeichnis erstellt werden.

Das Format für jede generierte Datei lautet:

[FileNamePrefix | client_info_module_action]_sequenceNum_timestamp.format_extension.[compression_extension]

Beispiel: Das Dateinamenpräfix in der folgenden DBMS_CLOUD.EXPORT_DATA-Prozedur wird im Parameter file_uri_list als dept_export angegeben. Im Beispiel wird die Ausgabe im angegebenen Format in den angegebenen Objektspeicher generiert.

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

Wenn Sie ein Dateinamenpräfix angeben, enthalten die generierten Ausgabedateien das Dateinamenpräfix, ähnlich dem Folgenden:

dept_export_1_20210809T173033Z.json
dept_export_2_20210809T173034Z.json
dept_export_3_20210809T173041Z.json
dept_export_4_20210809T173035Z.json

Die Anzahl der generierten Ausgabedateien hängt von der Größe der Ergebnisse, dem Datenbankservice und der Anzahl der ECPUs (OCPUs, wenn Ihre Datenbank OCPUs verwendet) in der Instanz der autonomen KI-Datenbank ab.

Im folgenden Beispiel enthält der Parameter file_uri_list kein Dateinamenpräfix, und der Parameter compression wird mit dem Wert gzip angegeben:

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/',
    query           => 'SELECT * FROM DEPT',
    format          => json_object('type' value 'json', 'compression' value 'gzip'));
END;
/

Wenn ein Dateinamenpräfix nicht im Parameter file_uri_list enthalten ist, verwendet DBMS_CLOUD.EXPORT_DATA ein Dateinamenpräfix in der Form: client_info_module_action. In diesem Beispiel enthalten die generierten Ausgabedateien das Dateinamenpräfix, das DBMS_CLOUD.EXPORT_DATA bereitstellt, und die Dateien werden mit gzip komprimiert, und die Dateierweiterung .gz wird wie folgt hinzugefügt:

Client1_Module1_Action1_1_20210809T173033Z.json.gz
Client1_Module1_Action1_2_20210809T173034Z.json.gz
Client1_Module1_Action1_3_20210809T173041Z.json.gz
Client1_Module1_Action1_4_20210809T173035Z.json.gz

Wenn die Sessioninformationen client_info_module_action beim Ausführen von DBMS_CLOUD.EXPORT_DATA nicht verfügbar sind, wird das Dateinamenpräfix auf data gesetzt. Beispiel:

data_1_20210809T173033Z.json.gz
data_2_20210809T173034Z.json.gz
data_3_20210809T173041Z.json.gz
data_4_20210809T173035Z.json.gz

Beispiel: Das Dateinamenpräfix in der folgenden DBMS_CLOUD.EXPORT_DATA-Prozedur wird im Parameter file_uri_list als dept_export angegeben. Im Beispiel wird die Ausgabe in das angegebene Verzeichnis im angegebenen Format generiert.

BEGIN
  DBMS_CLOUD.EXPORT_DATA(
    file_uri_list   => 'DATA_PUMP_DIR:sales.json',
    query           => 'SELECT * FROM SALES',
    format          => JSON_OBJECT('type' value 'json'));
END;
/

Wenn Sie ein Dateinamenpräfix angeben, enthält die generierte Ausgabedatei das Dateinamenpräfix, ähnlich dem Folgenden:

sales_1_20230705T124523275915Z.csv

Hinweise zur Dateibenennung mit DBMS_CLOUD.EXPORT_DATA:

Verwandte Inhalte