DB Select
Das Transferobjekt DB Select fragt einen oder mehrere Datensätze aus einer Tabelle oder Datenbankansicht (View) ab. Das Transferobjekt dient damit als Datenquelle.
Dialogübersicht
Allgemeine Eigenschaften
| Eigenschaft | Beschreibung |
|---|---|
| DB-Anbindung | Hier stehen alle im Bereich Plug-ins erstellten Anbindungen relationaler Datenbanken zur Auswahl. Sollte Ihre gewünschte Datenbankanbindung nicht dabei sein, können Sie diese im Plug-ins-Bereich als Microsoft SQL Server, Oracle, SAP HANA, ODBC, OLE DB, MySQL oder PostgreSQL bereitstellen. |
| Tabelle | Tabelle oder Datenbankansicht (View), aus der gelesen wird. |
| Verfügbare Spalten | In der Tabelle vorhandene, noch nicht verwendete Spalten. |
| Verwendete Spalten | Spalten, die als Elemente des Transferobjekts angezeigt werden und damit für die Abfrage zur Verfügung stehen. |
Die Unterscheidung zwischen verfügbaren und verwendeten Spalten dient der Übersicht in der Projektierungsfläche. Verschieben Sie Spalten durch Doppelklick auf den Spaltennamen oder über die Schaltflächen <, >, << und >>. Mit den Schaltflächen Auf und Ab sortieren Sie die verwendeten Spalten.
Filter
Die Filter werden grafisch projektiert. Daraus erzeugt der OPC Router zur Laufzeit die passende Datenbankabfrage. Die Werte für die Filter können zur Laufzeit dynamisch gefüllt oder bereits zur Entwurfszeit über Variablen definiert werden.
| Eigenschaft | Beschreibung |
|---|---|
| Filter | Stellt Filter und Filtergruppen grafisch dar. |
| Verknüpfung | Legt die Operatoren AND und OR zwischen Filtern und Filtergruppen fest. |
| Spalte | Spalte, nach der gefiltert wird. |
| Vergleichsoperator | Operator für den Wertevergleich. |
| Vorschau | Zeigt die daraus erzeugte Abfrage als SQL-Anweisung, zum Beispiel WHERE (ZEITSTEMPEL > ?) AND (WERT = ?). |
In der Projektierungsoberfläche sehen Sie die Filterkriterien als Elemente. Ziehen Sie Verbindungspfeile von beliebigen anderen Transferobjekten auf die Filterkriterien, um sie zu füllen. Für Zeitstempelfilter können auch relative Angaben verwendet werden, zum Beispiel -1d für das Datum des Vortags.
Eine Erklärung zu den verschiedenen Filteroperatoren befindet sich hier.
Abfrage
| Eigenschaft | Beschreibung |
|---|---|
| Sortierreihenfolge | Auf- oder absteigend. |
| Sortierung nach Spalte | Spalte, nach der das Abfrageergebnis sortiert wird. |
| Datensätze nicht verändern | Nur bei Abfragen aus Tabellen möglich. Es erfolgt keine Änderung der übertragenen Datensätze. |
| Datensätze nach durchgeführtem Transfer markieren | Nur bei Abfragen aus Tabellen möglich. In einer entsprechenden Spalte der Quelltabelle wird für jeden erfolgreich transferierten Datensatz 1 und für einen fehlerhaften Transfer 2 eingetragen. |
| Spalte zum Markieren | Nur bei Abfragen aus Tabellen möglich. Spalte, in der der Marker für den erfolgten oder fehlerhaften Datentransfer eingetragen wird. |
| Markierungswerte | Werte, die in die Markierungsspalte eingetragen werden. Die Markierungswerte müssen eindeutig sein. |
| Zähle fehlgeschlagene Transfers | Zählt die fehlgeschlagenen Transfers. |
| Datensätze nach erfolgreichem Transfer löschen | Nur bei Abfragen aus Tabellen möglich. Transferierte Datensätze können auch aus der Tabelle gelöscht werden. |
| Transfer abbrechen (bei leerem Abfrageergebnis) | Bricht den Datentransfer bei leerem Abfrageergebnis ab. |
| Lesefehler auslösen (bei leerem Abfrageergebnis) | Bricht den Datentransfer bei leerem Abfrageergebnis ab und löst die Fehleraufzeichnung aus. |
| Leeren Datensatz zurückgeben | Gibt bei einem leeren Abfrageergebnis einen leeren Datensatz zurück. |
| Anzahl Datensätze begrenzen auf | Transferiert nur die hier angegebene Anzahl der Datensätze. Die Sortierung muss entsprechend eingestellt sein. |
Für Datensätze nach durchgeführtem Transfer markieren wird in der betreffenden Tabelle ein einfacher Primärschlüssel auf die numerische Spalte ID benötigt.
Wenn Sie Zähle fehlgeschlagene Transfers verwenden, wählen Sie bei Fehlerspalte die Spalte aus, in der die Anzahl der fehlgeschlagenen Transfers hochgezählt werden soll.
Wenn Sie Datensätze nach erfolgreichem Transfer löschen aktivieren, werden die Datensätze in der Quelltabelle unwiderruflich gelöscht.
Hinweise
Verwenden Sie DB Select nur in Verbindung mit Filtern, damit nicht die gesamte Tabelle in den Arbeitsspeicher geladen wird. In Verbindung mit Transfermarkierungen filtern Sie zum Beispiel nach <Transferflag> <> 1.
Markieren Sie transferierte Datensätze über eine eigene Transferflag-Spalte. Die fachlichen Grundlagen dazu finden Sie auch im Transferstatus-Trigger sowie unter Beispiele und Konzepte.
Zur Leistungsoptimierung kann nach der Transferflag-Spalte gefiltert werden, zum Beispiel Transferflag = 0 oder Transferflag = 2.