FB_SqlDbWrite

概述

类型：	功能块
适用的版本：	V1.0.0.0

任务

FB_SqlDbWrite 功能块用于执行更新或修改 SQL 数据库的 SQL 请求。这些请求不会返回任何数据。

功能描述

FB_SqlDbWrite 功能块是用于更新或修改 SQL 数据库的用户接口。

在 i_xExecute 上检测到上升沿之后，便会使用结构 ST_ConnectionSettings 中定义的参数来建立到 SQL Gateway 的连接。一旦建立了连接，这个功能块就能够向 SQL 数据库发送一个 SQL 请求（针对输入 i_refRequestWstring）。

只要执行了该功能块，输出 q_xBusy 就会设置为 TRUE。命令成功完成之后，输出 q_xDone 设置为 TRUE。

状态消息和诊断信息使用输出 q_xError（如果检测到错误则为 TRUE）、q_etResult 和 q_etResultMsg 提供。

接口

输入	数据类型	描述
i_xExecute	BOOL	这个功能块执行 SQL 请求以便在该输入的上升沿上更新或修改 SQL 数据库。
i_refRequestWstring	REFERENCE TO [RequestWstring]	引用包含一个 SQL 更新请求的请求数据。支持以下 SQL 查询类型： oINSERT INTO oUPDATE oDELETE FROM oCREATE TABLE oCREATE VIEW oCREATE INDEX oALTER TABLE oDROP TABLE oTRUNCATE TABLE 任何 SQL 请求都必须划分成独立的字符串，这些字符串的长度各自不超过 200 个字符。根据应用程序中使用的 SQL 请求的长度，调节全局参数 Gc_uiMaxRequest 和 Gc_uiRequestWstringLength 的大小。注意：如要合并 WSTRINGS，则使用 Standard64 库的 CONCAT 功能。
i_uiNumOfWstrings	UINT	所需的包含拆分 SQL 请求的 WSTRINGS 的数量。最大数量由全局参数 Gc_uiMaxRequest 限制。

输入

数据类型

描述

i_xExecute

BOOL

这个功能块执行 SQL 请求以便在该输入的上升沿上更新或修改 SQL 数据库。

i_refRequestWstring

引用包含一个 SQL 更新请求的请求数据。

支持以下 SQL 查询类型：

oINSERT INTO

oUPDATE

oDELETE FROM

oCREATE TABLE

oCREATE VIEW

oCREATE INDEX

oALTER TABLE

oDROP TABLE

oTRUNCATE TABLE

任何 SQL 请求都必须划分成独立的字符串，这些字符串的长度各自不超过 200 个字符。

根据应用程序中使用的 SQL 请求的长度，调节全局参数 Gc_uiMaxRequest 和 Gc_uiRequestWstringLength 的大小。

注意：如要合并 WSTRINGS，则使用 Standard64 库的 CONCAT 功能。

i_uiNumOfWstrings

UINT

所需的包含拆分 SQL 请求的 WSTRINGS 的数量。

最大数量由全局参数 Gc_uiMaxRequest 限制。

In_Out	数据类型	描述
iq_stConnSettings	ST_ConnectionSettings	包含连接到 SQL Gateway 所需的相关信息以及有关 SQL 数据库的信息。

输出	数据类型	描述
q_xBusy	BOOL	如果此输出设置为 TRUE，则正在执行功能块。
q_xDone	BOOL	如果此输出设置为 TRUE，则执行已成功完成。
q_xError	BOOL	如果此输出设置为 TRUE，则检测到错误。有关详细信息，请参阅 q_etResult 和 q_etResultMsg。
q_etResult	ET_Result	提供诊断和状态信息。
q_sResultMsg	STRING[255]	提供附加诊断和状态信息。