SQLSTATE マッピング

このトピックでは、ODBC 2.x と ODBC 3.x の SQLSTATE 値について説明します。 ODBC 3.x SQLSTATE 値の詳細については、「付録 A: ODBC エラー コード」を参照してください。

ODBC 3.x では、S1xxx ではなく HYxxx SQLSTATE が返され、S00XX ではなく 42Sxx SQLSTATE が返されます。 これは、Open Group と ISO 標準に合わせて行われました。 多くの場合、標準では複数の SQLSTATE の解釈が再定義されているため、マッピングは 1 対 1 ではありません。

ODBC 2.x アプリケーションを ODBC 3.x アプリケーションにアップグレードする場合、ODBC 2.x SQLSTATE ではなく ODBC 3.x SQLSTATE を想定するようにアプリケーションを変更する必要があります。 次の表に、各 ODBC 2.x SQLSTATE がマップされている ODBC 3.x SQLSTATE を示します。

SQL_ATTR_ODBC_VERSION 環境属性が SQL_OV_ODBC2 に設定されている場合、SQLGetDiagField または SQLGetDiagRec が呼び出されると、ドライバーは ODBC 3.x SQLSTATE ではなく ODBC 2.x SQLSTATE をポストします。 特定のマッピングは、次の表の列 1 の ODBC 2.x SQLSTATE を、列 2 の ODBC 3.x SQLSTATE に対応する点に注意することで決定できます。

ODBC 2.x SQLSTATE	ODBC 3.x SQLSTATE	Comments
01S03	01001
01S04	01001
22003	HY019
22008	22007
22005	22018
24000	07005
37000	42000
70100	HY018
S0001	42S01
S0002	42S02
S0011	42S11
S0012	42S12
S0021	42S21
S0022	42S22
S0023	42S23
S1000	HY000
S1001	HY001
S1002	07009	基になる関数が SQLBindCol、SQLColAttribute、SQLExtendedFetch、SQLFetch、SQLFetchScroll、または SQLGetData の場合、ODBC 2.x SQLSTATE S1002 は ODBC 3.x SQLSTATE 07009 にマップされます。
S1003	HY003
S1004	HY004
S1008	HY008
S1009	HY009	無効な null ポインターに使用する場合に返されます。
S1009	HY024	無効な属性値に対して返されます。
S1009	HY092	同時実行が読み取り専用である場合、SQLSetPos の呼び出しによるデータの更新または削除、または SQLBulkOperations の呼び出しによるデータの追加、更新、または削除の際に返されます。
S1010	HY007 HY010	SQLPrepare、SQLExecDirect、または StatementHandle のカタログ関数を呼び出す前に SQLDescribeCol が呼び出されると、SQLSTATE S1010 は SQLSTATE HY007 にマップされます。 それ以外の場合、SQLSTATE S1010 は SQLSTATE HY010 にマップされます。
S1011	HY011
S1012	HY012
S1090	HY090
S1091	HY091
S1092	HY092
S1093	07009	基になる関数が SQLBindParameter または SQLDescribeParam の場合、ODBC 3.x SQLSTATE 07009 は ODBC 2.x SQLSTATE S1093 にマップされます。
S1096	HY096
S1097	HY097
S1098	HY098
S1099	HY099
S1100	HY100
S1101	HY101
S1103	HY103
S1104	HY104
S1105	HY105
S1106	HY106
S1107	HY107
S1108	HY108
S1109	HY109
S1110	HY110
S1111	HY111
S1C00	HYC00
S1T00	HYT00

Note

ODBC 3.x SQLSTATE 07008 は、ODBC 2.x SQLSTATE S1000 にマップされます。