FB_SqlDbWrite

Überblick

Typ:	Funktionsbaustein
Verfügbar ab:	V1.0.0.0

Aufgabe

Der Funktionsbaustein FB_SqlDbWrite wird verwendet, um SQL-Requests auszuführen, die die SQL-Datenbank aktualisieren oder ändern. Bei diesen 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).

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. Für weitere Informationen siehe auch Verhalten der Funktionsbausteine mit dem Eingang i_xExecute.
i_refRequestWstring	REFERENCE TO [RequestWstring]	Verweis auf die Request-Daten, die einen SQL-Aktualisierungsrequest enthalten. Folgende SQL-Abfragetypen werden unterstützt: `INSERT INTO` `UPDATE` `DELETE FROM` `CREATE TABLE` `CREATE VIEW` `CREATE INDEX` `ALTER TABLE` `DROP TABLE` `TRUNCATE TABLE` Jeder SQL-Request muss in separate Zeichenfolgen einer Länge von jeweils maximal 200 Zeichen aufgespaltet 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, die den aufgeteilten SQL-Request enthalten. Die maximale Anzahl wird über den 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.

Für weitere Informationen siehe auch Verhalten der Funktionsbausteine mit dem Eingang i_xExecute.

i_refRequestWstring

REFERENCE TO [RequestWstring]

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

Folgende SQL-Abfragetypen werden unterstützt:

INSERT INTO
UPDATE
DELETE FROM
CREATE TABLE
CREATE VIEW
CREATE INDEX
ALTER TABLE
DROP TABLE
TRUNCATE TABLE

Jeder SQL-Request muss in separate Zeichenfolgen einer Länge von jeweils maximal 200 Zeichen aufgespaltet 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, die den aufgeteilten SQL-Request enthalten.

Die maximale Anzahl wird über den 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.

Weitere Informationen finden Sie außerdem unter Gemeinsame Eingänge und Ausgänge.