ParametreSql

Instruction attribut. Définition des paramètres d'un source Programming Language / Structured Query Language (PL/SQL).

Syntaxe

ParametreSql ( ListeDeParametresSqlDeclares ) TailleTableauxParametresSqlDeclares

ParametreSql ( ListeDeParametresSqlTransmis ) TailleTableauxParametresSqlTransmis

Description

L'instruction ParametreSql permet de déclarer ou transmettre les paramètres d'entrée, d'entrée-sortie ou de sortie à un bloc, un ordre Programming Language / Structured Query Language (PL/SQL) ou à une requête Structured Query Language (SQL).

Un résultat d'une requête Sql n'est pas considéré comme un paramètre de sortie. Il doit être déclaré au moyen de l'instruction ResultatSql.

La sémantique diffère légèrement selon le contexte :

Pour la déclaration d'un bloc, d'un ordre Pl/Sql ou d'une requête Sql factorisé.
Son objet est uniquement de déclarer des paramètres.
En ce cas, chaque paramètre est déclaré avec son nom, son type et éventuellement sa taille.
Pour l'usage d'un bloc ou d'un ordre Pl/Sql ou d'une requête Sql factorisé.
Son objet est uniquement de transmettre les valeurs des paramètres.
En ce cas, chaque paramètre est valorisé par une expression dont le type du résultat doit être en accord avec le type de déclaration du paramètre.
Pour un bloc, un ordre Pl/Sql ou d'une requête Sql non factorisé.
Son objet est de déclarer des paramètres et de transmettre leur valeur.
En ce cas, chaque paramètre est déclaré avec son nom, son type et éventuellement sa taille puis valorisé par une expression de même type.

Les types possibles d'un paramètre sont :

Binaire.
Pour tous les types de données natifs tels Binary, Long Binary, Long VarBinary, Picture, Raw, VarBinary, VarRaw, etc.
Booleen.
Pour tous les types de données natifs tels Bit, Boolean, etc.
Caractere.
Pour tous les types de données natifs tels Char, Long Text, Long VarChar, Long VarChar2, Text, VarChar, VarChar2, etc.
Date.
Pour tous les types de données natifs tels Date, DateTime, Time, TimeStamp, etc.
Entier.
Pour tous les types de données natifs tels Byte, Decimal, Fixed, Int, Long, Number, Numeric, Short, etc.
Enumere.
Pour tous les types de données natifs tels Byte, Short, Int, etc.
Reel.
Pour tous les types de données natifs tels Decimal, Double, Float, Number, Numeric, etc.

La conversion de type de données est réalisée par le pilote d'Up ! Query correspondant à la connexion utilisée. Il en est de même pour l'initialisation des paramètres de sortie.

Les paramètres sont identifiés dans le source du bloc, de l'ordre Pl/Sql ou de la requête Sql par des pseudo-variables de même nom.

Pour les paramètres de type Binaire et Caractere, il est possible de soit :

Declarer une taille maximale pour toutes les valeurs possibles du paramètre.
- Pour la déclaration d'un bloc, d'un ordre Pl/Sql ou d'une requête Sql.
  Cela doit être une constante entière introduite par l'instruction TailleMaxSql.
- Pour un bloc, un ordre Pl/Sql ou une requête Sql non factorisé.
  Cela doit être une expression de type Entier introduite par l'instruction TailleMaxSql.
Si la déclaration de la taille est omise, la valeur du paramètre UpsQry.TailleMaxSql est retenue.
Declarer que le paramètre est long.
Au moyen de l'instruction EstLong.
En ce cas, au lieu d'être transmise d'un seule bloc, la valeur du paramètre l'est par tronçon. Cela est obligatoire pour les textes longs et les données multi-médias.
La caractéristique longue d'un paramètre est laissée à la discrétion de l'informaticien en fonction de la mémoire que peut allouer le programme.

Les paramètres peuvent être transmis par tableau, ce qui est déclaré au moyen de l'instruction TailleTableauParametreSql. En ce cas, la gestion des tableaux est automatisée.

Exemple


Variable

/******/


   NumeroDepartement : Entier;

   NumeroEmploye : Entier;

   Salaire : Reel;

   Description : Caractere;

   Photo : Binaire;



ConnexionSql

/**********/

 
   MaConnexionSql(Oracle, "scott/tiger");




OrdreSql

/*******/


   /* Declaration des parametres d'un ordre Sql factorise. */
   MonOrdreSql2 ConnexionSql MaConnexionSql
   
      ParametreSql (NumeroEmploye: Entier, Salaire : Reel, Description : Caractere TailleMaxSql 256, Photo : Binaire EstLong)

      SqlStatique
      
         UPDATE emp set sal=${Salaire}, desc=${Description}, photo=${Photo}

         WHERE empno=${NumeroEmploye};
      
   



Principal

/*******/

...

/* Declaration et transmission des parametre d'un ordre Sql non factorise. */

OrdreSql MonOrdreSql ConnexionSql MaConnexionSql 

   
      ParametreSql (NumeroEmploye : Entier, Salaire : Reel=-Salaire, Description : Caractere TailleMaxSql 256, Photo : Binaire EstLong)

      SqlStatique
      
         
            UPDATE emp set sal=${Salaire}, desc=${Description}, photo=${Photo}

            WHERE empno=${NumeroEmploye};
         
      
   
 ...

/* Transmission des paramètres d'un ordre Sql factorise. */

OrdreSql MonOrdreSql2 ParametreSql (NumeroEmploye, -Salaire, Description, Photo);

...

Fin Principal

Voir aussi

BlocSql pour exécuter bloc Pl/Sql. OrdreSql pour exécuter un ordre Pl/Sql. RequeteSql pour exécuter une requête Sql.

Traduction


-	-	-	-	-	-	-	-	-