4.3.1　ストアドプロシジャの定義

(a)　トランザクションを決着するSQL

次のSQL文をストアドプロシジャ中で実行すると，トランザクションを決着できます。ただし，Cストアドプロシジャ中では，SQL文を実行できません。

• COMMIT文

• ROLLBACK文

次のSQLを実行した場合，自動的にCOMMITが行われます。

• PURGE TABLE文

• 定義系SQL（Javaストアドプロシジャだけ）

次の条件に該当する場合，自動的にROLLBACKが行われます。

• ROLLBACKが必要なエラー

(b)　ストアドプロシジャを再実行する場合の注意事項

ストアドプロシジャ中でトランザクションを決着した後にエラーが発生した場合，そのプロシジャの実行は途中で終了します。エラーになったストアドプロシジャを再実行する場合，プロシジャの処理は先頭から実行されるため，エラー発生前のトランザクション解決までに行った操作が，二重に実行されてよいかどうかを考慮する必要があります。例を次に示します。

(a)　結果集合返却機能とは

SQLストアドプロシジャ内での，SELECT文の実行によって得られるカーソルを，SQLストアドプロシジャの呼び出し元で参照する機能を，結果集合返却機能といいます。

結果集合返却機能の概要を次の図に示します。

(b)　結果集合返却機能を使用できる呼び出し元の言語

結果集合返却機能を使用できる呼び出し元の言語を次に示します。

• Java

• C

• C++

• COBOL^※

• OOCOBOL

注※

RDBファイル入出力機能を使用していない場合，使用できます。

(c)　結果集合返却機能の使用例

SQLストアドプロシジャ内で，表emps_1，及び表emps_2に対して，id<10の条件を満たす列id，name，及びageを取得します。呼び出し元で2個の結果集合を受け取り，これらを操作します。

• SQLストアドプロシジャの定義

  CREATE PROCEDURE proc2(IN param1 INTEGER) ............... 1
    DYNAMIC RESULT SETS 2 ................................. 2
    BEGIN
      DECLARE CUR1 CURSOR WITH RETURN ..................... 3
         FOR SELECT id,name,age FROM emps_1
              WHERE id < param1 ORDER BY id;
      DECLARE CUR2 CURSOR WITH RETURN ..................... 4
         FOR SELECT id,name,age FROM emps_2
              WHERE id < param1 ORDER BY id;
      OPEN CUR1; .......................................... 5
      OPRN CUR2; .......................................... 6
    END; .................................................. 7

[説明]

1. プロシジャ名，パラメタの定義

2. 返却する検索結果情報数の指定

3. カーソル（CUR1）の宣言

4. カーソル（CUR2）の宣言

5. カーソル（CUR1）のオープン

6. カーソル（CUR2）のオープン

7. 呼び出し終了，及び結果集合返却

• 呼び出し元（C言語の埋込み型UAPの場合）

  #include <stdio.h>
  #include <string.h>
   
  main()
  {
    EXEC SQL BEGIN DECLARE SECTION;
      struct {
        short len;
        char str[31];
      } cur1;
      int emp_id;
      char emp_name[13];
      int emp_age;
    EXEC SQL END DECLARE SECTION;
    --------（HiRDBへのCONNECT処理（省略））--------
    
    cur1.len = sprintf(cur1.str, "cursor1"); .................... 1
   
    EXEC SQL CALL PROC(10); ..................................... 2
   
    If (SQLCODE == 120) { ....................................... 3
   
      EXEC SQL ALLOCATE GLOBAL :cur1
                 FOR PROCEDURE PROC2; ........................... 4
      printf("*** emps_1 ***\n"); ............................... 5
      while (1) { ............................................... 5
        EXEC SQL FETCH GLOBAL :cur1 ............................. 5
                   INTO :emp_id,:emp_name,:emp_age; ............. 5
        if (SQLCODE<0 || SQLCODE==100) break; ................... 5
        printf("ID=%d  NAME=%s  AGE=%d\n", ...................... 5
              emp_id, emp_name, emp_age); ....................... 5
      } ......................................................... 5
      CLOSE GLOBAL :cur1; ....................................... 6
      if (SQLCODE==121) { ....................................... 7
        printf("*** emps_2 ***\n"); ............................. 8
        while (1) { ............................................. 8
      EXEC SQL FETCH GLOBAL :cur1 ............................... 8
                     INTO :emp_id,:emp_name,:emp_age; ........... 8
          if (SQLCODE<0 || SQLCODE==100) break; ................. 8
          printf("ID=%d  NAME=%s  AGE=%d\n", .................... 8
                emp_id, emp_name, emp_age); ..................... 8
        } ....................................................... 8
        CLOSE GLOBAL :cur1; ..................................... 9
      }
    }
  }

[説明]

1. カーソル名の設定

2. CALL文の実行

3. 返却結果集合があるかどうかの確認

4. カーソルの割り当て（1個目の結果集合とカーソルを関連づけます）

5. 1個目の結果集合からの情報を出力

6. カーソルを閉じる（2個目の結果集合とカーソルを関連づけます）

7. 次の結果集合があるかどうかの確認

8. 2個目の結果集合からの情報を出力

9. カーソルを閉じる

(d)　結果集合返却機能を使用する場合の注意事項

• CREATE PROCEDUREでのSQLストアドプロシジャ定義時

  1. 結果集合として返却するカーソルのカーソル宣言には，「WITH RETURN」を指定してください。

  2. 結果集合として返却するカーソルは，「WITH RETURN」指定で宣言したカーソルのうち，プロシジャ終了時に開いた状態のカーソルだけです。

  3. 返却する結果集合が2個以上の場合，カーソルを開いた順序で返却されます。

• 呼び出し元作成時

  1. 結果集合を返却するプロシジャを実行した場合，SQLSTATEに0100C，SQLCODEに120が設定されます。

  2. 埋込み型UAP，及びSQLストアドプロシジャで結果集合を受け取る場合には，ALLOCATE CURSOR文で結果集合の組にカーソルを割り当て，その先頭の結果集合とカーソルを関連づけます。返却される結果集合が2個以上の場合，2個目以降の結果集合は，前の結果集合を参照しているカーソルに対してCLOSE文を実行すると，カーソルと関連づけられます。CLOSE文を実行した場合に，次の結果集合があり，その結果集合とカーソルを関連づけたときには，SQLSTATEに0100D，SQLCODEに121が設定されます。次の結果集合がない場合には，SQLSTATEに02001，SQLCODEに100が設定されます。