FB_SqlDbWrite

Übersicht

Typ	Funktionsbaustein
Verfügbar ab	V1.0.0.0

Aufgabe

Der Funktionsbaustein FB_SqlDbWrite ermöglicht die Ausführung von SQL-Requests zur Aktualisierung oder Änderung der SQL-Datenbank. Auf diese Requests werden keine Daten zurückgegeben.

Funktionsbeschreibung

Der Funktionsbaustein FB_SqlDbWrite fungiert als Benutzerschnittstelle für die Aktualisierung und Änderung der SQL-Datenbank.

Bei Erkennung einer steigenden Flanke an i_xExecute wird unter Verwendung der in der Struktur ST_ConnectionSettings definierten Parameter eine Verbindung zum SQL Gateway hergestellt. Sobald die Verbindung aufgebaut ist, kann der Funktionsbaustein einen SQL-Request an die SQL-Datenbank senden (Übergabe an den Eingang i_refRequestWstring).

Während der Ausführung des Funktionsbausteins steht der Ausgang q_xBusy auf TRUE. Sobald ein Befehl erfolgreich abgeschlossen wurde, wird der Ausgang q_xDone auf TRUE gesetzt.

Statusmeldungen und Diagnoseinformationen werden unter Verwendung der Ausgänge q_xError (TRUE, wenn ein Fehler erkannt wurde), q_etResult und q_etResultMsg bereitgestellt.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_xExecute	BOOL	Der Funktionsbaustein führt einen SQL-Request aus, um die SQL-Datenbank bei einer steigenden Flanke an diesem Eingang zu aktualisieren oder zu ändern.
i_refRequestWstring	REFERENCE TO [RequestWstring]	Verweis auf die Request-Daten, die einen SQL-Aktualisierungsrequest enthalten. Folgende SQL-Abfragetypen werden unterstützt: oINSERT INTO oUPDATE oDELETE FROM oCREATE TABLE oCREATE VIEW oCREATE INDEX oALTER TABLE oDROP TABLE oTRUNCATE TABLE Jeder SQL-Request muss in separate Zeichenfolgen einer Länge von jeweils maximal 200 Zeichen aufgespalten werden. Passen Sie die Größe der globalen Parameter Gc_uiMaxRequest und Gc_uiRequestWstringLength in Übereinstimmung mit der Länge der in Ihrer Anwendung verwendeten SQL-Requests an. HINWEIS: Verwenden Sie zur Verkettung der WSTRINGS die Funktion CONCAT der Standard64-Bibliothek.
i_uiNumOfWstrings	UINT	Die Anzahl der erforderlichen WSTRINGS mit dem aufgeteilten SQL-Request. Die maximale Anzahl wird vom globalen Parameter Gc_uiMaxRequest vorgegeben.

Eingang

Datentyp

Beschreibung

i_xExecute

BOOL

Der Funktionsbaustein führt einen SQL-Request aus, um die SQL-Datenbank bei einer steigenden Flanke an diesem Eingang zu aktualisieren oder zu ändern.

i_refRequestWstring

REFERENCE TO [RequestWstring]

Verweis auf die Request-Daten, die einen SQL-Aktualisierungsrequest enthalten.

Folgende SQL-Abfragetypen werden unterstützt:

oINSERT INTO

oUPDATE

oDELETE FROM

oCREATE TABLE

oCREATE VIEW

oCREATE INDEX

oALTER TABLE

oDROP TABLE

oTRUNCATE TABLE

Jeder SQL-Request muss in separate Zeichenfolgen einer Länge von jeweils maximal 200 Zeichen aufgespalten werden.

Passen Sie die Größe der globalen Parameter Gc_uiMaxRequest und Gc_uiRequestWstringLength in Übereinstimmung mit der Länge der in Ihrer Anwendung verwendeten SQL-Requests an.

HINWEIS: Verwenden Sie zur Verkettung der WSTRINGS die Funktion CONCAT der Standard64-Bibliothek.

i_uiNumOfWstrings

UINT

Die Anzahl der erforderlichen WSTRINGS mit dem aufgeteilten SQL-Request.

Die maximale Anzahl wird vom globalen Parameter Gc_uiMaxRequest vorgegeben.

Eingang/Ausgang	Datentyp	Beschreibung
iq_stConnSettings	ST_ConnectionSettings	Enthält Informationen für den Aufbau einer Verbindung zu einem SQL Gateway sowie zur SQL-Datenbank.

Ausgang	Datentyp	Beschreibung
q_xBusy	BOOL	Wenn dieser Ausgang auf TRUE gesetzt wird, bedeutet das, dass der Funktionsbaustein ausgeführt wird.
q_xDone	BOOL	Wenn dieser Ausgang auf TRUE gesetzt wird, wurde die Ausführung erfolgreich abgeschlossen.
q_xError	BOOL	Wenn dieser Ausgang auf TRUE gesetzt wird, wurde ein Fehler identifiziert. Für weitere Informationen, siehe q_etResult und q_etResultMsg,
q_etResult	ET_Result	Gibt Diagnose- und Statusinformationen an.
q_sResultMsg	STRING[255]	Gibt zusätzliche Diagnose- und Statusinformationen an.