| Symfoware Parallel Server RDBユーザーズガイド 応用プログラム開発編 |
|
目次
索引
|
応用プログラム中で、SQL文の実行結果は状態変数のSQLSTATEに通知されます。したがって、応用プログラムは、SQL文を実行するたびにSQLSTATEをチェックして、Symfoware/RDBの処理結果を確認しながら処理を進めることができます。
状態変数のSQLSTATEは、5桁の文字列型の変数です。SQL文を実行した結果、SQLSTATEに設定される値を“状態コード”と呼びます。状態コードの先頭の2桁を“例外コード”と呼び、うしろの3桁を“副例外コード”と呼びます。
表:SQLSTATE値に、SQL文の実行結果に対するコードの値を示します。
|
例外コード |
例外条件 |
副例外 |
副例外コードの意味 |
|---|---|---|---|
|
００ |
正常終了 |
０００ |
なし |
|
０１ |
警告 |
００５ |
なし |
|
０２ |
データなし |
０００ |
なし |
|
０７ |
動的SQLエラー |
０００ |
なし |
|
００１ |
USING句が被準備文内の動的パラメタと対応しない |
||
|
００２ |
USING句が被準備文内の選択リスト（相手指定）と一致しない |
||
|
００３ |
被準備文が＜カーソル指定＞である |
||
|
００４ |
動的パラメタ指定に対するUSING句が指定されていない |
||
|
００５ |
被準備文が＜カーソル指定＞でない |
||
|
００６ |
埋め込みホスト変数属性違反（制限されたデータ型属性を指定） |
||
|
００７ |
（相手指定に対する）結果USINGが指定されていない |
||
|
００８ |
SQL記述子域の個数不当 |
||
|
００９ |
SQL記述子域のインデックス不当 |
||
|
０８ |
コネクション違反 |
０００ |
コネクションの利用方法の誤り |
|
００２ |
使用中のコネクション |
||
|
００３ |
コネクションが存在しない |
||
|
００４ |
SQLサーバがSQLコネクションの接続を拒絶した |
||
|
０９ |
被トリガ動作例外 |
０００ |
なし |
|
０Ａ |
未サポート機能 |
０００ |
なし |
|
２１ |
基数違反 |
０００ |
単一行SELECT文の実行で２行以上が検索された、または、比較述語に直接含まれる副問合せの結果が２行以上検索された |
|
２２ |
データ例外 |
００１ |
文字データの右側を切り捨てた（トランケート） |
|
００２ |
ナル値を設定する標識変数の指定がない |
||
|
００３ |
扱える数値の範囲を超えた |
||
|
００５ |
代入規則違反 |
||
|
００８ |
扱える日時の範囲を超えた |
||
|
０１１ |
部分文字列の指定に誤り |
||
|
０１２ |
除数０による除算 |
||
|
０１５ |
扱える時間隔の範囲を超えた |
||
|
０１８ |
型変換を行う文字列の形式に誤り |
||
|
０１９ |
エスケープ文字の不当 |
||
|
０２４ |
正しくない文字型ホスト変数（入力ホスト変数の定義サイズ内にナル文字が存在していない） |
||
|
０２７ |
TRIM文字の指定に誤り |
||
|
７０１ |
正しくない可変長文字列（長さ部の値が０未満、または、定義サイズを超えている） |
||
|
７０２ |
DSI範囲外アクセス |
||
|
７０３ |
正しくない数値（固定小数点の符号部の値が不当） |
||
|
７０４ |
正しくない文字（各国語文字列の値が不当） |
||
|
２３ |
NOTNULL制約違反，一意性制約違反 |
０００ |
なし |
|
２４ |
カーソル状態不当 |
０００ |
なし |
|
２５ |
トランザクション状態不当 |
０００ |
なし |
|
２６ |
SQL文識別子不当 |
０００ |
なし |
|
２８ |
パスワードが不当 |
０００ |
なし |
|
２Ｅ |
コネクション名が不当 |
０００ |
なし |
|
２Ｆ |
ルーチン呼び出しエラー |
０００ |
なし |
|
３３ |
記述子名不当 |
０００ |
なし |
|
３４ |
カーソル名不当 |
０００ |
なし |
|
３７ |
SQL文構文エラー |
０００ |
なし |
|
３Ｄ |
カタログ名不当 |
０００ |
なし |
|
３Ｆ |
スキーマ名不当 |
０００ |
なし |
|
４０ |
トランザクションロールバック |
００１ |
トランザクション直列化に失敗または実時間オーバー |
|
００３ |
文終了不明（処理時間オーバーまたは強制終了） |
||
|
７０１ |
テンポラリログ領域不足 |
||
|
７０２ |
COMMIT実行時エラー |
||
|
８０１ |
定義系処理異常 |
||
|
４２ |
アクセス規則違反 |
０００ |
権限なし |
|
４４ |
ビューに対する更新でWITHCHECKOPTIONに違反 |
０００ |
なし |
|
７０ |
定量制限 |
０００ |
なし |
|
７１ |
環境不整合または運用矛盾 |
０００ |
OSの制限値を超えた |
|
００１ |
Symfoware/RDBが未起動 |
||
|
００２ |
サーバシステムが未起動 |
||
|
０１０ |
環境変数または、動作環境ファイルの形式が不当 |
||
|
０２０ |
Symfoware/RDBの制限値を超えた |
||
|
７１ |
環境不整合または運用矛盾 |
０３０ |
Symfoware/RDB環境矛盾 |
|
２１０ |
DSIが未定義またはDSIが未選択 |
||
|
２２０ |
DSIが未フォーマット |
||
|
３００ |
カーソル矛盾 |
||
|
４００ |
利用規定（注） |
||
|
４１０ |
アクセス禁止 |
||
|
５００ |
データベース未定義またはDSO未定義 |
||
|
６００ |
セションロック不可状態 |
||
|
７００ |
トランザクションの実行多重度オーバー |
||
|
７１０ |
リカバリ要状態 |
||
|
７２０ |
データベースまたは、RDBディクショナリの矛盾 |
||
|
７３０ |
定義系処理異常 |
||
|
７４０ |
分割転送での矛盾 |
||
|
８００ |
DSI自動容量拡張での異常 |
||
|
７２ |
外部記憶領域等の不足 |
０００ |
DSIの格納領域不足 |
|
０１０ |
データベーススペース不足 |
||
|
１００ |
ディレクトリ領域不足 |
||
|
７２ |
外部記憶領域等の不足 |
２００ |
作業用テーブル領域不足 |
|
７３ |
メモリの領域不足 |
１００ |
ローカルメモリのプール数が設定上限値を超えた |
|
１１０ |
ローカルメモリの不足 |
||
|
２００ |
共用メモリのプール数が設定上限値を超えた |
||
|
２１０ |
共用メモリの不足 |
||
|
３００ |
共用バッファの不足 |
||
|
７４ |
外部記憶領域への入出力異常 |
０００ |
データベーススペースの入出力異常 |
|
０１０ |
データベーススペースのアクセス権なし |
||
|
１００ |
ディレクトリ領域への入出力異常 |
||
|
１１０ |
ディレクトリ領域のアクセス権なし |
||
|
２００ |
作業用ファイルの入出力異常 |
||
|
２１０ |
作業用ファイルのアクセス権なし |
||
|
４００ |
テンポラリログ領域の入出力異常 |
||
|
４１０ |
テンポラリログ領域のアクセス権なし |
||
|
５００ |
スナップファイルへの入出力異常 |
||
|
６００ |
その他のファイルの入出力異常 |
||
|
６１０ |
アクセス権なし |
||
|
７２０ |
RDBディクショナリの入出力異常 |
||
|
７５ |
コネクション環境異常 |
０００ |
コネクション実行環境の異常 |
|
７６ |
システム環境異常 |
０００ |
システム異常 |
注）RDA接続の場合のみ指定可能です。
RDA: SERVER_SPECでRDAを指定した場合の有効性
SQL文を実行した結果により、トランザクションは開始された状態が継続される場合と、終了されて応用プログラムに復帰する場合があります。また、SQL文でエラーが発生した場合のトランザクションの扱いを、動作環境ファイルのパラメタTRAN_SPECで指定することができます。動作環境ファイルについては、“応用プログラムの動作環境のチューニング”を参照してください。
表:SQLSTATE値とトランザクションの関係に、これらの関係を示します。
|
TRAN_SPEC（注） |
SQLSTATEの例外コード |
復帰時のトランザクションの状態 |
応用プログラムでの対処 |
|---|---|---|---|
|
NONE |
００、０２ |
トランザクションは開始された状態が継続しています。 |
そのまま次の処理に進みます。 |
|
４０ |
トランザクションはロールバックされ終了しています。 |
無効となったトランザクションを再実行（リトライ）するかどうかを決定します。 |
|
|
上記以外 |
トランザクションは開始された状態が継続しています。該当のSQL文によるデータベースの更新は、実行直前の状態に戻されています。ただし、それまでに獲得されたデータベース資源のロックとカーソルの位置はそのまま保持されます。 |
エラーの原因によりトランザクションを継続させるか終了させるかを決定します。 |
|
|
TRANSACTION_ROLLBACK |
００、０２ |
トランザクションは開始された状態が継続しています。 |
そのまま次の処理に進みます。 |
|
４０ |
トランザクションはロールバックされ終了しています。 |
無効となったトランザクションを再実行（リトライ）するかどうかを決定します。 |
|
|
上記以外 |
トランザクションはロールバックされ終了しています。 |
エラーの原因を取り除いて、トランザクションの処理を最初からやり直す必要があります。このためSQL文の実行でエラーを起こさないように、応用プログラムで入力データのチェック等を行います。 |
|
目次
索引
|