ResultatSql

Instruction attribut. Définition des résultats d'un source Structured Query Language (SQL) de sélection.

Syntaxe

ResultatSql ( ListeDeResultatsSqlDeclares ) TailleTableauxResultatsSqlDeclares

ResultatSql ( ListeDeResultatsSqlRecus ) TailleTableauxResultatsSqlRecus

Description

L'instruction ResultatSql permet déclarer ou transmettre les résultats d'une requête Structured Query Language (SQL).

Un paramètre de sortie d'un bloc ou d'un ordre Pl/Sql n'est pas considéré comme un résultat. Il doit être déclaré au moyen de l'instruction ParametreSql.

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

Pour la déclaration d'une requête Sql factorisée.
Son objet est uniquement de déclarer des résulats formels.
En ce cas, chaque résultat est déclaré avec son nom, son type et éventuellement sa taille.
Pour l'usage d'une requête Sql factorisée.
Son objet est uniquement d'associer des résultats effectifs aux résultats formels.
Pour une requête Sql non factorisée.
Son objet est de déclarer des résultats formels et de leur associer des résultats effectifs.
En ce cas, chaque résultat est déclaré avec son nom, son type et éventuellement sa taille.

Les types possibles d'un résultat 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.

Les résultats sont identifiés dans le source de la requête Pl/Sql par des pseudo-variables de même nom qui sont affectées avec l'opérateur := .

Pour les résultats de type Binaire et Caractere, il est possible de soit :

Declarer une taille maximale pour toutes les valeurs possibles du résultat.
- Pour la déclaration d'une requête Sql.
  Cela doit être une constante entière introduite par l'instruction TailleMaxSql.
- Pour une requête Sql non factorisée.
  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 résultat est long.
Au moyen de l'instruction EstLong.
En ce cas, au lieu d'être reçue d'un seule bloc, la valeur du résultat 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 résultat est laissée à la discrétion de l'informaticien en fonction de la mémoire que peut allouer le programme.

Les résultats peuvent être reçus par tableau, ce qui est déclaré au moyen de l'instruction TailleTableauResultatSql. En ce cas, la gestion des tableaux est automatisée.

Exemple


Variable

/******/


   NomEmploye2 : Nul Ou Caractere;

   DateEmbauche2 : Nul Ou Date;

   NumeroEmploye2 : Nul Ou Entier;

   Salaire2 : Nul Ou Reel;

   NumeroDepartement : Entier;



ConnexionSql

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

 
   MaConnexionSql(Oracle, "scott/tiger");




OrdreSql

/*******/


/* Requete Sql factorisée. Les résultats formels sont déclarés explicitements. Les tableaux sont utilisés. */

   MaRequeteSql2 ConnexionSql MaConnexionSql
   
      ResultatSql (NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, NumeroEmploye : Nul Ou Entier, Salaire : Nul Ou Reel)

      TailleTableauResultatSql 5

      ParametreSql (NumeroDepartement : Entier)

      SqlStatique
      
         SELECT ename:=${NomEmploye}, hiredate:=${DateEmbauche}, empno:=${NumeroEmploye}, sal:=${Salaire} 

         FROM emp 

         WHERE deptno=${NumeroDepartement}; 
      
   



Principal

/*******/

...

/* Requete Sql non factorisée. Les résultats formels et effectifs sont déclarés explicitement. */

RequeteSql MaRequeteSql ConnexionSql MaConnexionSql 

   ResultatSql (NomEmploye : Nul Ou Caractere TailleMaxSql 20, DateEmbauche : Nul Ou Date, NumeroEmploye : Nul Ou Entier, Salaire : Nul Ou Reel)
 
   ParametreSql (NumeroDepartement : Entier)

   SqlStatique 
   
      SELECT ename:=${NomEmploye}, hiredate:=${DateEmbauche}, empno:=${NumeroEmploye}, sal:=${Salaire} 

      FROM emp 

      WHERE deptno=${NumeroDepartement};
   
   Ecran.Ecrire(NomEmploye+" "+Caractere(DateEmbauche)+" "+Caractere(NumeroEmploye)+" "+Caractere(Salaire));

Fin RequeteSql

...

/* Usage d'une requete Sql factorisée. Les résultats effectifs sont des variables gloables. */

RequeteSql MaRequeteSql2

   ResultatSql (NomEmploye2 TailleMaxSql 20, DateEmbauche2, NumeroEmploye2, Salaire2)
 
   ParametreSql (NumeroDepartement)

   Ecran.Ecrire(NomEmploye+" "+Caractere(DateEmbauche)+" "+Caractere(NumeroEmploye)+" "+Caractere(Salaire));

Fin RequeteSql

...

Fin Principal

Voir aussi

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

Traduction


-	-	-	-	-	-	-	-	-