[variable = ] CALL procedure-name ( [ expression, ... ] )

[variable = ] CALL procedure-name ( [ parameter-name = expression, ... ] )

CALL 文は、CREATE PROCEDURE 文を使ってあらかじめ作成されたプロシージャーを呼び出します。プロシージャーが完了すると、INOUT または OUT パラメーター値がコピーし直されます。

引数リストは、引数の順序を守って指定するか、キーワードフォーマットを使うことにより指定できます。順序を守って指定した場合、引数はプロシージャーのパラメーターリスト内の対応するパラメーターと一致します (オプションのパラメーターには DEFAULT を使用できます)。キーワードを使用した場合、引数は指定したパラメーターと一致します。

プロシージャー引数には、CREATE PROCEDURE 文のデフォルト値が割り当てられます。パラメーターが見つからない場合は、デフォルト値が割り当てられます。また、デフォルトが設定されていない場合、パラメーターが NULL に設定されます。デフォルトが設定されていないうえ、引数も指定されていない場合には、エラーが発生します。

プロシージャーの内部では、プロシージャーが結果セットを返す場合、DECLARE 文で CALL 文を使用できます。

サブクエリと空間メソッド呼び出しは、CALL 文のストアドプロシージャーに対する引数としては使用できません。

プロシージャーは RETURN 文を使用して整数値 (たとえば、ステータスインジケーターとして) を返すことができます。変数の戻り値を保存するには、割り当て演算子として等号を使います。

CREATE VARIABLE returnval INT;
returnval = CALL proc_integer ( arg1 = val1, ... )

呼び出されたプロシージャーが INT を返し、値が NULL の場合は、代わりにエラーステータス値 0 が返されます。この場合と実際の値の 0 が返される場合とを区別する方法はありません。

DECLARE varname INT;
SET varname=test( );

プロシージャーの所有者であるか、そのプロシージャーに対する EXECUTE パーミッションまたは DBA 権限が必要です。

なし

• CREATE FUNCTION 文
• CREATE FUNCTION 文 [外部呼び出し]
• CREATE FUNCTION 文 [Web サービス]
• CREATE PROCEDURE 文
• CREATE PROCEDURE 文 [外部呼び出し]
• CREATE PROCEDURE 文 [Web サービス]
• GRANT 文
• EXECUTE 文 [T-SQL]
• 結果セット
• ストアドプロシージャー、トリガー、バッチ、ユーザー定義関数

ShowCustomers プロシージャーを呼び出します。このプロシージャーはパラメーターがなく、結果セットを返します。

CALL ShowCustomers();

次の Interactive SQL の例は、指定された ID を持つ顧客からの注文の数を戻すプロシージャーを作成し、結果を保持する変数を作成し、プロシージャーを呼び出し、結果を表示します。

CREATE PROCEDURE OrderCount (IN customer_ID INT, OUT Orders INT)
BEGIN
   SELECT COUNT(SalesOrders.ID)
   INTO Orders
   FROM Customers
   KEY LEFT OUTER JOIN SalesOrders
   WHERE Customers.ID = customer_ID;
END
go
 -- Create a variable to hold the result
CREATE VARIABLE Orders INT
go
-- Call the procedure, FOR customer 101
CALL OrderCount ( 101, Orders )
go
--  Display the result
SELECT Orders FROM DUMMY
go