FB_SqlDbWrite

Descripción general

Tipo:	Bloque de funciones
Disponible desde:	V1.0.0.0

Tarea

El bloque de funciones FB_SqlDbWrite se usa para realizar peticiones SQL que actualizan o modifican datos de la base de datos SQL. Las peticiones no devuelven ningún dato.

Descripción funcional

El bloque de funciones FB_SqlDbWrite es la interfaz de usuario para actualizar o modificar datos de la base de datos SQL.

Después de detectar un flanco ascendente en i_xExecute, se establece una conexión a la SQL Gateway con los parámetros definidos en la estructura ST_ConnectionSettings. En cuanto se establezca la conexión, el bloque de funciones puede enviar una petición SQL a la base de datos SQL (la petición se realiza a la entrada i_refRequestWstring).

En cuanto se ejecute el bloque de funciones, la salida q_xBusy se establece en TRUE. Cuando un comando se ha completado correctamente, la salida q_xDone se establece en TRUE.

Los mensajes de estado y la información de diagnóstico se proporcionan usando las salidas q_xError (TRUE si se ha detectado un error), q_etResult y q_etResultMsg.

Interfaz

Entrada	Tipo de datos	Descripción
i_xExecute	BOOL	El bloque de funciones realiza una petición SQL para actualizar o modificar datos de la base de datos SQL tras el flanco ascendente de esta entrada.
i_refRequestWstring	REFERENCE TO [RequestWstring]	Referencia a los datos de petición que contiene la petición de actualización SQL. Se admiten los siguientes tipos de consulta SQL: oINSERT INTO oUPDATE oDELETE FROM oCREATE TABLE oCREATE VIEW oCREATE INDEX oALTER TABLE oDROP TABLE oTRUNCATE TABLE Cualquier petición SQL debe dividirse en cadenas individuales con una longitud máxima de 200 caracteres cada una. Adapte el tamaño de los parámetros globales Gc_uiMaxRequest y Gc_uiRequestWstringLength según la longitud de las peticiones SQL que use en su aplicación. NOTA: Para concatenar WSTRINGS, use la función CONCAT de la biblioteca Standard64.
i_uiNumOfWstrings	UINT	El número de WSTRINGS necesarios que contiene la petición SQL dividida. El número máximo está limitado por los parámetros globales Gc_uiMaxRequest.

Entrada

Tipo de datos

Descripción

i_xExecute

BOOL

El bloque de funciones realiza una petición SQL para actualizar o modificar datos de la base de datos SQL tras el flanco ascendente de esta entrada.

i_refRequestWstring

REFERENCE TO [RequestWstring]

Referencia a los datos de petición que contiene la petición de actualización SQL.

Se admiten los siguientes tipos de consulta SQL:

oINSERT INTO

oUPDATE

oDELETE FROM

oCREATE TABLE

oCREATE VIEW

oCREATE INDEX

oALTER TABLE

oDROP TABLE

oTRUNCATE TABLE

Cualquier petición SQL debe dividirse en cadenas individuales con una longitud máxima de 200 caracteres cada una.

Adapte el tamaño de los parámetros globales Gc_uiMaxRequest y Gc_uiRequestWstringLength según la longitud de las peticiones SQL que use en su aplicación.

NOTA: Para concatenar WSTRINGS, use la función CONCAT de la biblioteca Standard64.

i_uiNumOfWstrings

UINT

El número de WSTRINGS necesarios que contiene la petición SQL dividida.

El número máximo está limitado por los parámetros globales Gc_uiMaxRequest.

In_Out	Tipo de datos	Descripción
iq_stConnSettings	ST_ConnectionSettings	Contiene la información para conectarse a una SQL Gateway e información sobre la base de datos SQL.

Salida	Tipo de datos	Descripción
q_xBusy	BOOL	Si esta salida está configurada en TRUE, la ejecución del bloque de funciones está en curso.
q_xDone	BOOL	Si esta salida está configurada en TRUE, la ejecución se ha completado correctamente.
q_xError	BOOL	Si esta salida se establece en TRUE, se ha detectado un error. Para obtener información detallada, consulte q_etResult y q_etResultMsg.
q_etResult	ET_Result	Proporciona información de estado y diagnóstico.
q_sResultMsg	STRING[255]	Proporciona información adicional de estado y diagnóstico.