プロシージャーからの結果セットで返される情報

プロシージャーは、個別のパラメーターとして呼び出しを行った環境に結果を返すだけでなく、結果セットとして情報を返すこともできます。通常、結果セットになるのはクエリの結果です。

RESULT 句の変数の数は、SELECT 文のリスト内の変数の数に一致しなければなりません。データ型が一致しない場合は、可能であれば自動的にデータ型の変換が行われます。

RESULT 句は CREATE PROCEDURE 文の一部であり、文デリミターは付きません。

SELECT 文のリスト内の変数の名前は、RESULT 句の変数の名前と一致する必要はありません。

ビューでプロシージャーの結果セットを変更するには、基本となるテーブルに対する適切なパーミッションがユーザーに必要です。

ストアドプロシージャーまたはユーザー定義関数が結果を返す場合、出力パラメーターや戻り値もサポートされません。

デフォルトでは Interactive SQL は最初の結果セットのみを返します。Interactive SQL でプロシージャーが結果の複数のローを返せるようにするには、[オプション] ウィンドウの [結果] タブで [複数の結果セットを表示] オプションを設定します。

例 1

次に示すプロシージャーは、注文した顧客のリストと、注文の合計額を返します。

Interactive SQL で次の文を実行します。

CREATE PROCEDURE ListCustomerValue()
RESULT ( "Company" CHAR(36), "Value" INT )
BEGIN
   SELECT CompanyName,
      CAST( SUM(  SalesOrderItems.Quantity *
                  Products.UnitPrice )
                  AS INTEGER ) AS value
   FROM Customers
      INNER JOIN SalesOrders
      INNER JOIN SalesOrderItems
      INNER JOIN Products
   GROUP BY CompanyName
   ORDER BY value DESC;
END;

CALL ListCustomerValue ( ); を実行すると、次の結果セットが返されます。

Company	Value
The Hat Company	5016
The Igloo	3564
The Ultimate	3348
North Land Trading	3144
Molly's	2808
...	...

例 2

次に示すプロシージャーは、ある部署の従業員 1 人 1 人の給与をセットにして返します。Interactive SQL で次の文を実行します。

CREATE PROCEDURE SalaryList( IN department_id INT )
RESULT ( "Employee ID" INT, Salary NUMERIC(20,3) )
BEGIN
   SELECT EmployeeID, Salary
    FROM Employees
    WHERE Employees.DepartmentID = department_id;
END;

RESULT 句での名前はクエリの結果と対応付けられ、表示される結果のカラムの見出しに使われます。

研究開発部 (部署 ID 100) の従業員の給与を表示するには、次の文を実行します。

CALL SalaryList( 100 );

[結果] ウィンドウ枠に次の結果セットが表示されます。

Employee ID	Salary
102	45700.000
105	62000.000
160	57490.000
243	72995.000
...	...

参照

DocCommentXchange で意見交換できます