SQLSTATE のマッピング

ODBC 3.0 ドライバーでは、SQLGetDiagRec() または SQLError() を呼び出した場合、いくつかの SQLSTATE は異なっています。 すべての「使用すべきでない」関数は、環境属性の設定に関係なく、 引き続き ODBC 2.0 SQLSTATE を戻します。

次のリストには、影響のある SQLSTATE が示されています。
  • HYxxx SQLSTATE は、S1xxx SQLSTATE に 置き換わります。
  • 42Sxx SQLSTATE は、S00xx SQLSTATE に 置き換わります。
  • いくつかの SQLSTATE が再定義されました。
ODBC 2.0 アプリケーションを ODBC 3.0 にアップグレードする 場合、ODBC 3.0 の SQLSTATE を前提とするようにアプリケーションを変更する必要があり ます。ODBC 3.0 アプリケーションでは、環境属性 SQL_ATTR_ODBC_VERSION = SQL_OV_ODBC2 を 設定して、Db2® ODBC 3.0 ドライバーが ODBC 2.0 の SQLSTATE を戻すようにすることができます。
次の表は、ODBC 2.0 と ODBC 3.0 の SQLSTATE のマッピングを示しています。
表 1. ODBC 2.0 と ODBC 3.0 の SQLSTATE のマッピング
ODBC 2.0 の SQLSTATE ODBC 3.0 の SQLSTATE
22003 HY019
22007 22008
22005 22018
37000 42000
S0001 42S01
S0002 42S02
S0011 42S11
S0012 42S12
S0021 42S21
S0022 42S22
S0023 42S23
S1000 HY000
S1001 HY001
S1002 HY002
S1003 HY003
S1004 HY004
S1009 HY009 または HY024

NULL ポインターの使用が無効の場合、S1009 は、 HY009 にマップされます。 属性値が無効の場合、S1009 は、HY024 に マップされます。

S1010 HY010
S1011 HY011
S1012 HY012
S1013 HY013
S1014 HY014
S1015 HY015
S1019 HY019
S1090 HY090
S1091 HY091
S1092 HY092
S1093 HY093
S1096 HY096
S1097 HY097
S1098 HY098
S1099 HY099
S1100 HY100
S1101 HY101
S1103 HY103
S1104 HY104
S1105 HY105
S1106 HY106
S1107 HY107
S1110 HY110
S1501 HY501
S1506 HY506
S1C00 HYC00