SQL 解説書

VALUES INTO

VALUES INTO ステートメントは、多くても 1 つの行から成る結果表を作成して、 その行の値をホスト変数に割り当てます。

呼び出し

このステートメントは、アプリケーション・プログラムに組み込む方法のみ可能です。 これは、動的に作成できない実行可能ステートメントです。

許可

権限は不要です。

構文

>>-VALUES----+-expression----------------+--INTO---------------->
             |    .-,-------------.      |
             |    V               |      |
             '-(-----expression---+---)--'
 
      .-,----------------.
      V                  |
>--------host-variable---+-------------------------------------><
 

説明

VALUES
1 つまたは複数の列からなる単一行をこの後に指定します。

expression
1 つの列からなる結果表の単一値を定義する式。

(expression,...)
1 つまたは複数の列からなる結果表の値を定義する 1 つまたは複数の式。

INTO
この後にホスト変数のリストを指定します。

host-variable
ホスト変数の宣言規則に従ってプログラムに記述されている変数を指定します。

結果行の最初の値はリストの最初の変数、 2 番目値は 2 番目の変数に割り当てられます。 以下同様です。 ホスト変数の数が列の値の数より少ない場合は、 SQLCA の SQLWARN3 フィールドに値 'W' が割り当てられます (付録 B, SQL 連絡 (SQLCA) を参照)。

各変数には、割り当てと比較で説明されている規則に基づいて値が割り当てられます。 割り当ては、リストに指定された順序で行われます。

エラーが発生すると、値はホスト変数に割り当てられません。

例 1: この C の例では、CURRENT PATH 特殊レジスターの値を検索してホスト変数に入れます。

   EXEC SQL VALUES(CURRENT PATH)
            INTO :hvl;

例 2: この C の例では、LOB フィールドの一部を検索してホスト変数に入れます。 LOB ロケーターを使用して、据え置き検索を実行します。

   EXEC SQL VALUES (substr(:locator1,35))
            INTO :details;


[ ページのトップ | 前ページ | 次ページ | 目次 | 索引 ]