ストアドプロシージャの作成¶

プロシージャの作成¶

1. Python、Java、Scalaなど、サポートされている言語のいずれかを使用して、ハンドラーとしてプロシージャロジックを記述します。

2. ツールまたは API を選択し、作成したハンドラーでプロシージャを作成します。

   それぞれの情報については、 プロシージャ作成ツール をご覧ください。

   SQL	SQL を使用し、いくつかの言語のいずれかでロジックを記述します。
   Snowpark	Java、Python、または Scala 用の Snowpark API を使用します。
   コマンドライン	Snowflake CLI コマンドを実行してプロシージャを作成します。
   Python API	クライアント側の Python コマンドを実行してプロシージャを作成します。
   REST	RESTful API に、プロシージャ作成のリクエストを行います。

3. 必要に応じて、いくつかのツールのいずれかを使用して プロシージャを実行します。

プロシージャ作成ツール¶

プロシージャ は、Snowflake で利用可能ないくつかの方法のいずれかを使用して、言語とスキルセットに応じて作成できます。以下の表から、お客様のニーズに合ったツールをお選びください。

キー・プロパティ¶

次に、プロシージャを作成するときに必要な、または通常使用される、プロパティの一部について説明します。

プロシージャ名:

プロシージャ名はハンドラー名と一致する必要はありません。名前の制約と規則の詳細については、 プロシージャおよび UDFs の命名とオーバーロード をご参照ください。

引数:

要件の詳細については、 UDFs およびストアドプロシージャの引数の定義 を参照してください。

戻り型:

Snowflakeが SQL データ型をハンドラーデータ型にマップする方法については、 SQL とハンドラー言語間のデータ型マッピング をご参照ください。

ハンドラー名:

必要な場合、これは、プロシージャが呼び出されたときに実行されるコードを含むクラスまたはメソッドの名前です。Java、Python、およびScalaで記述されたハンドラーに対してのみ、ハンドラー名を指定する必要があります。JavaScript およびSnowflakeスクリプトハンドラーの場合、インラインで指定されたすべてのコードがハンドラーとして実行されます。

依存関係:

Java、Python、Scalaで書かれたハンドラーの場合、プロシージャを作成する際などにSnowparkライブラリを指定する必要があるかもしれません。

ハンドラーで依存関係を利用できるようにする方法の詳細については、 コードで依存関係を利用できるようにする方法 をご参照ください。

ハンドラー言語ランタイム:

ハンドラー言語がJava、Python、Scalaの場合、サポートされているランタイムバージョンを示すためにランタイムバージョンを指定します。デフォルトのバージョンを使用している場合、そのデフォルトは時間の経過とともに変更されることに留意してください。

アクセス制御の要件¶

この操作の実行に使用される ロール には、少なくとも次の 権限 が必要です。

スキーマ内のオブジェクトに対して操作を実行するには、親データベースとスキーマに対する USAGE 権限が必要です。

指定された権限のセットを使用してカスタムロールを作成する手順については、 カスタムロールの作成 をご参照ください。

セキュリティ保護可能なオブジェクト に対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、 アクセス制御の概要 をご参照ください。

使用上の注意¶

SQL でストアドプロシージャを作成します。¶

ストアドプロシージャを作成するには、 SQL を使用します。

1. プロシージャが呼び出されたときに実行されるハンドラーコードを記述します。

   サポートされているハンドラー言語のいずれかを使用できます。詳細については、 対応言語とツール をご参照ください。

2. ハンドラーコードを CREATE PROCEDURE SQL ステートメントとインラインで保持するか、ステージで参照するかを選択します。

   それぞれに利点があります。詳細については、 ハンドラーコードのインラインまたはステージ上での保持 をご参照ください。

3. プロシージャのプロパティを指定して、 SQL で CREATE PROCEDURE ステートメントを実行します。

   次の例のコードは、インラインハンドラー MyClass.myMethod を持つ myProc というプロシージャを作成します。ハンドラー言語はJavaであり、（ScalaやPythonで記述されたプロシージャハンドラーと同様に）Snowparkライブラリのセッションオブジェクトが必要です。ここで、 PACKAGES 句は、Snowflakeに含まれるSnowparkライブラリを参照します。

   CREATE OR REPLACE PROCEDURE myProc(fromTable STRING, toTable STRING, count INT)
     RETURNS STRING
     LANGUAGE JAVA
     RUNTIME_VERSION = '11'
     PACKAGES = ('com.snowflake:snowpark:latest')
     HANDLER = 'MyClass.myMethod'
     AS
     $$
       import com.snowflake.snowpark_java.*;
   
       public class MyClass
       {
         public String myMethod(Session session, String fromTable, String toTable, int count)
         {
           session.table(fromTable).limit(count).write().saveAsTable(toTable);
           return "Success";
         }
       }
     $$;
   

   Copy