付録 A. PostgreSQL エラーコード

PostgreSQLサーバによって発行されるメッセージはすべて、標準SQLにおける"SQLSTATE"コードの記述方法に従った、5文字のエラーコードが割り当てられています。 どのようなエラー条件が発生したかを把握しなければならないアプリケーションは、通常テキスト形式のエラーメッセージを確認するのではなく、このエラーコードを検査すべきです。 このエラーコードは、PostgreSQL リリースの違いによって変更することはあまりありません。また、エラーメッセージの各国言語化による変更にも影響されません。 PostgreSQLで発行されるエラーコードの幾つか(全部ではありません)は、標準SQLで定義されていることに注意して下さい。 標準SQLで定義されていない追加のエラーコードは、独自のものであったり他のデータベースから取り入れたものです。

標準に従い、エラーコードの最初の2文字はエラーのクラスを表し、残り3文字がそのクラス内の特定条件を表します。 従って、特定のエラーコードを検知するアプリケーションは、エラークラスから何をすべきかを推定することさえもできます。

表A-1は、PostgreSQL 8.0.4で定義されたエラーコードをすべて一覧で示しています。 (標準SQLでは定義されているが、現在実際に使用されていないものもあります。) このエラークラスはまた、 各エラークラスに対し、残りの3文字が000となる"標準"エラーコードが存在することを示しています。 あるクラスの範囲内で発生したが、より特定のコードが割り当てられていないエラー条件のためだけに、このコードが使用されます。

それぞれのエラーに対するPL/pgSQLの状態は、空白の代わりにアンダースコアとなっていますが、 表に示してある表現と同一のものです。例えば、コード22012はDIVISION BY ZEROですが状態名はDIVISION_BY_ZEROです。状態名は大文字でも小文字でも記述可能です。（PL/pgSQLは、エラーの場合と異なり、警告の場合にはその状態名を認識しません。これらはクラス00と01と02です。）