DBMS_CLOUD-Package - Formatoptionen
Das Formatargument in DBMS_CLOUD
gibt das Format der Quelldateien an.
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 '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)
Informationen zu den Optionen für Avro-, ORC- oder Parquet-Format finden Sie unter DBMS_CLOUD Packageformatoptionen für Avro, ORC oder Parquet.
Wie in der Spalte Formatoption angegeben, ist ein begrenztes Set von Formatoptionen mit DBMS_CLOUD.COPY_COLLECTION
oder DBMS_CLOUD.COPY_DATA
gültig, wenn format
type
JSON ist.
Formatoption | Beschreibung | Syntax |
---|---|---|
|
Gibt den Typ der Apache Iceberg-Tabelle an, z.B. AWS oder OCI Object Storage, und welche Informationen zum Erstellen der externen Tabelle verwendet werden, z.B. Informationen aus einem Datenkatalog oder einer direkten Metadaten-URI. |
Einzelheiten zur |
|
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 JSON-Pfadausdruck im Array muss den unter SQL/JSON-Pfadausdrücke beschriebenen Regeln entsprechen. Nur mit JSON-Format und |
JSON-Array mit json-Pfadausdrücken im Zeichenfolgenformat. Beispiel: "columnpath"-Wert |
Option gültig mit JSON-Daten |
Gibt den Komprimierungstyp der Quelldatei an. 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 Trennzeichen zu verwenden, geben Sie den HEX-Wert des ASCII-Codes des Zeichens an. Beispiel: Im Folgenden wird das TAB-Zeichen als Trennzeichen angegeben:
|
Standardwert |
|
Gibt an, dass die Felder in den externen Datendateien in einer anderen Reihenfolge sind als die Spalten in der Tabelle. Erkennen 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 Beachtung 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 und 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 Chaining Modifiers und Block Cipher Padding Modifiers lauten standardmäßig 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 Wert 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 zwischen zwei Begrenzungszeichen eingeschlossen werden, die mit Beispiel: format => JSON_OBJECT(‘quote’ value ‘(’, ‘endquote’ value ‘)’) |
Standardwert: Null, d.h. keine |
|
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 |
|
Aktivieren Sie die implizite Partitionierung, und geben Sie die Namen der Partitionsspalten mit der Formatoption Implizite Partitionierung wird wie folgt aktiviert:
Eine Beschreibung und Syntax der Optionen finden Sie unter |
Standardwert: Wenn |
|
Aktivieren Sie die implizite Partitionierung, und geben Sie die Datentypen von Partitionsspalten mit der Formatoption Weitere Informationen zum Aktivieren der impliziten Partitionierung und Beispiele finden Sie unter |
Standardwert: Wenn |
Nur mit |
JSON-Pfad zur Identifizierung des zu ladenden Dokuments. Diese Option ist nur für JSON-Collection-Daten mit |
Standardwert: Null |
keyassignment Nur mit |
Gibt an, ob eine neue Collection als mongokompatible Collection oder als SODA-Collection erstellt wird. Wenn der Wert auf Standardmäßig ist dieser Parameter nicht festgelegt, d.h. eine neue Collection wird als SODA-Collection erstellt. |
Standard: |
Nur mit |
Gibt ein Attribut in den Daten an, das als Wert Wenn Setzen Sie den Wert auf einen Pfad, z.B. Dieser Parameter ist optional und nur zum Laden in mongokompatible Collections gültig. Wenn keine Angabe gemacht wird, generiert Oracle eine eindeutige 12-Byte-System-ID und füllt diese als |
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 Gebietsschemadaten im Handbuch für Oracle Database-Globalisierungsfunktionen. |
|
Gibt einen Zeichenfolgenwert an, der den Verzeichnisobjektnamen bestimmt, in dem die Dateien Standardmäßig wird bei Beispiel:
Mit der im obigen Beispiel angegebenen Formatoption
Mit der im obigen Beispiel angegebenen Formatoption |
Standardwert: |
|
Gibt einen Zeichenfolgenwert an, der das Präfix für die Dateien Das Namensformat der Logtabelle lautet: logprefix Standardmäßig ist das logprefix in Großbuchstaben angegeben. Die Groß-/Kleinschreibung wird jedoch reserviert, wenn der angegebene Wert in doppelte Anführungszeichen eingeschlossen 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 bei 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: Das Dezimalzeichen trennt den ganzzahligen Teil einer Zahl vom Dezimalteil. group_separator: Das Gruppentrennzeichen trennt Ganzzahlgruppen (d.h. Tausende, Millionen, Milliarden usw.). |
Standardwert: Weitere Informationen finden Sie unter NLS_NUMERIC_CHARACTERS im Handbuch für Oracle Database-Globalisierungsfunktionen. |
|
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. |
|
Die Formatoption
Wenn die Datendateien unstrukturiert sind und die Unterklausel Bei Objektnamen, die nicht auf dem Hive-Format basieren, muss die Reihenfolge der angegebenen |
|
|
Gibt das Anführungszeichen für die Felder ein. Die |
Standardwert: Null bedeutet kein Anführungszeichen |
Option gültig mit JSON-Daten |
Gibt das Datensatz-Begrenzungszeichen an. Standardmäßig versucht Geben Sie dieses Argument explizit ein, wenn Sie das Standardverhalten außer Kraft setzen möchten. Beispiel:
Um anzugeben, dass kein Datensatzbegrenzungszeichen vorhanden ist, können Sie ein
Die |
Standardwert: newline erkannt |
|
Die Formatoption
Wenn der Wert von Die Zeichen "*" und "?" gelten als Platzhalterzeichen, wenn der Parameter Muster regulärer Ausdrücke werden nur für den Dateinamen oder Unterordnerpfad in Ihren URIs unterstützt, und der Musterabgleich ist mit dem Musterabgleich identisch, der von der Funktion Bei externen Tabellen wird diese Option nur bei 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 Gebiete finden Sie unter Gebietsschemadaten im Handbuch für Oracle Database-Globalisierungsfunktionen. |
|
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: Datenbankzeitstempelformat 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. |
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. Weitere Informationen finden Sie in der Beschreibung von Wenn Wenn Informationen zu den Für JSON-Daten mit Für JSON-Daten mit
|
Hinweis
Nicht alle DBMS_CLOUD -Prozeduren unterstützen alle diese Typen.
Standardwert: Null Für JSON-Daten gibt es zwei gültige |
Nur mit |
Wenn dies auf Wenn dieser Wert auf Diese Option ist nur für JSON-Collection-Daten mit |
Standardwert: |
Übergeordnetes Thema: DBMS_CLOUD-Package