FB_DBRecordSelect_EX
Mit dem Funktionsbaustein FB_DBRecordSelect_EX können einzelne Datensätze mit beliebiger Struktur aus einer Datenbank ausgelesen werden. Mit diesem Baustein können Sie einen SQL-SELECT-Befehl mit bis zu 10000 Zeichen ausführen.
Dieser Funktionsbaustein ist nicht kompatibel mit ASCII-Files.
VAR_INPUT
VAR_INPUT
sNetID : T_AmsNetID;
Hdbid : UDINT;
cbCmdSize : UDINT;
pCmdAddr : UDINT;
nRecordIndex: UDINT;
cbRecordSize: UDINT;
pDestAddr : POINTER TO BYTE;
bExecute : BOOL;
tTimeout : TIME;
END_VAR
sNetID: String, der die AMS-Netzwerkkennung des Zielgerätes enthält, an das der ADS-Befehl gerichtet wird.
hDBID: Gibt die ID der zu verwendenden Datenbank an.
cbCmdSize: Gibt die Länge des SELECT-Befehls an, der ausgeführt werden soll.
pCmdSize: Gibt die Pointer-Adresse einer String-Variablen mit dem auszuführenden SQL-Befehl an.
nRecordIndex: Gibt den Index des zu lesenden Datensatzes an.
cbRecordSize: Gibt die Größe eines Datensatzes in Byte an.
pDestAddr: Gibt die Adresse der Struktur an, in die der Datensatz geschrieben werden soll.
bExecute: Mit steigender Flanke wird das Kommando ausgeführt.
tTimeout: Gibt die Zeit bis zum Abbruch der Funktion an.
VAR_OUTPUT
VAR_OUTPUT
bBusy : BOOL;
bError : BOOL;
nErrID : UDINT;
sSQLState: ST_DBSQLError;
nRecords : UDINT;
END_VAR
bBusy: Kommando wird gerade per ADS übertragen. Solange bBusy auf TRUE ist, wird kein neues Kommando angenommen.
bError: Wird TRUE, sobald ein Fehler eintritt.
nErrID: Liefert bei einem gesetzten bError-Ausgang den ADS Error Code bzw. TcDatabaseSrv_Error_Codes.
sSQLState: Liefert den SQL - Fehlercode des entsprechenden Datenbanktyps.
nRecords: Liefert die Anzahl der Datensätze.
Voraussetzungen
Entwicklungsumgebung |
Zielplattform |
Einzubindende SPS Bibliotheken |
---|---|---|
TwinCAT v3.0.0 |
PC oder CX (x86) |
Tc2_Database |