SQL-Select

Mit diesem Block-Kommando lässt sich eine SQL-Abfrage an eine Datenbank richten. Im Körper des Blockkommandos (Schleife über das Resultset der Abfrage) können dann pro Ergebniszeile der Abfrage die Daten gelesen und verarbeitet werden.

Parameter:

  • SQL-Statement: SQL-Abfrage (SELECT <<col1>>, <<col2>> , … FROM <<table>>). Es wird dringend empfohlen etwaige Felder in diesem Ausdruck als Bind-Variablen anzugeben. Bind-Variablen
  • Zielfeld 1: Das Zielfeld in dem der Wert des ersten Parameters im SELECT-Teil geschrieben wird.
  • Zielfeld 2: Das Zielfeld in dem der Wert des zweiten Parameters im SELECT-Teil geschrieben wird.
  • …
  • Zielfeld 10: Das Zielfeld in dem der Wert des zehnten Parameters im SELECT-Teil geschrieben wird.
  • Connector Name: Der Konnektor zur Datenbank auf der die SQL-Anweisung ausgeführt werden soll. (Default: defaultConnector)
  • Metadaten erzeugen: Nachdem die Abfrage ausgeführt wurde, werden für jede Spalte des Ergebnisses der Abfrage ein Datenobjekt vom Typ "SQL:Metadata" erzeugt. Siehe dazu den folgenden Abschnitt.

Metadaten

Wurden über das SQL-Select Kommando Metadaten erzeugt, so stehen diese in Datenobjekten SQL:Metadata zur Verfügung. Es wird für jede Spalte des SQL-Ergebnisses ein Datenobjekt angelegt.

Folgende Informationen stehen über diese Datenobjekte zur Verfügung:

  • ColumnIndex (Spaltenindex): Die Nummer der Spalte. Beginnt bei 1
  • CatalogName (Katalogname): Falls die Datenbank Kataloge verwendet, ist der Katalog der Tabelle aus der diese Spalte gelesen wurde hier verfügbar.
  • ColumnLabel (Spaltenbeschriftung): Der Name (Beschriftung) der Spalte im Ergebnis der SQL-Abfrage
  • ColumnType (Spaltentyp): Der Datentyp dieser Spalte im SQL-Ergebnis. Der Datentyp kann von der Datenbank-Art abhängen.
  • ColumnSchema (Spaltenschema): Das Schema aus dem die Tabelle dieser Spalte stammt.
  • ColumnTable (Spaltentabelle): Die Tabelle aus der diese Spalte stammt. Kann z.B. bei Joins sich pro Spalte unterscheiden.
  • DisplaySize (Anzeigelänge): Die Länge der Spalte. Üblicherweise ist hier die maximal Anzahl von Zeichen für diese Spalte abrufbar.
  • Precision (Genauigkeit): Bei numerischen Spalten, die Anzahl der Ziffern, die diese Spalte insgesamt hat.
  • Scale (Dezimalwert): Bei numerischen Spalten, Anzahl der Nachkommastellen, die diese Spalte hat.
  • TotalColumnCount (GeamtSpaltenAnzahl): Anzahl aller Spalten des Ergebnissets. Ist in allen Datenobjekten gleich.

Um diese Datenobjekte gut auslesen zu können empfiehlt sich die Verwendung des Kommandos Datenobjekt Schleife (geladene Daten).