FirebirdSQL logo
 Fonctions Window (analytique)Gestion des transactions 

SQLSTATE

Disponible en

PSQL

Syntaxe
SQLSTATE
type de résultat de retour

CHAR(5)

Dans les blocs de gestion d’erreur WHEN …​ DO variable de contexte SQLSTATE variable contient 5 caractères du code d’état compatible SQL-2003 — passé par la déclaration causant l’erreur.En dehors des gestionnaires d’erreurs, SQLSTATE est toujours '00000' et en dehors de PSQL, il n’existe pas du tout.

Note

  • SQLSTATE est destiné à remplacer SQLCODE. Ce dernier est maintenant obsolète et sera supprimé dans les futures versions de Firebird ;

  • Tout code SQLSTATE se compose de deux caractères de classe et de trois caractères de sous-classe. Les classes 00 (exécution réussie), 01 (avertissement) et 02 (pas de données) représentent les conditions d’achèvement. Chaque code d’état en dehors de ces classes est une exception. Comme les classes 00, 01 et 02 ne provoquent pas d’erreur, elles ne seront jamais détectées dans la variable SQLSTATE.
Example 1. Utilisation d’une variable SQLSTATE
WHEN ANY DO
BEGIN
  MSG = CASE SQLSTATE
          WHEN '22003' THEN
            'Le nombre est hors de portée !'
          WHEN '22012' THEN
            'Division par zéro !'
          WHEN '23000' THEN
            'Violation du control d''intégrité !'
          ELSE 'Il n''y a pas d''erreurs ! SQLSTATE = ' || SQLSTATE;
        END;
  EXCEPTION EX_CUSTOM MSG;
END
Voir aussi :

[fblangref-contextvars-gdscode], [fblangref-contextvars-sqlcode], Codes d’erreur SQLSTATE.

UPDATING

Disponible en

PSQL

Syntaxe
UPDATING
type de résultat de retour

BOOLEAN

La variable contextuelle UPDATING n’est disponible que dans le code des triggers de table. Elle est utilisée dans les triggers pour plusieurs types d’événements et indique que le trigger a été déclenché lorsque l’opération UPDATE a été effectuée.

Example 1. Utilisation d’une variable UPDATING
...
IF (INSERTING OR UPDATING) THEN
BEGIN
  IF (NEW.SERIAL_NUM IS NULL) THEN
    NEW.SERIAL_NUM = GEN_ID (GEN_SERIALS, 1);
END
...
Voir aussi :

[fblangref-contextvars-inserting], [fblangref-contextvars-deleting].