DBMS_CLOUD-Package - Formatoptionen
Das Formatargument in DBMS_CLOUD
gibt das Format der Quelldateien an.
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 'CSV')
Um mehrere Formatoptionen anzugeben, trennen Sie die Werte durch ",
".
Beispiel:
format => json_object('ignoremissingcolumns' value 'true', 'removequotes' value 'true', 'dateformat' value 'YYYY-MM-DD-HH24-MI-SS', 'blankasnull' value 'true', 'logretention' value 7)
Hinweis:
Informationen zu den Formatoptionen Avro, ORC oder Parquet finden Sie unter DBMS_CLOUD-Paketformatoptionen für Avro, ORC oder Parquet.Wie in der Spalte Formatoption angegeben, ist eine begrenzte Gruppe von Formatoptionen mit DBMS_CLOUD.COPY_COLLECTION
oder mit DBMS_CLOUD.COPY_DATA
gültig, wenn format
type
JSON lautet.
Formatoption | Beschreibung | Syntax |
---|---|---|
|
Wenn diese Option auf |
Standardwert: |
Gültig mit |
Gibt den Zeichensatz der Quelldateien an. |
Standardwert: Datenbankzeichensatz |
Nur mit |
Array von JSON-Pfadausdrücken, die den Feldern entsprechen, die aus den JSON-Datensätzen extrahiert werden müssen. Jeder der JSON-Pfadausdrücke im Array muss den Regeln entsprechen, die unter SQL/JSON-Pfadausdrücke im Oracle Database 19c JSON Developer's Guide oder im Oracle Database 23ai JSON Developer's Guide beschrieben sind. Nur mit den Formaten JSON und |
JSON-Array von JSON-Pfadausdrücken im Zeichenfolgenformat. Beispiel: "columnpath"-Wert |
Option gültig mit JSON-Daten |
Gibt den Komprimierungstyp der Quelldatei an. Das ZIP-Archivierungsformat wird nicht unterstützt. Wenn Sie den Wert |
Standardwert: Nullwert bedeutet keine Komprimierung. |
|
Wenn eine Zeile wegen Datentyp-Konvertierungsfehlern abgelehnt wird, werden die zugehörigen Spalten als Null gespeichert, oder die Zeile wird abgelehnt. |
Standardwert: |
|
Gibt das Datumsformat in der Quelldatei an. Die Formatoption J MM-DD-YYYYBC MM-DD-YYYY YYYYMMDD HHMISS YYMMDD HHMISS YYYY.DDD YYYY-MM-DD |
Standardwert: Datenbankdatumsformat |
|
Gibt das Feldbegrenzungszeichen an. Um ein Sonderzeichen als Begrenzungszeichen zu verwenden, geben Sie den HEX-Wert des ASCII-Codes des Zeichens an. Beispiel: Im Folgenden wird das TAB-Zeichen als Begrenzungszeichen angegeben:
|
Standardwert |
|
Gibt an, dass sich die Felder in den externen Datendateien in einer anderen Reihenfolge befinden als die Spalten in der Tabelle. Ermitteln Sie die Reihenfolge der Felder mit der ersten Zeile jeder externen Datendatei, und ordnen Sie sie den Spalten der Tabelle zu. Die Feldnamen in externen Datendateien werden ohne Berücksichtigung der Groß-/Kleinschreibung mit den Namen der Tabellenspalten verglichen. Diese Formatoption gilt für die folgenden Verfahren:
Einschränkungen für
Weitere Informationen finden Sie unter FIELD NAMES in Oracle Database 19c Utilities oder Oracle Database 23ai Utilities sowie in der Beschreibung für |
Standardwert: |
|
Die Formatoption
Beispiel: format => JSON_OBJECT('enablelogs' value FALSE) |
Standardwert: |
|
Die Formatoption Verwenden Sie
Die Werte für Block-Cipher-Verkettungsmodifizierer und Block-Cipher-Auffüllungsmodifizierer werden standardmäßig auf Die Formatoption
encryption wird mit den folgenden DBMS_CLOUD -Prozeduren verwendet:
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 value eine JSON-Zeichenfolge, die zusätzliche Parameter für die Verschlüsselung bereitstellt:
Gibt den Verschlüsselungstyp an.
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. |
|
Daten können von Begrenzungszeichen umschlossen werden, die mit Beispiel: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
Standardwert: Null, d.h. kein |
|
Das Zeichen "\" wird als Escapezeichen verwendet, sofern angegeben. |
Standardwert: |
Option gültig mit JSON-Daten |
Leere Zeilen werden ignoriert, wenn diese Option auf "true" gesetzt ist. |
Standardwert: |
|
Wenn die |
Standardwert |
Nur mit |
JSON-Pfad zum Identifizieren des zu ladenden Dokuments. Diese Option ist nur für JSON-Collection-Daten mit |
Standardwert: Null |
keyassignment Nur mit |
Gibt an, ob eine neue Sammlung als mongokompatible Sammlung oder als SODA-Collection erstellt wird. Wenn der Wert auf Dieser Parameter ist standardmäßig nicht festgelegt, d.h. eine neue Collection wird als SODA-Collection erstellt. |
Standard: |
Nur mit |
Gibt ein Attribut in den Daten an, das als Wenn Setzen Sie den Wert auf einen Pfad, z.B. Dieser Parameter ist optional und nur für das Laden in mongokompatible Collections gültig. Wenn keine Angabe gemacht wird, generiert Oracle eine eindeutige 12-Byte-System-ID und füllt diese als Attribut |
Standard: Wenn |
|
Gibt einen Sprachennamen an (z.B. FRENCH), von dem gebietsschemaabhängige Informationen abgeleitet werden können. |
Standardwert: Null Eine Liste der von Oracle unterstützten Sprachen finden Sie unter Geocale-Daten in der Dokumentation Oracle Database 19c Database Globalization Support Guide oder in der Dokumentation Oracle Database 23ai Database Globalization Support Guide. |
|
Gibt einen Zeichenfolgenwert an, der den Verzeichnisobjektnamen bestimmt, in dem die Standardmäßig wird bei Beispiel:
Die im obigen Beispiel angegebene Formatoption
Die im obigen Beispiel angegebene Formatoption |
Standardwert: |
|
Gibt einen Zeichenfolgenwert an, der das Präfix für die Dateien Das Format des Logtabellennamens lautet: logprefix Standardmäßig ist das logprefix in Großbuchstaben angegeben, aber der Fall ist reserviert, wenn der angegebene Wert in doppelte Anführungszeichen gesetzt ist. Beispiel: format => JSON_OBJECT ('logprefix' value 'TEST') Logdateien verwenden dann das Präfix |
Standardwert: |
|
Gibt eine positive Ganzzahldauer in Tagen an, für die die Dateien Gültige Werte: Beispiel: format => JSON_OBJECT ('logretention' value 7) |
Standardwert: |
Diese Option ist nur mit JSON-Daten gültig |
Maximale Größe von JSON-Dokumenten. |
Standardwert: 1 Megabyte Maximal zulässiger Wert: 2 Gigabyte |
|
Gibt die Zeichen an, die als Gruppentrennzeichen und Dezimalzeichen verwendet werden sollen. decimal_character: Mit dem Dezimalzeichen wird der ganzzahlige Teil einer Zahl vom Dezimalteil getrennt. group_separator: Das Gruppentrennzeichen trennt Ganzzahlgruppen (d.h. Tausende, Millionen, Milliarden usw.). |
Standardwert: Weitere Informationen finden Sie im NLS_NUMERIC_CHARACTERS Oracle Database 19c Database Globalization Support Guide Oracle Database 23ai Database Globalization Support Guide. |
|
Gibt das Modell für das Zahlenformat an. Mit Zahlenformatmodellen wird die Zahl auf die angegebene Anzahl signifikanter Ziffern gerundet. Ein Zahlenformatmodell besteht aus mindestens einem Zahlenformatelement. Wird in Kombination mit |
Standardwert: wird von der Einstellung des Parameters Weitere Informationen finden Sie unter Zahlenformatmodelle in der SQL-Sprachreferenz für Oracle Database 19c oder in der SQL-Sprachreferenz für Oracle Database 23ai. |
|
Die Formatoption
Wenn die Datendateien unstrukturiert sind und die Unterklausel Bei Objektnamen, die nicht auf dem Hive-Format basieren, muss die Reihenfolge der von |
|
|
Gibt das Anführungszeichen für die Felder an. Die |
Standardwert: Null - keine Anführungszeichen |
Option gültig mit JSON-Daten |
Gibt das Datensatz-Begrenzungszeichen an. Standardmäßig versucht Geben Sie dieses Argument explizit an, wenn Sie das Standardverhalten außer Kraft setzen möchten. Beispiel:
Um anzugeben, dass kein Datensatzbegrenzungszeichen vorhanden ist, können Sie einen
|
Standardwert: Zeilenvorschubzeichen erkannt |
|
Die Formatoption
Wenn der Wert von Die Zeichen "*" und "?" werden als Platzhalterzeichen betrachtet, wenn der Parameter Normale Ausdrucksmuster werden nur für den Dateinamen oder Unterordnerpfad in Ihren URIs unterstützt, und der Musterabgleich ist mit dem der Funktion Bei externen Tabellen wird diese Option nur mit den Tabellen unterstützt, die in einer Datei im Object Storage erstellt werden. Beispiel:
Weitere Informationen zur Bedingung |
Standardwert: |
|
Der Vorgang wird mit einem Fehler beendet, nachdem die angegebene Anzahl an Zeilen abgelehnt wurde. |
Standardwert: |
|
Entfernt alle Anführungszeichen um Felder in der Quelldatei. |
Standardwert: |
|
Gibt an, wie viele Zeilen ab dem Anfang der Datei übersprungen werden sollen. |
Standardwert: 0, wenn nicht angegeben. 1, wenn ohne Wert angegeben. |
|
Gibt einen Gebietsnamen an, um die Eigenschaften der Eingabedaten weiter zu bestimmen. |
Standardwert: Null Eine Liste der von Oracle unterstützten Sprachen finden Sie unter Geocale-Daten in der Dokumentation Oracle Database 19c Database Globalization Support Guide oder in der Dokumentation Oracle Database 23ai Database Globalization Support Guide. |
|
Gibt das Zeitstempelformat in der Quelldatei an. Die Formatoption YYYY-MM-DD HH:MI:SS.FF YYYY-MM-DD HH:MI:SS.FF3 YYYY-MM-DD HH24:MI:SS.FF3 MM/DD/YYYY HH:MI:SS.FF3 |
Standardwert: Datenbank-Zeitstempelformat Die Zeichenfolge kann Platzhalterzeichen wie "$" enthalten. |
|
Gibt das Zeitstempelformat mit lokaler Zeitzone in der Quelldatei an. Die Formatoption DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR |
Standardwert: Datenbank-Zeitstempelformat mit lokaler Zeitzone |
|
Gibt das Zeitstempelformat mit Zeitzone in der Quelldatei an. Die Formatoption DD Mon YYYY HH:MI:SS.FF TZR MM/DD/YYYY HH:MI:SS.FF TZR YYYY-MM-DD HH:MI:SS+/-TZR YYYY-MM-DD HH:MI:SS.FF3 DD.MM.YYYY HH:MI:SS TZR |
Standardwert: Datenbank-Zeitstempelformat mit Zeitzone |
|
Gibt an, wie die vor- und nachgestellten Leerzeichen der Felder abgeschnitten werden. Siehe die Beschreibung von trim_spec unter Oracle Database-19c-Utilitys oder Oracle Database 23ai-Utilitys. |
Standardwert: |
|
Wenn die Daten in der Datei zu lang für ein Feld sind, wird der Wert des Feldes mit dieser Option abgeschnitten, anstatt dass die Zeile abgelehnt wird. |
Standardwert: |
|
Gibt den Typ der Quelldatei an. Siehe die Beschreibung von CSV unter Oracle Database-19c-Utilitys oder Oracle Database 23ai-Utilitys. Wenn Wenn Die Bei JSON-Daten mit Bei JSON-Daten mit
|
Hinweis: Nicht alleDBMS_CLOUD -Prozeduren unterstützen alle diese Typen.
Standardwert: Null Für JSON-Daten gibt es zwei gültige |
Nur mit |
Wenn der Wert auf Wenn dieser Wert auf Diese Option ist nur für JSON-Collection-Daten mit |
Standardwert: |
Verwandte Themen