DBMS_CLOUD-Package - Formatoptionen für EXPORT_DATA

Beschreibt die gültigen Formatparameteroptionen für DBMS_CLOUD.EXPORT_DATA mit Textdateiformaten, CSV, JSON oder XML.

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.

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 Prozeduren und andere Ausgabetypen finden Sie unter Optionen für das DBMS_CLOUD-Packageformat.

Formatoption Beschreibung Syntax

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 die `type`:`csv \| json \| xml` ist `compression: gzip` Standardwert: Nullwert bedeutet keine Komprimierung. Wenn `type` `parquet` ist `compression: gzip \| snappy` Standardwert: `snappy`
`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 der 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 in Oracle Database 19c-Utilitys oder Oracle Database 26ai-Utilitys. 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 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. Weitere Informationen finden Sie unter access_parameters Clause in Oracle Database 19c Utilities oder Oracle Database 26ai Utilities.	`type`: `csv\|datapump\|json\|parquet\|xml`

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 die type:csv | json | xml ist

compression: gzip

Standardwert: Nullwert bedeutet keine Komprimierung.

Wenn type parquet ist

compression: gzip | snappy

Standardwert: snappy

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 der 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 in Oracle Database 19c-Utilitys oder Oracle Database 26ai-Utilitys.

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

Weitere Informationen finden Sie unter access_parameters Clause in Oracle Database 19c Utilities oder Oracle Database 26ai Utilities.

type: csv|datapump|json|parquet|xml

DBMS_CLOUD-Package - Formatoptionen für EXPORT_DATA

Verwandte Inhalte