ODBC エラー報告書作成のための SQLSTATE

Db2® ODBC は SQLSTATE と呼ばれるコードの標準セットを提供します。これは、異なるデータベース・サーバーが、しばしば別の診断メッセージ・コードを持つためです。 特定のガイドラインが、アプリケーション内の SQLSTATE の使用に適用されます。

SQLSTATE は、X/Open SQL CAE 仕様で定義されています。 これによって、さまざまなデータベース・サーバー間で一貫したメッセージ処理を行うことができます。

SQLSTATE は、5 文字 (バイト) の ccsss 形式 の英数字ストリングです (ここで、cc はクラス を、sss はサブクラスを示しています)。 すべての SQLSTATE は、以下のいずれかのクラスを使用します。
'01'
警告。
'S1'
Db2 ODBC ドライバー ODBC 2.0 アプリケーション用に生成。
'HY'
Db2 ODBC ドライバーが ODBC 3.0 アプリケーション用に生成
重要: ODBC 3.0 では、「HY」クラスは「S1」クラスに対応します。「HY」は、ODBC/CLI 実装に関する X/Open の予約クラスです。このクラスは、X/Open および ISO CLI の規格に従うために、 ODBC 3.0 の 'S1' クラスを置き換えるものです。

エラー条件によっては、Db2 ODBC は、「Microsoft Open Database Connectivity (ODBC)」にリストされている状態とは異なる SQLSTATE を戻します。 この矛盾は、Db2 ODBC が X/Open SQL CAE および SQL92 仕様に従った結果、生じたものです。

Db2 ODBC SQLSTATE には、データベース・サーバーによって戻される 追加の IBM® 定義の SQLSTATE と、X/Open 仕様では定義されていない 条件に関する Db2 ODBC 定義の SQLSTATE の両方が含まれています。 このため、最大限の診断情報が戻されます。

アプリケーション内で SQLSTATE を使用する場合、以下のガイドラインに従ってください。
  • SQLGetDiagRec() を呼び出す前に、常に関数の戻りコード を調べて診断情報があるかどうかを判別する。
  • ネイティブのエラー・コードよりも SQLSTATE の方を使用する。
  • アプリケーションの移植性を高めるために、X/Open 仕様が定義する Db2 ODBC SQLSTATE の一部分 だけに依存関係のあるアプリケーションを構築して、それ以外のものは単なる参考情報として戻す。(依存性とは、 特定の SQLSTATE に基づいてロジック・フローを決定するアプリケーションのことです。)
    ヒント: SQLSTATE のクラス (最初の 2 文字) に依存関係のあるアプリケーションを 構築するように考慮してください。
  • 診断情報を最大限にする場合は、SQLSTATE とともにテキスト・メッセージを戻す (該当する場合には、 テキスト・メッセージに IBM 定義の SQLSTATE も含まれます)。 また、エラーを戻した関数の名前をアプリケーションが印刷することも有効です。