FB_SqlDbWrite

Présentation

Type :	Bloc fonction
Disponible à partir de la version :	V1.0.0.0

Tâche

Le bloc fonction FB_SqlDbWrite permet d'exécuter des requêtes SQL qui modifient ou mettent à jour la base de données SQL. Les requêtes ne renvoient aucune donnée.

Description fonctionnelle

Le bloc fonction FB_SqlDbWrite est l'interface utilisateur qui permet de modifier ou de mettre à jour la base de données SQL.

Lorsqu'un front montant est détecté sur i_xExecute, une connexion à la SQL Gateway est établie à l'aide des paramètres définis dans la structure ST_ConnectionSettings. Une fois la connexion établie, le bloc fonction peut envoyer une requête SQL (indiqué à l'entrée i_refRequestWstring) à la base de données SQL.

Tant que le bloc fonction est exécuté, la sortie q_xBusy est TRUE. Lorsqu'une commande aboutit, la sortie q_xDone a pour valeur TRUE.

Les messages d'état et informations de diagnostic sont fournis à l'aide des sorties q_xError (TRUE si une erreur a été détectée), q_etResult et q_etResultMsg.

Interface

Entrée	Type de données	Description
i_xExecute	BOOL	Le bloc fonction exécute une requête SQL pour modifier ou mettre à jour la base de données SQL en cas de front montant sur cette entrée.
i_refRequestWstring	REFERENCE TO [RequestWstring]	Référence aux données qui contiennent une requête de mise à jour SQL. Les types d'interrogation SQL pris en charge sont les suivants : oINSERT INTO oUPDATE oDELETE FROM oCREATE TABLE oCREATE VIEW oCREATE INDEX oALTER TABLE oDROP TABLE oTRUNCATE TABLE Une requête SQL doit être divisée en plusieurs chaînes ne dépassant pas 200 caractères. Adaptez la taille des paramètres globaux Gc_uiMaxRequest et Gc_uiRequestWstringLength à la longueur des requêtes SQL que vous utilisez dans votre application. NOTE : Pour concaténer des chaînes WSTRINGS, utilisez la fonction CONCAT de la bibliothèque Standard64.
i_uiNumOfWstrings	UINT	Nombre de chaînes WSTRINGS requises qui contiennent la requête SQL divisée. Le nombre maximum est limité par le paramètre global Gc_uiMaxRequest.

Entrée

Type de données

Description

i_xExecute

BOOL

Le bloc fonction exécute une requête SQL pour modifier ou mettre à jour la base de données SQL en cas de front montant sur cette entrée.

i_refRequestWstring

REFERENCE TO [RequestWstring]

Référence aux données qui contiennent une requête de mise à jour SQL.

Les types d'interrogation SQL pris en charge sont les suivants :

oINSERT INTO

oUPDATE

oDELETE FROM

oCREATE TABLE

oCREATE VIEW

oCREATE INDEX

oALTER TABLE

oDROP TABLE

oTRUNCATE TABLE

Une requête SQL doit être divisée en plusieurs chaînes ne dépassant pas 200 caractères.

Adaptez la taille des paramètres globaux Gc_uiMaxRequest et Gc_uiRequestWstringLength à la longueur des requêtes SQL que vous utilisez dans votre application.

NOTE : Pour concaténer des chaînes WSTRINGS, utilisez la fonction CONCAT de la bibliothèque Standard64.

i_uiNumOfWstrings

UINT

Nombre de chaînes WSTRINGS requises qui contiennent la requête SQL divisée.

Le nombre maximum est limité par le paramètre global Gc_uiMaxRequest.

In_Out	Type de données	Description
iq_stConnSettings	ST_ConnectionSettings	Contient les informations de connexion à une SQL Gateway et les informations concernant la base de données SQL.

Sortie	Type de données	Description
q_xBusy	BOOL	Si cette sortie est TRUE, le bloc fonction est en cours d'exécution.
q_xDone	BOOL	Si cette sortie est TRUE, l'exécution s'est effectuée correctement.
q_xError	BOOL	Si cette sortie est TRUE, une erreur a été détectée. Pour plus d'informations, reportez-vous à q_etResult et q_etResultMsg.
q_etResult	ET_Result	Fournit des informations de diagnostic et d'état.
q_sResultMsg	STRING[255]	Fournit des informations supplémentaires de diagnostic et d'état.