unloadTable()
Die Systemfunktion 'sqlLib.unloadTable()' entlädt Daten aus einer relationalen Datenbank in eine Datei. Die Funktion ist nur für Java™-Generierung verfügbar.
Um Informationen aus einer Datei zu laden und in eine relationale Datenbanktabelle einzufügen, verwenden Sie die Funktion 'sqlLib.loadTable()'.
Syntax
sqlLib.unloadTable(
Dateiname STRING in,
SELECT-Anweisung STRING in
[, Begrenzer STRING in
])
- Dateiname
- Der Name der Datei. Dieser Name ist entweder ein vollständig qualifizierter Name oder ein relativer Name bezogen auf das Verzeichnis, von dem aus das Programm aufgerufen wird.
- SELECT-Anweisung
- Geben Sie die Kriterien für die Auswahl von Daten aus der relationalen Datenbank an.
Verwenden Sie die Syntax einer SQL-Anweisung SELECT, ohne jedoch Hostvariablen einzuschließen.
Beispiel:
"SELECT column1, column2 FROM myTABLE WHERE column3 > 10" - Begrenzer
- Gibt das Symbol an, mit dem die Werte in der Datei
voneinander getrennt werden. (Die einzelnen Datenzeilen müssen durch ein Zeilenvorschubzeichen voneinander getrennt sein.)
Das Standardsymbol für 'Begrenzer' ist der Wert in der Java-Laufzeiteigenschaft 'vgj.default.databaseDelimiter', deren Standardwert wiederum folgendes Zeichen ist: (|).
Die folgenden Symbole sind nicht verfügbar:- Hexadezimalzeichen (0 bis 9, a bis f, A bis F)
- Umgekehrter Schrägstrich (\)
- Zeilenvorschubzeichen oder 'Strg+J'
Beispiel
Im folgenden Beispiel wird das Tabulatorzeichen (9 in Dezimalschreibweise in ASCII) in einem Zeichen gespeichert. Anschließend wird dieses Zeichen als Begrenzer verwendet.
myTabChar CHAR(1) = strLib.intAsChar(9);
sqlLib.loadTable("myDataFile.txt",
"SELECT column1, column2 FROM myTABLE", myTabChar);
Leere Zeichenfolgen und Nullen
In den Dateien, auf die mit der Funktion 'sqlLib.loadTable()' oder 'sqlLib.unloadTable()' zugegriffen wird, wird eine Zeichenfolge mit Nulllänge durch das Zeichen "\", gefolgt von einem Leerzeichen, dargestellt, und eine Null wird durch zwei Begrenzer hintereinander dargestellt.
||\ | |1234
Diese Zeichenfolge enthält eine Null, eine Zeichenfolge mit Nulllänge, eine Zeichenfolge aus einem Leerzeichen und "1234".
Kompatibilität
| Plattform | Problem |
|---|---|
| COBOL-Generierung | Die Funktion wird nicht unterstützt. |