Documentation PostgreSQL 8.3.23 > Interfaces client > ECPG - SQL embarqué dans du C > Utiliser les zones de descripteur SQL | |
Mode de compatibilité Informix | Gestion des erreurs |
Une zone de descripteur SQL est une méthode de traitement du résultat d'un SELECT ou d'un FETCH plus sophistiquée. La zone de descripteur SQL groupe les données d'une ligne avec les éléments de métadonnées en une seule structure de données. Les métadonnées sont particulièrement utiles lors de l'exécution d'instructions SQL dynamiques pour lesquelles la nature des colonnes de résultats n'est pas forcément connue à l'avance.
Une zone de descripteur SQL est constituée d'un en-tête, qui contient des informations sur le descripteur complet, et un ou plusieurs éléments de zones de descripteur, qui basiquement décrivent chacun une colonne de la ligne de résultat.
Avant d'utiliser une zone de descripteur SQL, il est nécessaire de l'allouer :
EXEC SQL ALLOCATE DESCRIPTOR identifiant;
L'identifiant sert de « nom de variable » à la zone du descripteur.
La portée du descripteur alloué est QUOI ?
Lorsque le descripteur n'est plus utilisé, il est recommandé de le désallouer :
EXEC SQL DEALLOCATE DESCRIPTOR identifiant;
Pour utiliser une zone de descripteur, il suffit de le préciser comme cible de stockage dans une clause INTO à la place de la liste des variables hôtes :
EXEC SQL FETCH NEXT FROM moncurseur INTO DESCRIPTOR mondesc;
Il reste à répondre à la question de la récupération des données de la zone descripteur. Celle-ci peut être considérée comme une structure contenant des champs nommés. Pour récupérer la valeur d'un champ à partir de l'en-tête et la stocker dans une variable hôte, on utilise la commande suivante :
EXEC SQL GET DESCRIPTOR nom :varhote = champ;
Actuellement, il n'existe qu'un seul champ d'en-tête défini : COUNT, qui indique le nombre d'éléments dans la zone de descripteur (c'est-à-dire le nombre de colonnes contenues dans le résultat). La variable hôte doit être de type entier. Pour récupérer un champ à partir de l'élément de la zone du descripteur, on utilise la commande suivante :
EXEC SQL GET DESCRIPTOR nom VALUE numero :varhote = champ;
numero peut être une constante entière ou une variable hôte contenant un entier. Les champs possibles sont :
le nombre de lignes dans l'ensemble du résultat ;
l'élément de données en cours (de fait, le type de données de ce champ dépend de la requête) ;
?
non implanté ;
l'indicateur (de valeur NULL ou de troncature de la valeur) ;
non implanté ;
la longueur de la donnée en caractères ;
le nom de la colonne ;
non implanté ;
la longueur en octets de la représentation en caractères de la donnée ;
la précision (pour le type numeric) ;
la longueur de la donnée en caractères ;
la longueur en octets de la représentation en caractères de la donnée ;
l'échelle (pour le type numeric) ;
le code numérique du type de données de la colonne ;