SQL SET PARAMETER
SQL SET PARAMETER ( objet ; typeParam )
| Paramètre | Type | Description | |
|---|---|---|---|
| objet | Object | → | Objet 4D à utiliser (variable, tableau ou champ) |
| typeParam | Integer | → | Type du paramètre |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande SQL SET PARAMETER permet d’utiliser la valeur d’une variable, d’un tableau ou d’un champ 4D dans les requêtes SQL.
Note : Il est également possible d’insérer directement le nom d'un objet 4D à utiliser (variable, tableau ou champ) entre les caractères << et >> dans le texte de la requête (cf. exemple 1). Pour plus d'informations sur ce point, reportez-vous à la section Présentation des commandes du thème SQL.
- Passez dans le paramètre objet l’objet 4D (variable, tableau ou champ) à utiliser dans la requête.
- Passez dans le paramètre typeParam le type SQL du paramètre. Vous pouvez passer une valeur ou utiliser l’une des constantes suivantes, placées dans le thème "SQL" :
| Constante | Type | Valeur | Comment |
|---|---|---|---|
| SQL param in | Entier long | 1 | |
| SQL param in out | Entier long | 2 | Utilisable uniquement dans le contexte d'une procédure stockée SQL (paramètre entrée-sortie défini dans la procédure stockée) |
| SQL param out | Entier long | 4 | Utilisable uniquement dans le contexte d'une procédure stockée SQL (paramètre sortie défini dans la procédure stockée) |
La valeur de l’objet 4D est substituée au caractère ? dans la requête SQL (syntaxe standard). Si la requête comporte plusieurs caractères ?, plusieurs appels à SQL SET PARAMETER seront nécessaires. Les valeurs des objets 4D seront affectées séquentiellement dans la requête, dans l’ordre d’exécution des commandes.
Attention : Cette commande permet de manipuler les paramètres passés à la requête SQL. Il n'est pas possible d'utiliser le type SQL param out pour associer un objet 4D au résultat d'une requête SQL. Le résultat d'une requête SQL est récupéré par exemple via le paramètre objetLié de la commande SQL EXECUTE (cf. section Présentation des commandes du thème SQL). La commande SQL SET PARAMETER est généralement utilisée pour définir des paramètres passés à la requête (SQL param in) ; les types SQL param out et SQL param in out sont réservés à une utilisation dans le contexte de procédures stockées SQL pouvant retourner des paramètres.
Exemple 1
Cet exemple permet d’exécuter une requête SQL faisant directement appel à des variables 4D associées :
var MonTexte : Text
var MonEntierLong : Integer
SQL LOGIN("mysql";"root";"")
SQLStmt:="insert into app_testTable (alpha_field, longint_field) VALUES (<>, <>)"
For(vCounter;1;10)
MonTexte:="Texte"+String(vCounter)
MonEntierLong:=vCounter
SQL EXECUTE(SQLStmt)
SQL CANCEL LOAD
End for
SQL LOGOUT
Exemple 2
Même exemple que le précédent, mais en utilisant la commande SQL SET PARAMETER :
var MonTexte : Text
var MonEntierLong : Integer
SQL LOGIN("mysql";"root";"")
SQLStmt:="insert into app_testTable (alpha_field, longint_field) VALUES (?,?)"
For(vCounter;1;10)
MonTexte:="Texte"+String(vCounter)
MonEntierLong:=vCounter
SQL SET PARAMETER(MonTexte;SQL param in)
SQL SET PARAMETER(MonEntierLong;SQL param in)
SQL EXECUTE(SQLStmt)
SQL CANCEL LOAD
End for
SQL LOGOUT
Variables et ensembles système
Si la commande a été correctement exécutée, la variable système OK retourne 1, sinon elle retourne 0.