35.9. Erreurs et Messages

Utilisez l'instruction RAISE pour rapporter des messages et lever des erreurs.

RAISE niveau 'format' [, variable [, ...]];

Les niveaux possibles sont DEBUG, LOG, INFO, NOTICE, WARNING et EXCEPTION. EXCEPTION l�ve une erreur (ce qui annule habituellement la transaction en cours). Les autres niveaux ne font que g�n�rer des messages aux diff�rents niveaux de priorit�. Quand les messages d'une priorit� particuli�re sont indiqu�s par le client, �crit dans les traces du serveur ou � la fois contr�l� par les variables de configuration log_min_messages et client_min_messages. Voir le Section 16.4 pour plus d'informations.

Au sein de la cha�ne de formatage, % est remplac� par la repr�sentation de la cha�ne argument optionnelle suivante. �crivez %% pour signifier un caract�re %. Notez que les arguments optionnels doivent actuellement �tre de simples variables, non des expressions et que le format doit �tre une simple cha�ne de caract�res.

Dans cet exemple, la valeur de v_job_id remplacera le % dans la cha�ne.

RAISE NOTICE 'Calling cs_create_job(%)', v_job_id;

Cet exemple interrompra la transaction avec le message d'erreur donn�.

RAISE EXCEPTION 'Nonexistent ID --> %', id_utilisateur;

RAISE EXCEPTION g�n�re toujours le m�me code SQLSTATE, P0001, quelque soit le message avec lequel il a �t� invoqu�. Il est possible de r�cup�rer cette exception avec EXCEPTION ... WHEN RAISE_EXCEPTION THEN ... mais il n'existe aucun moyen de savoir quel RAISE.