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

このトピックでは、ストアドプロシージャと UDFs の主な違いについて説明します。これには、それぞれの呼び出し方法と実行できる内容の違いも含まれます。

大まかに言えば、ストアドプロシージャと UDFs は、以下で説明するように、通常の使用方法が異なります。

ストアドプロシージャの目的	ユーザー定義関数の目的
通常、 SQL ステートメントを実行して管理操作を実行します。ストアドプロシージャの本文では、値（エラーインジケーターなど）を明示的に返すことが許可されていますが、必須ではありません。	値を計算して返します。関数は、式を指定することによって常に明示的に値を返します。たとえば、 JavaScript UDF の本文には、値を返す `return` ステートメントが必要です。

このトピックの内容:

いつストアドプロシージャまたは UDF を作成するのか
サポートされているハンドラー言語
使用法と動作の違い

いつストアドプロシージャまたは UDF を作成するのか¶

一般的に、ストアドプロシージャまたは UDF を作成するかどうかを決定する場合には、次の推奨事項を考慮します。

次の場合にはストアドプロシージャを作成する	次の場合には UDF を作成する
既存のストアドプロシージャを別のアプリケーション/システムから移行している。データベース操作を実行する必要がある。 SELECT、 UPDATEなどの典型的なクエリと DML。一時テーブルの削除、 `N` 日より古いデータの削除、ユーザーの追加など、DDLを含む管理タスク。	既存の UDF を別のアプリケーション/システムから移行している。 SQL ステートメントの一部として呼び出すことができ、ステートメントで使用される値を返すことが必須な関数が必要である。出力にすべての入力行またはすべてのグループの値を含める必要がある。例: select MyFunction(col1) from table1; select MyAggregateFunction(col1) from table1 group by col2;

次の場合にはストアドプロシージャを作成する

次の場合には UDF を作成する

既存のストアドプロシージャを別のアプリケーション/システムから移行している。
データベース操作を実行する必要がある。
- SELECT、 UPDATEなどの典型的なクエリと DML。
- 一時テーブルの削除、 N 日より古いデータの削除、ユーザーの追加など、DDLを含む管理タスク。

既存の UDF を別のアプリケーション/システムから移行している。
SQL ステートメントの一部として呼び出すことができ、ステートメントで使用される値を返すことが必須な関数が必要である。

出力にすべての入力行またはすべてのグループの値を含める必要がある。例:

select MyFunction(col1) from table1;

select MyAggregateFunction(col1) from table1 group by col2;

サポートされているハンドラー言語¶

プロシージャまたは UDF を記述するときは、サポートされている言語のいずれかでそのロジックをハンドラーとして記述します。次のテーブルに、サポートされている言語をリストしています。

ストアドプロシージャ	ユーザー定義関数
Java	Java
JavaScript	JavaScript
Python	Python
Scala
Snowflakeスクリプト開発者ガイド	SQL

使用法と動作の違い¶

次のセクションでは、プロシージャと UDFs でサポートされる動作の具体的な違いについて説明します。

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

ストアドプロシージャと関数はどちらも値を返すことができます。ただし、

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

プロシージャが明示的に何も返さない場合でも、すべての CREATE PROCEDURE ステートメントに戻り型を定義する RETURNS 句を含める必要があることに注意してください。プロシージャが明示的に値を返さない場合は、暗黙的に NULL を返します。
UDF は、式を指定することによって常に明示的に値を返します。これは、 UDF の目的が値を計算して返すことだからです。たとえば、 JavaScript UDF の本文には、値を返す return ステートメントが必要です。

ストアドプロシージャの戻り値は SQL で直接使用できない場合があるが、 UDF の戻り値は可能¶

ストアドプロシージャからの戻り値は、関数からの戻り値とは異なり、 SQL で直接使用することはできません。

ストアドプロシージャは値を返すことができますが、 CALL コマンドの構文には、戻り値を保存する場所や、その値を操作したり別の操作に渡したりする方法がありません。SQL には、次のようなステートメントを作成する方法がありません。

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

ストアドプロシージャの戻り値を使用する間接的な方法はあります。

別のストアドプロシージャ内でストアドプロシージャを呼び出すことができます。たとえば、ストアドプロシージャハンドラーが JavaScript で記述されている場合、外側のストアドプロシージャの JavaScript は、内側のストアドプロシージャの出力を取得および格納できます。ただし、外部ストアドプロシージャ（および各内部ストアドプロシージャ）は、呼び出し元に複数の値を返すことができません。
ストアドプロシージャを呼び出してから RESULT_SCAN 関数を呼び出し、ストアドプロシージャ用に生成されたステートメント ID を渡すことができます。
結果セットを仮テーブルまたは永続テーブルに保存し、ストアドプロシージャコールから戻った後に、そのテーブルを使用できます。
データ量が大きすぎない場合は、複数の行と列を VARIANT に（ JSON 値などで）保存し、その VARIANT を返すことができます。

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

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

UDF は値に評価され、一般式を使用できるコンテキスト（SELECT my_function() ... など）で使用できます。

ストアドプロシージャは、独立したステートメントとして呼び出されます。以下のコードは、ストアドプロシージャの呼び出しと関数の呼び出しの違いを示しています。

CALL MyStoredProcedure_1(argument_1);

SELECT MyFunction_1(column_1) FROM table1;

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

単一の実行可能ステートメントは、1つのストアドプロシージャのみを呼び出すことができます。対照的に、単一の SQL ステートメントは複数の関数を呼び出すことができます。

同様に、ストアドプロシージャは、関数とは異なり、式の一部として呼び出すことはできません。

ただし、ストアドプロシージャ内では、ストアドプロシージャは別のストアドプロシージャを呼び出すことも、再帰的に呼び出すこともできます。この例は、ストアドプロシージャ例セクションに示されています。

ストアドプロシージャはデータベースにアクセスできるが、 UDFs はアクセス不可¶

ストアドプロシージャ内で、 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.
  $$;

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;
```

ストアドプロシージャとは異なり、 UDFs はデータベース操作を実行できる API にアクセスできません。