ecpg の使い方

プリプロセッサ

プリプロセッサは ecpg という名前です． インストールすると Postgres の bin/ ディレクトリに置かれます．

ライブラリ

ecpg のライブラリは libecpg.a あるいは libecpg.so という名前です． 加えてこのライブラリは Postgres サーバとの通信に libpq ライブラリを使うので， プログラムのリンクで -lecpg -lpq を指定しなければなりません．

ライブラリはいくつか「秘密の」メソッドを持っていますが， これが時として非常に役立つことがわかるはずです．

• ECPGdebug(int on, FILE *stream) は第一引数を 0 以外にして呼び出すとデバッグ用ログの記録を開始します． このデバッグログは stream に対して出力されます． SQL 文のほとんどはログにその引数と結果を残します．

  ほぼすべての SQL 文で呼び出される最も重要なメソッド ECPGdo は，詳細な文字列， すなわち入力変数すべてが挿入されたものと，Postgres サーバからの結果の両方をログに取ります． これは SQL 文の間違いを探し出す際に大変役に立ちます．

• ECPGstatus() このメソッドはデータベースに接続されている場合に TRUE を， そうでなければ FALSE を返します．

エラー処理

Postgres からのエラーを検出できるようにするには，

exec sql include sqlca;

struct sqlca
{
 char sqlcaid[8];
 long sqlabc;
 long sqlcode;
 struct
 {
  int sqlerrml;
  char sqlerrmc[70];
 } sqlerrm;
 char sqlerrp[8];
 long sqlerrd[6];
 /* 0: 空                                             */
 /* 1: 空                                             */
 /* 2: INSERT, UPDATE, DELETE 文で処理された行数      */
 /* 3: 空                                             */
 /* 4: 空                                             */
 /* 5: 空                                             */
 char sqlwarn[8];
 /* 0: 他の要素が 'W' であれば 'W' がセットされます   */
 /* 1: 'W' であれば，ホスト変数に文字列を代入する時に */
 /*    少なくともひとつの値が余分を切り落とされていま */
 /*    す                                             */
 /* 2: 空                                             */
 /* 3: 空                                             */
 /* 4: 空                                             */
 /* 5: 空                                             */
 /* 6: 空                                             */
 /* 7: 空                                             */
 char sqlext[8];
} sqlca;

直前の SQL 文でエラーが発生すると sqlca.sqlcode が 0 以外の値になります． もし sqlca.sqlcode が 0 より小さな値であれば， データベースの定義が与えられた問い合わせと合致しないといった何らかの深刻なエラーです． 0 よりも大きな値であれば， テーブルが要求した行を含んでいないなどの普通のエラーです．

sqlca.sqlerrm.sqlerrmc にはエラーを説明する文字列が含まれます． 文字列はソースファイル中の該当行番号で終わります．

発生する可能性のあるエラーのリストです：