DESCRIBE (実行可能埋込みSQL)

DESCRIBEの用途

動的SQL文またはPL/SQLブロックのホスト変数の説明を保持する記述子を初期化します。

DESCRIBEの前提条件

埋込みSQL PREPARE文を使用して、SQL文またはPL/SQLブロックを事前に準備しておく必要があります。

DESCRIBEの構文

図GUID-7768D6AA-E7B0-47A5-8C67-8D6DC45C7AB8-print.epsの説明

DESCRIBEのキーワードおよびパラメータ

BIND VARIABLES

SQL文またはPL/SQLブロックの入力変数に関する情報を保持する記述子を初期化します。

SELECT LIST

SELECT文の選択リストに関する情報を保持する記述子を初期化します。

デフォルトはSELECT LIST FORです。

statement_name block_name

PREPARE文で事前に準備したSQL文またはPL/SQLブロックを指定します。

descriptor

初期化する記述子の名前。

DESCRIBEの使用上の注意

埋込みSQLプログラム内のバインド記述子または選択記述子を操作するには、その前にDESCRIBE文を発行する必要があります。

入力変数と出力変数の両方を同じ記述子に記述することはできません。

DESCRIBE文で検出される変数の数は、一意に名前が指定されたプレースホルダの合計数ではなく、準備するSQL文またはPL/SQLブロックのプレースホルダの合計数です。このコマンドの詳細は、動的SQLの使用方法を参照してください。

DESCRIBEの例

この例では、Pro*C埋込みSQLプログラムでのDESCRIBE文の使用方法を示しています。

EXEC SQL PREPARE my_statement FROM :my_string; 
EXEC SQL DECLARE emp_cursor 
 FOR SELECT empno, ename, sal, comm 
 FROM emp 
 WHERE deptno = :dept_number 
EXEC SQL DESCRIBE BIND VARIABLES FOR my_statement 
 INTO bind_descriptor; 
EXEC SQL OPEN emp_cursor 
 USING bind_descriptor; 
EXEC SQL DESCRIBE SELECT LIST FOR my_statement 
 INTO select_descriptor; 
EXEC SQL FETCH emp_cursor 
 INTO select_descriptor;

DESCRIBEの関連トピック

PREPARE(実行可能埋込みSQL)