Oracle Cloud Infrastructure-Dokumentation

DBMS_CLOUD-Package - Formatoptionen für EXPORT_DATA

Beschreibung der gültigen Formatparameteroptionen für DBMS_CLOUD.EXPORT_DATA mit Textdateien, 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, und der Wert lautet: csv, json, parquet oder xml. Außerdem werden die format-Optionen angezeigt, wenn format type datapump lautet.

Es gibt zwei Möglichkeiten, das Argument format 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 ",".

Beispiele:

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

Diese Tabelle deckt die Formatoptionen für DBMS_CLOUD.EXPORT_DATA ab, wenn die Option type des format-Parameters eine der folgenden Optionen ist: CSV, JSON, Parquet oder XML. Weitere Verfahren und andere Ausgabetypen finden Sie unter DBMS_CLOUD Paketformatoptionen. Dort finden Sie eine Liste der Formatoptionen.

Formatoption Beschreibung Syntax

compression

Gibt den Komprimierungstyp der Quelldatei an.

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

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

Wenn format type parquet ist, lautet die Standardkomprimierung snappy.

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

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

  • version: Gültige Werte sind COMPATIBLE, LATEST und eine angegebene version_number.

Wenn die type lautet:csv | json | xml

compression:gzip | zlib | zstd | bzip2

Standardwert: Nullwert bedeutet keine Kompression.

Wenn die type parquet lautet

compression: gzip | snappy

Standardwert: snappy

Wenn der Typ datapump ist

compression: BASIC|LOW|MEDIUM|HIGH

delimiter

Gibt ein benutzerdefiniertes Feldtrennzeichen an.

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

Der Wert des Bezeichners darf kein ASCII-Code oder Escape-Zeichen sein.

Hinweis

Diese Option gilt nur für type csv.

delimiter: Zeichen

Standardwert ist , (Befehl)

endquote

Gibt mit quote und endquote an, dass Felder von Begrenzern umschlossen sein können. Wenn endquote nicht angegeben ist, wird das quote-Zeichen standardmäßig als endquote-Zeichen verwendet.

Beispiele:

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

Diese Option gilt nur für type csv.

endquote:Zeichen

Standardwert: Null, d.h. kein endquote.

escape

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

Hinweis

Diese Option gilt nur für type csv.

escape : true

Standardwert: false

encryption

Die Formatoption encryption gibt die Verschlüsselungs- und Entschlüsselungsoptionen für den Export und Import von Daten in und aus dem Objektspeicher an.

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 (binäres Large Object) entschlüsselt oder verschlüsselt wird. Es gibt ein entschlüsseltes oder verschlüsseltes BLOB zurück. Dieser Parameter schließt sich gegenseitig mit anderen Parametern für encryption aus.

    Beispiel: ADMIN.DECRYPTION_CALLBACK.

  • type: Gibt den integrierten Verschlüsselungsalgorithmus zum Entschlüsseln oder Verschlüsseln an. user_defined_function und type schließen sich gegenseitig aus.

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

    Unterstützte Block-Cipher-Algorithmen:

    • DBMS_CRYPTO.ENCRYPT_AES256

    Unterstützte Block Cipher Chaining Modifikatoren sind:

    • DBMS_CRYPTO.CHAIN_CBC

    • DBMS_CRYPTO.CHAIN_CFB

    • DBMS_CRYPTO.CHAIN_ECB

    • DBMS_CRYPTO.CHAIN_OFB

    Folgende Block-Cipher-Padding-Modifikatoren werden unterstützt:

    • 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-Verkettungsmodifikatoren und Block-Cipher-Padding-Modifikatoren 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 zur Verschlüsselung für diese Prozedur zu übergeben:

    • DBMS_CLOUD.EXPORT_DATA

Beispiele:

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 an, mit der das angegebene BLOB (binäres Large Object) entschlüsselt oder verschlüsselt wird.

header

Schreibt Spaltennamen als erste Zeile in Ausgabedateien des Typs csv.

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

Die gültigen Werte sind:

  • false: Die Headerzeile wird übersprungen.

  • true: Mit Headerzeile. Die Spaltennamen basieren auf der SELECT-Anweisung im Parameter query. Sie müssen Spaltenaliase in der SELECT-Anweisung angeben, wenn Sie virtuelle Spalten oder Ausdrücke verwenden.

  • String to define custom header names: Ermöglicht die Definition von Headerzeilen mit benutzerdefinierten Namen. Die Anzahl der Spalten und Trennzeichen im Zeichenfolgenwert muss mit der Anzahl der Spalten und Trennzeichen in der SELECT-Anweisung übereinstimmen. Das Standardtrennzeichen ist das Komma (,).

Beispiele:

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

Diese Option gilt nur für type csv.

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

Standardwert: false

fileextension

Benutzerdefinierte Dateiendung 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 beginnt, wird automatisch ein Punkt vor der Dateiendung im letzten Dateinamen eingefügt.

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

Gültige Werte: Jede Dateiendung.

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

maxfilesize

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

Dies gilt für textbasierte Formate für den Export 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 lautet.

Mindestwert: 10485760 (10 MB )

Höchstwert: 1 GB

Standardwert: 10485760 (10 MB)

quote

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

Hinweis

Diese Option gilt nur für type csv.

quote: Zeichen

Standardwert: Null. Felder werden nicht von Angeboten umschlossen.

trimspaces

Gibt an, wie die vor- und nachgestellten Leerzeichen der Felder für das CSV-Format abgeschnitten werden. Leerzeichen werden vor den Anführungszeichen für das Feld abgeschnitten, wenn der Parameter quote angegeben wird.

Weitere Informationen finden Sie in der Beschreibung von trim_spec.

Hinweis

Diese Option gilt nur für type csv.

trimspaces: rtrim| ltrim| notrim| lrtrim| ldrtrim

Standardwert: notrim

type

Gibt den Typ der Ausgabedatei 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 ist in einem Root-XML-Tag <RECORD> </RECORD> umkapselt.

Das Abfrageergebnis wird mit der SQL-Funktion XMLFOREST automatisch in das XML-Format transformiert. Verwenden Sie Spaltenaliasnamen, um die XML-Tagnamen für Spalten anzupassen.

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

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

  • version: Gültige Werte sind COMPATIBLE, LATEST und eine angegebene version_number.

Weitere Informationen finden Sie unter access_parameters-Klausel.

type: csv|datapump|json|parquet|xml

Übergeordnetes Thema: DBMS_CLOUD Package