4D v14.3

SQL FIXER PARAMETRE

Accueil

 
4D v14.3
SQL
SQL FIXER PARAMETRE

SQL FIXER PARAMETRE 


 

SQL FIXER PARAMETRE ( objet ; typeParam ) 
Paramètre Type   Description
objet  Objet 4D in Objet 4D à utiliser (variable, tableau ou champ)
typeParam  Entier long in Type du paramètre

La commande SQL FIXER PARAMETRE 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 Commentaire
    SQL paramètre entrée Entier long 1
    SQL paramètre entrée sortie 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ètre sortie 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 FIXER PARAMETRE 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ètre sortie 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 EXECUTER (cf. section Présentation des commandes du thème SQL). La commande SQL FIXER PARAMETRE est généralement utilisée pour définir des paramètres passés à la requête (SQL Paramètre entrée) ; les types SQL Paramètre sortie et SQL Paramètre entrée sortie sont réservés à une utilisation dans le contexte de procédures stockées SQL pouvant retourner des paramètres.

Cet exemple permet d’exécuter une requête SQL faisant directement appel à des variables 4D associées :

 C_TEXTE(MonTexte)
 C_ENTIER LONG(MonEntierLong)
 
 SQL LOGIN("mysql";"root";"")
 SQLStmt:="insert into app_testTable (alpha_field, longint_field) VALUES (<<MonTexte>>, <<MonEntierLong>>)"
 Boucle(vCounter;1;10)
    MonTexte:="Texte"+Chaine(vCounter)
    MonEntierLong:=vCounter
    SQL EXECUTER(SQLStmt)
    SQL ANNULER CHARGEMENT
 Fin de boucle
 SQL LOGOUT

Même exemple que le précédent, mais en utilisant la commande SQL FIXER PARAMETRE :

 C_TEXTE(MonTexte)
 C_ENTIER LONG(MonEntierLong)
 
 SQL LOGIN("mysql";"root";"")
 SQLStmt:="insert into app_testTable (alpha_field, longint_field) VALUES (?,?)"
 Boucle(vCounter;1;10)
    MonTexte:="Texte"+Chaine(vCounter)
    MonEntierLong:=vCounter
    SQL FIXER PARAMETRE(MonTexte;SQL paramètre entrée)
    SQL FIXER PARAMETRE(MonEntierLong;SQL paramètre entrée)
    SQL EXECUTER(SQLStmt)
    SQL ANNULER CHARGEMENT
 Fin de boucle
 SQL LOGOUT

Si la commande a été correctement exécutée, la variable système OK retourne 1, sinon elle retourne 0.

 
PROPRIÉTÉS 

Produit : 4D
Thème : SQL
Numéro : 823
Nom intl. : SQL SET PARAMETER

Cette commande modifie la variable système OK

 
HISTORIQUE 

Créé : 4D 2004

 
UTILISATION DE L'ARTICLE

4D - Langage ( 4D v12.4)
4D - Langage ( 4D v11 SQL Release 6)
4D - Langage ( 4D v14 R3)
4D - Langage ( 4D v14 R2)
4D - Langage ( 4D v13.5)
4D - Langage ( 4D v14.3)
4D - Langage ( 4D v14 R4)