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.

Betrachten Sie beispielsweise die folgende Zeichenfolge, wenn das Zeichen "|" als Begrenzer verwendet wird:
||\ | |1234

Diese Zeichenfolge enthält eine Null, eine Zeichenfolge mit Nulllänge, eine Zeichenfolge aus einem Leerzeichen und "1234".

Kompatibilität

Tabelle 1. Hinweise zur Kompatibilität für 'sqlLib.unloadTable()'
Plattform Problem
COBOL-Generierung Die Funktion wird nicht unterstützt.

Feedback