44.5. 錯誤和通知消息字段

本節描述那些可能出現在 ErrorResponse 和 NoticeResponse 消息裡的字段。 每個字段類型有一個單字節標識記號。請注意,任意給定的字段類型在每條信息裡都應該最多出現一次。

S

嚴重性:該字段的內容是ERRORFATAL, 或者 PANIC(在一個錯誤消息裡),或者 WARNINGNOTICEDEBUGINFOLOG (在一條通知消息裡),或者是這些的某種本地化翻譯的字串。總是會出現。

C

代碼:錯誤的 SQLSTATE 代碼(參閱 Appendix A)。 不能本地化。總是出現。

M

消息:人類可讀的錯誤信息的主體。這些信息應該準確並且簡潔(通常是一行)。總是出現。

D

細節:一個可選的從屬錯誤信息,承載有關問題的更多錯誤消息。 可以是多行。

H

提示:一個可選的有關如何處理問題的建議。它和細節不同的地方是它提出了建議(可能並不合適)而不僅僅是事實。可以是多行。

P

位置:這個字段值是一個十進制 ASCII 整數,表示一個錯誤遊標的位置, 它是一個指向原始查詢字串的索引。第一個字符的索引是 1,位置是以字符計算而非字節計算的。

W

哪裡:一個指示錯誤發生的環境的指示器。目前,這個參數包含一個活躍的 PL 函數的調用堆棧的追溯。這個追溯每條記錄一行,最新的在最上面。

F

文件:所報告錯誤在源代碼中的位置。

L

行:報告的錯誤所在的源代碼的位置的行號。

R

過程:報告錯誤的過程在源代碼中的名字。

客戶端負責對顯示信息進行格式化輸出以符合需要; 特別是它應該根據需要斷開長的行。在錯誤信息字段裡出現的換行符應該當作一個分段的符號,而不是換行。