2.5. Step-Typ: SQL-Datentransfer

Über den Step SQL-Datentransfer können Daten per SELECT aus einer registrierten SQL-Datenquelle abgefragt werden und eine Tabelle der lokalen OCT-Datenbank eingefügt werden.

1. Voraussetzungen

• eine Datenquelle vom Typ MSSQL ist registriert

• in der OCT Datenbank ist eine Zieltabelle für den Transfer angelegt, welche mit Datensätzen gefüllt werden soll

• auf diese Tabelle wurde der User OCTService berechtigt (nur nötig, falls die Tabelle nicht in einem Standard Schema liegt, auf welchem OCTService sowieso Rechte hat)

• es wird eine SQL Abfrage auf die Datenquelle geschrieben, welche exakt (Spaltennamen incl. Groß/Kleinschreibung, Datentypen, Spaltenzahl, Spaltenreihenfolge) zur Zieltabelle passt

• Jede Spalte in der Quellabfrage benötigt somit einen Alias Spaltennamen (SELECT … AS Spaltenname) falls er nicht exakt passt

• Die Abfragen können auch JOINs etc. umfassen, entscheidend ist, das es nur ein einziges Resultset gibt

• die Zieltabelle darf nicht enthalten

  • Autoinkrement Primärschlüssel

  • berechnete Spalten

2. Verwendungsanleitung

• einen Namen für den Step vergeben - typischerweise nach dem Namen der Tabelle die gefüllt wird

• optional ein PRE SQL Statement angeben - dieses wird vor dem Transfer ausgeführt und kann z.B.

  • per DELETE oder TRUNCATE die Zieltabelle leeren (meist per DELETE, TRUNCATE erfordert höhere Rechte)

  • die Zieltabelle erzeugen

• die Zieltabelle angeben - Name mit Schema

• das SQL Statement der zur Zieltabelle passenden Abfrage

• optional ein POST SQL Statement - dieses wird nach dem Transfer ausgeführt und kann z.B.

  • eine Stored Procedure zur Weiterverarbeitung auslösen

  • einen Index auf der Zieltabelle erstellen

  • in der Zieltabelle berechnete Spalten etc. erstellen

3. Zusätzliche Informationen

3.1. Betriebshinweise

• Wie kann ich einen laufenden Transfer abbrechen ?

  • mit der Abbrechen Schaltfläche an der Pipeline kann der Prozess eines Steps nicht gestoppt werden - er würde nur den nächsten Step nicht mehr ausführen

  • um den laufenden Step abzubrechen OCT Dienst neu starten - das bricht aber alle Prozesse ab und alle laufenden Usereingaben

• Was passiert, falls während des Transfers die Verbindung zur Quelldatenbank unterbrochen wird ?

  • Prozess wird sofort mit Fehler beendet, Fehler steht im Log