44.5. Champs des messages d'erreur et d'avertissement

Cette section d�crit les champs qui peuvent appara�tre dans les messages ErrorResponse et NoticeResponse. Chaque type de champ a un motif d'identification cod� sur un octet. Tout type de champ donn� doit appara�tre au plus une fois par message.

S

Gravit� (Severity) : le contenu du champ peut �tre ERROR, FATAL ou PANIC dans un message d'erreur, WARNING, NOTICE, DEBUG, INFO ou LOG dans un message d'avertissement, ou la traduction r�gionale de l'un d'eux. Toujours pr�sent.

C

Code : code SQLSTATE de l'erreur (voir Annexe A). Non internationalisable. Toujours pr�sent.

M

Message : premier message d'erreur, en clair. Doit �tre court et pr�cis (typiquement une ligne). Toujours pr�sent.

D

D�tail : deuxi�me message d'erreur, optionnel, apportant des informations suppl�mentaires sur le probl�me. Peut �tre sur plusieurs lignes.

H

Astuce (Hint) : suggestion optionnelle de r�solution du probl�me. Diff�rent de D�tail parce qu'il offre un conseil (potentiellement inappropri�) plut�t que des faits r�els. Peut �tre sur plusieurs lignes.

P

Position : valeur du champ, entier d�cimal ASCII indiquant un curseur sur la position de l'erreur dans la cha�ne de requ�te originale. Le premier caract�re a l'index 1. Les positions sont mesur�es en caract�res, non pas en octets.

W

O� (Where) : indication du contexte dans lequel l'erreur est survenue. Inclut, actuellement, une trace de la pile des appels des fonctions PL actives. Cette trace comprend une entr�e par ligne, la plus r�cente en premier.

F

Fichier (File) : nom du fichier de code source comportant l'erreur.

L

Ligne (Line) : num�ro de ligne dans le fichier de code source comportant l'erreur.

R

Routine : nom de la routine dans le code source comportant l'erreur.

Le client est responsable du formatage adapt� � ses besoins des informations affich�es ; en particulier par l'ajout de retours chariots sur les lignes longues, si cela s'av�rait n�cessaire. Les caract�res de retour chariot apparaissant dans les champs de messages d'erreur devraient �tre trait�s comme des changements de paragraphes, non comme des changements de lignes.