OCT-Handbuch
OCT-Handbuch
Breadcrumbs

3.2.3.9. SQL-Ausführung

Der Step führt beliebige SQL Befehle in der OCT Datenbank aus.

Informationen zu den Bearbeitungsmöglichkeiten der Pipeline (hinzufügen, importieren, exportieren, Einstellungen, bearbeiten, usw.) sowie zur Bearbeitung einzelner Steps (Name, kopieren, Optionen mit Ausführungsbedingungen, Aufgabenplan hinzufügen, usw.) finden Sie auf der Startseite der Prozesspipelines: 3.2.3.1. Startseite

3.2.3.9.1. SQL-Ausführung-Step hinzufügen

  • Wählen Sie den gewünschten Step aus:

image-20250515-072214.png
Ansicht 1 “Step hinzufügen”

  • Wenn der Step ausgewählt wird, öffnet sich eine Übersicht:

image-20250514-131353.png
Ansicht 2 “Step hinzufügen”

3.2.3.9.2. Steuerungsabfrage (a)

image-20250602-125451.png

Steuerungsabfrage

  • Dies ist ein optionales Eingabefeld, um eine SQL-Abfrage auf der OCT-Datenbank auszuführen.

  • Für jede Ergebniszeile der Steuerungsabfrage wird der SQL-Befehl ausgeführt.

  • Die Ergebnisfelder der Steuerungsabfrage können als Variablen im SQL-Befehl verwendet werden.

  • Die Steuerungsabfrage im Beispiel liefert zwei Zeilen und daraus folgt, dass der SQL-Befehl zweimal ausgeführt wird.

Icon image-20250114-131412.png “SQL-Editor öffnen”

  • Über das Icon kann ein separater Dialog mit einem vergrößerten SQL-Editor geöffnet werden.

image-20250602-125548.png

Icon “Lupe” image-20240716-074324.png

  • Mit einem Linksklick auf das “Lupe”-Icon öffnet sich ein Dialog, der das Ergebnis der Steuerungsabfrage anzeigt.

image-20250602-125701.png

3.2.3.9.3. SQL-Befehl (b)

Wenn Sie globale Parameter im Skript verwenden möchten, muss die Parameter-ID in geschweifte Klammern gesetzt werden, z.B. {globalparam}. Dies gilt auch für Variablen, z.B. {variable1}.

  • Im Editor können beliebige SQL-Befehle definiert werden.

image-20250602-130012.png

Icon image-20250114-131412.png “SQL-Editor öffnen”

  • Mit einem Linksklick auf das Icon kann ein separater Dialog mit einem vergrößerten SQL-Editor geöffnet werden.

image-20250602-130352.png

Button “Ausführung testen”

  • Bei Auswahl des Buttons wird getestet, ob der SQL-Befehl erfolgreich ausgeführt werden kann.

image-20250522-073214.png

  • Ist der Befehl ungültig oder werden dynamische Parameter im SQL-Befehl verwendet, öffnet sich ein Fehlerdialog.

  • Ergebnisse einer SELECT Abfrage werden nicht angezeigt sowie nicht im Log ausgegeben.

  • Um Log Nachrichten in den Prozesslogs zu erzeugen, kann die Prozedur system.spSEND_Message verwendet werden. Die Prozedur erfordert die Angabe eines Log-Levels (DEBUG, INFO, WARNING, ERROR) und der Nachricht. (z.B. “EXEC system.spSEND_Message ‘INFO’, ‘Hallo Welt!’”).

Weitere Informationen zu Nachrichten finden Sie hier: 3.11 Individuelle Nachrichten & Fehlermeldungen in der OCT Weboberfläche anzeigen

  • Alternativ können mit dem PRINT Befehl auch Log Nachrichten in den Prozesslogs erzeugt werden. Dadurch entsteht automatisch ein Log Eintrag vom Typ “INFO”.

  • Sie können globale Parameter nutzen, indem Sie {PARAMETERNAME} einfügen. Dieser Parameter wird dann durch den ersten Wert des globalen Parameters ersetzt.

  • Zusätzlich zu globalen Parametern kann man auch die aus der Steuerungsabfrage zurückgegebenen Felder mit {Feldname} nutzen.

image-20250602-130204.png

3.2.3.9.4. Zusätzliche SQL-Befehle (c)

PreSQL und PostSQL Befehle werden nur einmal ausgeführt, unabhängig von der Anzahl der Ergebnisse der Steuerungsabfrage.

image-20250602-130557.png

PreSQL

  • SQL-Befehl, welcher ausgeführt werden soll.

  • Die Verwendung von PreSQL ist nur sinnvoll, wenn eine Steuerungsabfrage genutzt wird.

  • PreSQL wird einmal nach der Steuerungsabfrage ausgeführt.

PostSQL

  • SQL-Befehl, welcher ausgeführt werden soll.

  • Die Verwendung von PostSQL ist nur sinnvoll, wenn eine Steuerungsabfrage genutzt wird.

  • PostSQL wird einmal nach dem SQL-Befehl ausgeführt, unabhängig davon, wie oft dieser ausgeführt wird.

Icon image-20250114-131412.png “SQL-Editor öffnen”

  • Mit einem Linksklick auf das Icon kann ein separater Dialog mit einem vergrößerten SQL-Editor geöffnet werden.

image-20250602-130653.png
Beispiel: PostSQL

Wenn Sie globale Parameter im Skript verwenden möchten, muss die Parameter-ID in geschweifte Klammern gesetzt werden, z.B. {globalparam}. Dies gilt auch für Variablen, z.B. {variable1}.

Nach dem Hinzufügen eines Steps muss dieser gespeichert werden. Danach kann über das Icon image-20250115-110419.png in der Menüleiste die Pipeline gestartet werden.

Während die Pipeline ausgeführt wird, erscheint solange ein sich drehender Kreis image-20250115-110355.png in der Pipelinezeile, bis der Prozess beendet ist.