FB_SqlDbWrite

Présentation

Type :	Bloc fonction
Disponible à partir de :	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ée à l'entrée i_refRequestWstring) à la base de données SQL.

Les messages d'état et les 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. Pour plus d'informations, consultez également la section Comportement des blocs fonction avec l'entrée i_xExecute.
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 : `INSERT INTO` `UPDATE` `DELETE FROM` `CREATE TABLE` `CREATE VIEW` `CREATE INDEX` `ALTER TABLE` `DROP TABLE` `TRUNCATE 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.

Pour plus d'informations, consultez également la section Comportement des blocs fonction avec l'entrée i_xExecute.

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 :

INSERT INTO
UPDATE
DELETE FROM
CREATE TABLE
CREATE VIEW
CREATE INDEX
ALTER TABLE
DROP TABLE
TRUNCATE 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.

Pour plus d'informations, reportez-vous également à la section Entrées et sorties communes.