Gestion des erreurs et diagnostics
La zone de communication SQL
La SQLCA (SQL Communication Area) est une structure de données mise à jour par chaque instruction SQL exécutable. Elle est incluse dans la WORKING-STORAGE SECTION avec :
EXEC SQL INCLUDE SQLCA END-EXEC.
Ses principaux champs sont :
| Champ | Description |
|---|---|
SQLCODE |
0 en cas de succès, une valeur positive pour les avertissements et « aucun enregistrement », une valeur négative pour les erreurs |
SQLSTATE |
le code SQLSTATE à 5 caractères de la norme SQL |
SQLERRML, SQLERRMC |
longueur et texte du message d’erreur |
SQLERRD(3) |
nombre de lignes traitées |
SQLWARN0 … |
indicateurs d’avertissement |
Recopier la structure réelle de copy/SQLCA.cpy.
SQLCODE et SQLSTATE
Lorsque la base de données signale une erreur, GixSQL affecte à SQLCODE le code d’erreur de la base de données s’il existe (par exemple -942 pour l’erreur Oracle ORA-00942) et à SQLSTATE le SQLSTATE correspondant. Lorsque l’erreur provient de GixSQL lui-même, SQLCODE est l’un des codes négatifs listés dans Codes d’erreur.
Correspondance de SQLCODE pour chaque pilote (PostgreSQL n’a pas de codes numériques).
La condition « aucun enregistrement »
Lorsqu’un SELECT INTO ne trouve aucune ligne, ou qu’un FETCH atteint la fin d’un curseur, SQLSTATE vaut 02000 et SQLCODE vaut 100. Oracle utilise 1403 au lieu de 100 ; pour obtenir cette valeur :
- précompilez avec
--no-rec-code 1403, afin queWHENEVER NOT FOUNDteste cette valeur ; - exécutez avec
GIXSQL_NOREC_CODE=1403, afin que la bibliothèque d’exécution l’utilise.
Les deux réglages doivent être cohérents.
WHENEVER
L’instruction WHENEVER demande au précompilateur de générer un test après chacune des instructions SQL suivantes, jusqu’au prochain WHENEVER pour la même condition :
EXEC SQL WHENEVER SQLERROR GO TO SQL-ERROR END-EXEC.
EXEC SQL WHENEVER NOT FOUND GO TO END-OF-FETCH END-EXEC.
EXEC SQL WHENEVER SQLWARNING CONTINUE END-EXEC.
Conditions :
SQLERROR-
SQLCODEest négatif ; NOT FOUND- la condition « aucun enregistrement » ;
SQLWARNING- un avertissement est positionné.
Actions :
CONTINUE- pas de test (par défaut) ;
GO TO label,GOTO label-
saut au paragraphe ou à la section
label; PERFORM label-
exécution (PERFORM) du paragraphe ou de la section
label.
WHENEVER est une déclaration : elle s’applique aux instructions qui la suivent dans le source, et non dans l’ordre d’exécution.
Journalisation
Lorsqu’une erreur n’est pas claire d’après la SQLCA, le journal de la bibliothèque d’exécution donne le détail de chaque appel, y compris les instructions SQL envoyées à la base de données (voir Journalisation).