4.6 DEALLOCATE PREPARE文

機能

PREPARE文で準備されているSQL文を解放します。

記述形式

一般規則

DEALLOCATE PREPARE文で指定しているSQL文識別子または拡張SQL文識別子と対応する被準備文が動的SELECT文の場合、同じSQL文識別子または拡張SQL文識別子に対応するカーソルは、閉じられた状態であることが必要です。
DEALLOCATE PREPARE文を実行することにより、SQL文識別子または拡張SQL文識別子に対応する被準備文は解放されます。
拡張SQL文識別子に対応する被準備文が動的SELECT文の場合、拡張SQL文識別子に対応するALLOCATE CURSOR文で定義したカーソルも同時に解放されます。
SQL文識別子または拡張SQL文識別子と対応する被準備文が動的SELECT文の場合、SQL文識別子または拡張SQL文識別子に対応するカーソルを参照している準備可能動的DELETE文:位置づけおよび準備可能動的UPDATE文:位置づけの被準備文も同時に解放されます。

SQL文識別子または拡張SQL文識別子

解放する被準備文の名前を指定します。
解放する被準備文を準備したPREPARE文がSQL文識別子を指定している場合は、SQL文識別子を指定します。
解放する被準備文を準備したPREPARE文が拡張SQL文識別子を指定している場合は、拡張SQL文識別子を指定し、拡張SQL文識別子の値に被準備文の名前を指定します。
拡張SQL文識別子は、文字列型の埋込み変数で指定します。拡張SQL文識別子の値に空白を含む場合は、前後の空白を取り除いた値が被準備文の名前になります。
SQL文識別子を指定した場合、SQL文識別子は、同一コンパイル単位に含まれるPREPARE文で定義されていることが必要です。
SQL文識別子と拡張SQL文識別子の値が同じでも、異なる被準備文として区別されます。

使用例

例1

DELETE文:探索をPREPARE文で準備し、EXECUTE文で実行した後、そのSQL文識別子に対応する被準備文を解放します。なお、可変長文字型の展開規則は、“6.3 SQL埋込みCプログラム”を参照してください。

  EXEC SQL BEGIN DECLARE SECTION;
       VARCHAR CMDAREA[100];
  EXEC SQL END DECLARE SECTION;
                ：
  strcpy(CMDAREA.sqlvar,"DELETE FROM S1.TBL WHERE COL1 = 39");   (1)
  CMDAREA.sqllen = strlen(CMDAREA.sqlvar);
  EXEC SQL PREPARE CMD FROM :CMDAREA;                            (2)
  EXEC SQL EXECUTE CMD;                                          (3)
  EXEC SQL DEALLOCATE PREPARE CMD;                               (4)

(1) ホスト変数CMDAREAにDELETE文:探索を設定します。

(2) ホスト変数CMDAREAが示すSQL文をSQL文識別子CMDに対応づけます。

(3) 被準備文を実行します。

(4) SQL文識別子CMDに対応する被準備文を解放します。

例2

拡張SQL文識別子を指定した場合の例を示します。なお、可変長文字型の展開規則は、“6.3 SQL埋込みCプログラム”を参照してください。

  EXEC SQL BEGIN DECLARE SECTION;
       CHAR CMDVAR[4];
       VARCHAR CMDAREA[100];
  EXEC SQL END DECLARE SECTION;
                ：
  strcpy(CMDVAR,"CMD");                                         (1)
  strcpy(CMDAREA.sqlvar,"DELETE FROM S1.TBL WHERE COL1 = 39");  (2)
  CMDAREA.sqllen = strlen(CMDAREA.sqlvar);
  EXEC SQL PREPARE :CMDVAR FROM :CMDAREA;                       (3)
  EXEC SQL EXECUTE :CMDVAR;                                     (4)
  EXEC SQL DEALLOCATE PREPARE :CMDVAR;                          (5)

(1) ホスト変数CMDVARに被準備文の名前CMDを設定します。

(2) ホスト変数CMDAREAにDELETE文:探索を設定します。

(3) ホスト変数CMDAREAが示すSQL文を拡張SQL文識別子CMDVARの値CMDに対応づけます。

(4) 被準備文を実行します。

(5) 拡張SQL文識別子CMDVARの値CMDに対応する被準備文を解放します。