ストアドプロシージャとユーザー定義関数のどちらを記述するかの選択¶

UDFs は値を返すが、ストアドプロシージャは値を返すとは限らない¶

• UDF は、式を指定することによって常に明示的に値を返します。UDF の目的は、値を計算して返すことです。たとえば、 JavaScript UDF の本文には、値を返す return ステートメントが必要です。

• 値（エラーインジケーターなど）を明示的に返すためにストアドプロシージャは許可されていますが、必須ではありません。ストアドプロシージャの一般的な目的は、 SQL ステートメントを実行して管理操作を実行することです。プロシージャが明示的に値を返さない場合は、暗黙的に NULL を返します。

  プロシージャが明示的に何も返さない場合でも、すべての CREATE PROCEDURE ステートメントに戻り型を指定する RETURNS 句を含める必要があることに注意してください。プロシージャが明示的に値を返さない場合は、暗黙的に NULL を返します。

  次の例のコードでは、 RETURNS 句を使用してプロシージャの戻り型を宣言していますが、エラーが発生した場合にのみ値が返されます。つまり、すべてのコードパスが値を返すわけではありません。

  CREATE OR REPLACE PROCEDURE do_stuff(input NUMBER)
  RETURNS VARCHAR
  LANGUAGE SQL
  AS
  $$
  DECLARE
    ERROR VARCHAR DEFAULT 'Bad input. Number must be less than 10.';
  
  BEGIN
    IF (input > 10) THEN
      RETURN ERROR;
    END IF;
  
    -- Perform an operation that doesn't return a value.
  
  END;
  $$
  ;
  

  Copy

UDF は SQL で直接使用できる値を返すが、ストアドプロシージャの値は直接使用できるとは限らない¶

Snowflakeスクリプトブロックからストアドプロシージャを呼び出していない場合は、ストアドプロシージャが返す値を SQL で直接使用することはできません（関数が返す値の場合とは異なる）。CALL コマンドの構文は、戻り値を格納する場所や、その値を操作したり別の操作に渡したりする方法を提供しません。つまり、以下のステートメントは、有効な SQL ステートメントではありません。

y = stored_procedure1(x);                         -- Not allowed.

Snowflakeスクリプトブロック 内でストアドプロシージャを呼び出すと、 Snowflakeスクリプト変数 に ストアドプロシージャが返す値をキャプチャ することができます。

また、以下のリストで説明するように、ストアドプロシージャの戻り値を間接的に（Snowflake Scriptingブロックの外部で）使用することもできます。

• 別のストアドプロシージャ内でストアドプロシージャを呼び出すことができます。たとえば、ストアドプロシージャハンドラーが JavaScript で記述されている場合、外側のストアドプロシージャの JavaScript は、内側のストアドプロシージャの出力を取得および格納できます。ただし、外部ストアドプロシージャ（および各内部ストアドプロシージャ）は、呼び出し元に複数の値を返すことができません。

• ストアドプロシージャを呼び出してから RESULT_SCAN 関数を呼び出し、ストアドプロシージャ用に生成されたステートメント ID を渡すことができます。

• 結果セットを仮テーブルまたは永続テーブルに保存し、ストアドプロシージャコールから戻った後に、そのテーブルを使用できます。

• データ量が大きすぎない場合は、複数の行と列を VARIANT に（ JSON 値などで）保存し、その VARIANT を返すことができます。

UDFs は別のステートメントのコンテキストで呼び出し可、ストアドプロシージャは独立して呼び出し¶

• UDF は値に評価され、次のように一般式を使用するコンテキストで使用できます。

  SELECT MyFunction_1(column_1) FROM table1;
  

  Copy

• ストアドプロシージャは値に評価されず、一般式を使用できるすべてのコンテキストで使用できるわけではありません。たとえば、 SELECT my_stored_procedure()... は実行できません。

  次の例のように、独立したステートメントとしてストアドプロシージャを呼び出します。

  CALL MyStoredProcedure_1(argument_1);
  

  Copy

関数とプロシージャの呼び出しの詳細については、次をご参照ください。

• ストアドプロシージャの呼び出し

• UDF の呼び出し

1つのステートメントで複数の UDFs の呼び出し可、1つのステートメントで呼び出すことができるストアドプロシージャは1つ¶

• 単一の SQL ステートメントで複数の UDFs を呼び出すことができます。

• 単一の SQL ステートメントで呼び出せるストアドプロシージャは1つのみです。

  同様に、ストアドプロシージャは、 UDF とは異なり、式の一部として呼び出すことはできません。ただし、ストアドプロシージャ内では、ストアドプロシージャは別のストアドプロシージャを呼び出すことも、再帰的に呼び出すこともできます。たとえば、コード例セクション 例 をご参照ください。

関数とプロシージャの呼び出しの詳細については、次をご参照ください。

• ストアドプロシージャの呼び出し

• UDF の呼び出し

UDFs は、単純なクエリを使用した場合にのみデータベースにアクセスできます。ストアドプロシージャは、 DDL と DML ステートメントを実行できます。¶

• UDF では、 SQL を使用してクエリのみ（DML や DDL ステートメントではなく）を実行できます。

• ストアドプロシージャ内で、 SELECT、 UPDATE、 CREATE などのデータベース操作を実行できます。

  • たとえば、 JavaScript ストアドプロシージャでは、 JavaScript API を使用してこれらの操作を実行できます。

    以下の例は、ストアドプロシージャが別のストアドプロシージャを呼び出す SQL ステートメントを作成および実行する方法を示しています。 $$ は、ストアドプロシージャの JavaScript ハンドラーコードの開始と終了を示します。

    CREATE PROCEDURE ...
      $$
      // Create a Statement object that can call a stored procedure named
      // MY_PROCEDURE().
      var stmt1 = snowflake.createStatement( { sqlText: "call MY_PROCEDURE(22)" } );
      // Execute the SQL command; in other words, call MY_PROCEDURE(22).
      stmt1.execute();
      // Create a Statement object that executes a SQL command that includes
      // a call to a UDF.
      var stmt2 = snowflake.createStatement( { sqlText: "select MY_UDF(column1) from table1" } );
      // Execute the SQL statement and store the output (the "result set") in
      // a variable named "rs", which we can access later.
      var rs = stmt2.execute();
      // etc.
      $$;
    

    Copy

  • Snowflakeスクリプト のストアドプロシージャで、 SQL ステートメントを実行できます。

    以下の例は、ストアドプロシージャが別のストアドプロシージャを呼び出す SQL ステートメントを作成および実行する方法を示しています。 $$ は、ストアドプロシージャにあるSnowflakeスクリプトコードの開始と終了を示します。

    CREATE PROCEDURE ...
      -- Call a stored procedure named my_procedure().
      CALL my_procedure(22);
      -- Execute a SQL statement that includes a call to a UDF.
      SELECT my_udf(column1) FROM table1;
    

    Copy