DBMS_CLOUD-Package - Formatoptionen für EXPORT_DATA

Beschreibt die gültigen Formatparameteroptionen für DBMS_CLOUD.EXPORT_DATA mit Textdateiformaten, CSV, JSON, Parquet oder XML und für Oracle Data Pump.

Dies sind die gültigen format-Parameter zur Verwendung mit DBMS_CLOUD.EXPORT_DATA. Sie geben die Textdateiausgabe an, wenn Sie die Option format type verwenden. Der Wert lautet: csv, json, parquet oder xml. Außerdem werden die Optionen format angezeigt, wenn format type datapump ist.

Es gibt zwei Möglichkeiten, das Formatargument anzugeben:

format => '{"format_option" : “format_value” }'  

Und:

format => json_object('format_option' value 'format_value'))

Beispiele:

format => json_object('type' VALUE 'json')

Um mehrere Formatoptionen anzugeben, trennen Sie die Werte durch ",".

Beispiel:

format => json_object('compression' value 'gzip', 'type' value 'json')

Diese Tabelle enthält die Formatoptionen für DBMS_CLOUD.EXPORT_DATA, wenn die Option für den format-Parameter type eine der folgenden Optionen ist: CSV, JSON, Parquet oder XML. Weitere Verfahren und andere Ausgabetypen finden Sie unter DBMS_CLOUD Package Format Options.

Formatoption Beschreibung Syntax

compression

Gibt den Komprimierungstyp der Quelldatei an.

Hinweis: Das ZIP-Archivierungsformat wird nicht unterstützt.

Wenn format type csv, json oder xml ist, ist die Standardkomprimierung Null, d.h. keine Komprimierung.

Wenn format type parquet ist, lautet die Standardkomprimierung snappy.

Wenn format type datapump ist, können Sie unterstützte Oracle Data Pump-Zugriffsparameter angeben:

  • compression: Gültige Werte: BASIC, LOW, MEDIUM und HIGH.

  • version: Die gültigen Werte sind: COMPATIBLE, LATEST und eine angegebene version_number.

Wenn type:csv | json | xml ist

compression:gzip | zlib | zstd | bzip2

Standardwert: Nullwert bedeutet keine Komprimierung.

Wenn type parquet ist

compression: gzip | snappy

Standardwert: snappy

Wenn der Typ datapump ist

compression: BASIC|LOW|MEDIUM|HIGH

delimiter

Gibt ein Trennzeichen für benutzerdefinierte Felder an.

format => json_object('delimiter' value '|')

Der Trennzeichenwert darf kein ASCII-Code oder Escape-Zeichen sein.

Hinweis

Diese Option gilt nur für csv type.

delimiter: Zeichen

Standardwert , (Komma)

endquote

Gibt an, dass Felder zwischen zwei Begrenzungszeichen (quote und endquote) eingeschlossen werden können. Wenn endquote nicht angegeben wird, wird das Zeichen quote standardmäßig als endquote-Zeichen verwendet.

Beispiel:

format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’)
Hinweis

Diese Option gilt nur für csv type.

endquote:Zeichen

Standardwert: Null, d.h. keine endquote.

escape

Gibt das Vorkommen von Anführungszeichen im Feldwert mit dem Zeichen "\" an.

Hinweis

Diese Option gilt nur für csv type.

escape : true

Standardwert: false

encryption

Die Formatoption encryption gibt die Verschlüsselungs- und Entschlüsselungsoptionen an, um Daten in und aus dem Objektspeicher zu exportieren und zu importieren.

Verwenden Sie encryption, um die folgenden Parameter zum Verschlüsseln und Entschlüsseln anzugeben:

  • user_defined_function: Gibt eine vollqualifizierte benutzerdefinierte Funktion an, mit der das angegebene BLOB (Binary Large Object) entschlüsselt oder verschlüsselt werden kann. Es gibt einen entschlüsselten oder verschlüsselten BLOB zurück. Dieser Parameter schließt sich mit anderen Parametern für encryption gegenseitig aus.

    Beispiel: ADMIN.DECRYPTION_CALLBACK.

  • type: Gibt den integrierten Verschlüsselungsalgorithmus an, der entschlüsselt oder verschlüsselt werden soll. user_defined_function und type schließen sich gegenseitig aus.

    type akzeptiert Werte im Format Block-Cipher-Algorithmen + Block-Cipher-Chaining-Modifikatoren + Block-Cipher-Padding-Modifikatoren.

    Folgende Block-Cipher-Algorithmen werden unterstützt:

    • DBMS_CRYPTO.ENCRYPT_AES256

    Folgende Block Cipher Chaining-Modifikatoren werden unterstützt:

    • DBMS_CRYPTO.CHAIN_CBC

    • DBMS_CRYPTO.CHAIN_CFB

    • DBMS_CRYPTO.CHAIN_ECB

    • DBMS_CRYPTO.CHAIN_OFB

    Unterstützte Block Cipher Padding Modifikatoren sind:

    • DBMS_CRYPTO.PAD_PKCS5

    • DBMS_CRYPTO.PAD_NONE

    • DBMS_CRYPTO.PAD_ZERO

    • DBMS_CRYPTO.PAD_ORCL

  • credential_name: Gibt die Zugangsdaten an, mit denen der Verschlüsselungsschlüssel gespeichert wird.

Die Werte für Block Cipher Chaining Modifiers und Block Cipher Padding Modifiers lauten standardmäßig DBMS_CRYPTO.CHAIN_CBC und DBMS_CRYPTO.PAD_PKCS5, wenn Sie keine Werte für diese Parameter angeben.

Die Formatoption encryption wird mit den folgenden DBMS_CLOUD-Prozeduren verwendet:
  • Wird verwendet, um Parameter zur Entschlüsselung für die folgenden Prozeduren zu übergeben:

    • DBMS_CLOUD.COPY_DATA

    • DBMS_CLOUD.CREATE_EXTERNAL_TABLE

    • DBMS_CLOUD.CREATE_HYBRID_TABLE

    • DBMS_CLOUD.COPY_COLLECTION

  • Wird verwendet, um Parameter für die Verschlüsselung für diese Prozedur zu übergeben:

    • DBMS_CLOUD.EXPORT_DATA

Beispiel:

format => JSON_OBJECT('encryption' value json_object ('type' value DBMS_CRYPTO.ENCRYPT_AES256 + DBMS_CRYPTO.CHAIN_CBC + DBMS_CRYPTO.PAD_PKCS5, 'credential_name' value 'ENCRYPTION_CRED'))
encryption:value

Dabei ist Wert eine JSON-Zeichenfolge, die zusätzliche Parameter für die Verschlüsselung bereitstellt:

type: Wert

Gibt den Verschlüsselungstyp an.

credential_name: value

Gibt die Zugangsdaten an, die zum Speichern des Verschlüsselungsschlüssels verwendet werden.

user_defined_function: value

Gibt eine vollqualifizierte benutzerdefinierte Funktion zum Entschlüsseln oder Verschlüsseln des angegebenen BLOB (Binary Large Object) an.

header

Schreibt Spaltennamen als erste Zeile in Ausgabedateien vom Typ csv.

Die Option header kann einen boolean- oder string-Wert akzeptieren.

Die gültigen Werte sind:
  • false: Überspringt die Headerzeile.

  • true: Schließt die Headerzeile ein. Die Spaltennamen basieren auf der SELECT-Anweisung im Parameter query. Sie müssen Spaltenaliasnamen in der SELECT-Anweisung angeben, wenn Sie virtuelle Spalten oder Ausdrücke verwenden.

  • String to define custom header names: Damit können Sie Headerzeilen mit benutzerdefinierten Namen definieren. Die Anzahl der Spalten und Begrenzungszeichen im Zeichenfolgenwert muss mit der Anzahl der Spalten und Begrenzungszeichen in der SELECT-Anweisung übereinstimmen. Das Standardtrennzeichen ist Komma (,).

Beispiel:

format => JSON_OBJECT('type' value 'csv', 'delimiter' value '|', 'compression' value 'gzip', 'header' value true)
Hinweis

Diese Option gilt nur für csv type.

header: true| false| String to define custom header names

Standardwert: false

fileextension

Benutzerdefinierte Dateierweiterung zum Überschreiben der Standardauswahl für den Formattyp. Dies gilt für Textformate mit DBMS_CLOUD.EXPORT_DATA: CSV, JSON, Parquet oder XML.

Wenn die angegebene Zeichenfolge nicht mit einem Punkt (Punkt) beginnt, wird automatisch ein Punkt vor der Dateierweiterung im endgültigen Dateinamen eingefügt.

Wenn keine Dateierweiterung gewünscht wird, verwenden Sie den Wert: fileextension ='none'

Gültige Werte: Jede Dateierweiterung.

Standardwert: Hängt von der Option format type ab:
  • CSV-Format: .csv
  • JSON-Format: .json
  • PARQUET-Format: .parquet
  • XML-Format: .xml

maxfilesize

Anzahl in Byte für maximale Größe der generierten Ausgabe.

Dies gilt für textbasierte Formate zum Exportieren von Daten mit DBMS_CLOUD.EXPORT_DATA, wenn die Option format type auf csv, json oder xml gesetzt ist.

Hinweis: Diese Option ist nicht gültig, wenn die Option format type parquet ist.

Mindestwert: 10485760 (10 MB)

Höchstwert: 1 GB

Standardwert: 10485760 (10 MB)

quote

Im CSV-Format können Felder zwischen zwei Begrenzungszeichen eingeschlossen werden. Geben Sie die Begrenzungszeichen mit quote und endquote an. Wenn endquote nicht angegeben wird, wird das Zeichen quote standardmäßig als endquote-Zeichen verwendet.

Hinweis

Diese Option gilt nur für csv type.

quote: Zeichen

Standardwert: Nullbedeutung schließt Felder nicht mit Anführungszeichen ein.

trimspaces

Gibt an, wie die vor- und nachgestellten Leerzeichen in den Feldern abgeschnitten werden, um das CSV-Format zu erhalten. Trim Leerzeichen werden vor dem Angeben des Feldes angewendet, wenn der Parameter quote angegeben wird.

Siehe die Beschreibung von trim_spec.

Hinweis

Diese Option gilt nur für csv type.

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

Standardwert: notrim

type

Gibt den Ausgabedateityp an.

csv: Gibt das CSV-Format (Character Separated Values) an, mit dem Sie Abfrageergebnisse als eine Gruppe von Spaltenwerten exportieren können, die durch ein beliebiges benutzerdefiniertes Zeichen getrennt sind.

json: Gibt an, dass die Abfrageergebnisse als JSON-Dateien exportiert werden sollen.

parquet: Gibt an, dass die Abfrageergebnisse als Parquet-Dateien exportiert werden sollen.

xml: Gibt an, dass Abfrageergebnisse als Zeilen gültiger XML-Dokumente exportiert werden sollen. Jede Zeile wird in einem Root-XML-Tag von <RECORD> </RECORD> gekapselt.

Das Abfrageergebnis wird mit der SQL-Funktion XMLFOREST automatisch in das XML-Format transformiert. Mit Spaltenaliasnamen können Sie die XML-Tagnamen für Spalten anpassen.

Wenn format type datapump ist, können Sie unterstützte Oracle Data Pump-Zugriffsparameter angeben:

  • compression: Gültige Werte: BASIC, LOW, MEDIUM und HIGH.

  • version: Die gültigen Werte sind: COMPATIBLE, LATEST und eine angegebene version_number.

Weitere Informationen finden Sie unter access_parameters-Klausel.

type: csv|datapump|json|parquet|xml