CHAPTER 4: コマンドリファレンス

EXEC SQL BEGIN DECLARE SECTION;

意味はありません。

1. ホスト言語の変数宣言の規則に従えば、宣言セクションはどの位置に記述しても構いません。

2. 1つのプログラムで複数の宣言セクションを記述が可能ですが、 複数の宣言セクションを記述する場合は、宣言セクションをとおして 変数名は一意である必要があります。

3. 宣言セクションは、SQL プリコンパイラステートメントを含むファイル内で グローバル(global)として宣言することを推奨します。

4. 各BEGIN DECLARE SECTIONには、対応するEND DECLARE SECTIONがなければ なりません。

EXEC SQL BEGIN DECLARE SECTION;
   int i;
   short j;
   float f;
   char str [10];
EXEC SQL END DECLARE SECTION;

EXEC SQL :var = [CALL] expr;

各種集計関数とオペレーターはこのステートメント使って呼び出すことはできません。

EXEC SQL CANCEL TRANSACTION;

意味はありません。

1. CANCEL TRANSACTION は、すべてのデータベース上にわたる すべてのトランザクションをロールバックします。

2. 検索ループ内で用いられた場合、 カレントレコードは有効ではありません。 ただし、FETCHステートメントは、 適切な次のレコードを返します。

EXEC SQL CLOSE cursor_name;

where:

EXEC SQL CLOSE_TABLE [table {, table}];

意味はありません。

CLOSE_TABLEコマンドにテーブル名を指定しないと、 すべてのテーブルがクローズされます。

次のコマンドは、すべてのオープンされたテーブルのクローズします。

   EXEC SQL CLOSE_TABLE;

次のコマンドは、指定したloans およびpersonnelテーブルの クローズします。

   EXEC SQL CLOSE_TABLE loans, personnel;

EXEC SQL COMMIT TRANSACTION;

意味はありません。

EXEC SQL DATABASE IS database;

意味はありません。

1. データベース名は、フルパスで指定することができます。 この場合、引用符で囲む必要があります。

2. DATABASE ISは、PSM ルーチンおよびトリガでは使用することができません。

EXEC SQL DECLARE cursor_name CURSOR

   FOR SELECT [ |DISTINCT |] [attr {, attr}]
                |UNIQUE   |

   FROM table {, table}

   [where_clause]

   [sort_clause]

意味はありません。

1. カーソルをオープンして使用するためには最初に宣言しなくてはなりません。 カーソルを宣言した後に使用する前にはオープンする必要があります。

2. 1つのプログラムでは、カーソルは1度だけ宣言できます。

3. 検索した行を読むだけでなく修正したい場合、 カーソルはFOR UPDATEまたはFOR DEFERREDで宣言しなくてはなりません。

4. 検索した行のソートはSORTオプションを利用することで可能です。

   EXEC SQL DECLARE c1 CURSOR FOR
      SELECT FROM personnel, loans
      WHERE personnel.name='Jones'
         AND personnel.name = loans.name;

上記のコマンドはc1というカーソルを宣言します。 このカーソルは、テーブルpersonnel と loans から検索した行に対して処理を行います。 レコード検索の条件は、WHERE句に定義します。 このコンテキストは、personnelテーブルの nameアトリビュートがJonesと等しく、 かつ、personnelテーブルのnameアトリビュート とloansテーブルnameアトリビュートが等しい レコードになります。

1. カーソルをWHERE 句に指定しない限り、WHERE 句を満たす行すべてが 削除されます。 カーソルを指定した場合は、カレント行だけが削除されます。 カレント行がない場合は、レコードは削除されず、 適切なSQLCODEが戻されます。

2. 変数 SQLCNT は、削除レコード数をチェックするために使用することができます。

次のコマンドはアトリビュートamountの値が 50 未満であるすべての レコードをloansテーブルから削除します。

   EXEC SQL DELETE FROM loans WHERE amount < 50;

次のコマンドは'c'という名前のカーソルと関連付けたコンテキストから カレントレコードを削除します。 カレントレコードがない場合、何も削除しません。

   EXEC SQL DELETE FROM loans WHERE CURRENT OF c;

EXEC SQL END DECLARE SECTION;

意味はありません。

各BEGIN DECLARE SECTIONには、対応するEND DECLARE SECTIONがなければ なりません。

EXEC SQL EXIT;

意味はありません。

1. プログラムを終了する前は常にEXITを実行する必要があります。

2. EXITを実行した以降においては INITを含む、 SQL 操作をおこなうことはできません。

3. EXITは、PSMルーチンとトリガーの中では使用することはできません。

EXEC SQL FETCH [|NEXT |[AGAIN][FROM]] cursor_name
                |PRIOR|

     attr {, attr} INTO variable {, variable};

コンテキストの次の行がアクセスできない場合(ロックされている場合)、 その行はカレント行とされますが、そのアトリビュート値はプログラム変数に 読み込まれません。FETCH_AGAINコマンドを使用することで、 これらのアトリビュートの再読み込みを試みることができます

次のコマンドは、c1という名前のカーソルに関連付けられたコンテキストで 次に処理可能なレコードをカレントレコードとします。 アトリビュートname と credit_limitの値を取得し、 プログラム変数:name と:crelimにそれぞれの値を 格納します。

   EXEC SQL FETCH c1
      name, credit_limit
      INTO :name, :crelim;

EXEC SQL FETCH_AGAIN cursor_name attr {, attr}
     INTO variable {, variable};

FETCH_AGAINは、カレントレコードのステータスに影響しません。 FETCH_AGAINの実行をしても、カーソルの移動はせず、 カレントレコードのままです。

次のコマンドは、 c1という名前のカーソルに関連付けられたコンテキストで カレントレコードからアトリビュートname と credit_limitの値を取得し、プログラム変数:name と:crelimにそれぞれの値を格納することを試みます。

   EXEC SQL FETCH_AGAIN c1
      name, credit_limit
      INTO :name, :crelim;

EXEC SQL INCLUDE SQLCA

意味はありません。

INCLUDE SQLCAステートメントは、プログラムの最初の プリコンパイラステートメントとして記述しなければなりません。

EXEC SQL INIT;

1. INITは、プログラム中で使用する 最初に実行可能なEmpress プリコンパイラコマンドで なければなりません。

2. INITは、プログラム実行中に何回か呼び出される可能性がありますが 後のINITの呼び出しはEXITコールをその前に 呼び出す必要があります。

3. INITは、 PSM ルーチンおよびトリガー中では使用することはできません。

EXEC SQL INSERT INTO table
     (attr {, attr}) VALUES (value {, value});

|program variable|
|constant        |

1. テーブル中の属性のうち、INSERTコマンドのアトリビュートリストに 指定していないものについては、NULL値がその値として挿入されます。

2. 実行時にNULLを挿入するために制御変数を使用することができます。 :variable:control_variableと指定した場合には、 実行時にcontrol_variableの値が評価され、 0 より小さいならば NULLが挿入され、 その他の値ならば変数に格納されている値を挿入します。

次のコマンドは、アトリビュートnameにMosca、 numberに10、 credit_limitに1500の値を設定し、 personnelテーブルに新しい行を挿入します。

   EXEC SQL INSERT INTO personnel
      (name, number, credit_limit)
       VALUES ("Mosca", 10, 1500);

EXEC SQL OPEN cursor_name;

1. カーソルをオープンした場合、その宣言に定義したSELECTステートメントが 初期化されます。

2. 1つのプログラムでは、カーソルは何度でもオープンできます。 ただし、カーソルを再オープンする場合は、カーソルがクローズされていなければ なりません。

実行する各コマンドについて、プリコンパイラは必要なテーブルがすべてオープン されているかどうかをチェックします。 オープンされている場合は、正しいモード(read, update または dirty read) でオープンされています。テーブルがオープンされない場合は、 SQLコマンドに対応したモードでオープンされます。

次のコマンドは、読み込み処理のためにテーブルloansをオープンし、 更新処理のためにpersonnelテーブルをオープンします。

   EXEC SQL OPEN_TABLE
      loans FOR READ,
      personnel FOR UPDATE;

EXEC SQL SELECT attr {, attr} FROM table {, table}
   INTO variable {, variable}
   [where_clause];

1. SELECT は、 指定したテーブルまたはビューから1行のデータを検索します。 WHERE句が使用された場合、 WHERE句の条件を満たす最初のレコードが選択されます。 WHERE句の条件を満たす全てのレコードにアクセスしたい場合は、 カーソルを使用する必要があります。 (OPEN CURSORコマンドを参照してください。)

2. 検索において、最初に選択されたアトリビュート値は、 最初に指定したプログラム変数の値として格納されます。 2番目に選択されたアトリビュート値は、2番目に指定したプログラム変数の 値として格納され、それ以降も同様に処理されます。

3. ジョインを含むSELECTにおいては、 ジョインを形成する右側のアトリビュートに対してプログラム変数を 指定することはできません。

次のコマンドは、personnelテーブルからアトリビュート name と dateの値を検索します。 WHERE句の条件に一致する最初のレコードから値が取得され、 こららの値はプログラム変数の:var1 と :var2 に格納されます。

   EXEC SQL SELECT name, date FROM personnel
      INTO :var1, :var2 WHERE name='Jones';

トランザクションは、検索ループ中から開始することが可能です。

EXEC SQL UPDATE table SET attr = value {, attr = value}

     |where_clause                |;
     |WHERE CURRENT OF cursor_name|

1. WHERE句にカーソルが指定されない場合、 WHERE句の条件を満たす全ての行は更新されます。 カーソルが使用されている場合は、カレント行のみ更新されます。

2. 値として、定数、ユーザー変数または アトリビュートの値を削除するためのNULLが入力可能です。

3. 値とアトリビュートは同じデータタイプである必要があり、 同じではない場合、プリコンパイラはエラーを返します。

4. 制御変数を使用して、実行時にNULLを挿入することができます。 値が:variable : ctrlである場合、 実行時に ctrl がテストされます。 この値が 0 より大きいかどうかによって、 NULL 値あるいは変数の値が挿入されます。 （詳細については「制御変数」を参照してください。）

5. 変数 SQLCNT は、更新したレコード数を確認するために使用することができます。

次のコマンドは、アトリビュートcredit_limit and dateを 指定した値で更新します。 この処理では、personnelテーブルのnameの値が Jonesであるすべてのレコードを更新します。

   EXEC SQL UPDATE personnel
      SET credit_limit=100, date='19851119'
      WHERE name='Jones';

次のコマンドは、カーソルcに関連付けられたコンテキストの カレントレコードのみを更新します。

   EXEC SQL UPDATE personnel
      SET credit_limit=100, date='19851119'
      WHERE CURRENT OF c;

operandは以下のとおりです。

意味はありません。

1. MATCHは、大文字と小文字を区別しないパターンマッチングで、 SMATCHは、これらを区別するパターンマッチングです。 match キーワードの前に"!"が付けられると、 パターンと一致しない全てのレコードを検索します。

2. NOT は"!"と同じではないことに注意してください。 "!"は演算子に適用されますが、式には適用されません。 ただし、演算子の前にNOT を使用した場合は式の前にしていた場合と 同様に処理されます。

3. WHERE とその指定についての詳細は、 Empress SQL: リファレンス の WHERE 句 を参照してください。

意味はありません。

1. SQLERRORに指定した処置は、エラー状況が検出されると実行されます。 SQLWARNINGに指定した処置は、例外状況が検出されると実行されます。 NOT FOUNDに指定した処置は、行が返されない場合、あるいは行が見つからない 場合に実行されます。

2. CONTINUE とGOTOは、 エラー状況、例外状況、または行の使用不可の場合に それぞれに実行される処置です。

3. 実行すべき処置を変更するために WHENEVER句はプログラム中に複数指定することができます。

4. WHENEVERステートメントの適用範囲は、そのステートメントから 同じ演算子 (SQLERROR、SQLWARNING 、 NOT FOUND)を持つ 次のWHENEVERステートメントの間に発生したエラー、 あるいはプロシージャの最後までに発生したエラーになります。