アプリケーションパッケージへのビジネスロジックの追加¶

アプリケーションコードの安全な追加¶

Snowflake Native App 内にあるすべてのストアドプロシージャと UDFs は、アプリケーションとして実行され、インストールされた Snowflake Native App 内のすべてのオブジェクトにアクセスできます。これは、 SQL インジェクション攻撃につながる可能性があります。

Snowflake Native App 内で使用するプロシージャや関数を開発する場合、ユーザーからの入力を必要とするすべての SQL コマンドは、バインドパラメーターを使用して実行することをSnowflakeは推奨します。これには、プロシージャの引数を通じて提供される入力も含まれます。

詳細については、 ストアドプロシージャの作成 をご参照ください。

呼び出し元の権限と所有者の権限について¶

セットアップスクリプトによって作成されたプロシージャ、またはインストールされた Snowflake Native App 内で実行されたプロシージャはすべて、所有者の権限（EXECUTE AS OWNER）で実行する必要があります。

この制限が存在するのは、 Snowflake Native App が所有していないプロシージャに対して Snowflake Native App が呼び出し元の権限（EXECUTE AS CALLER）で実行されると、そのプロシージャは Snowflake Native App 自体として実行され、コンシューマーがコードを作成して Snowflake Native App や共有データコンテンツの内容を表示または変更できるからです。

詳細については、 Understanding Caller's Rights and Owner's Rights Stored Procedures をご参照ください。

セットアップスクリプトからコンテキスト関数を呼び出す際の制限事項¶

コンテキスト関数 は、ステートメントが実行されるコンテキストに関する情報を提供します。 Snowflake Native App Framework のコンテキスト内では、一部のコンテキスト関数は使用できません。使用できないコンテキスト関数は、ブロックされてエラーを返すか、常にnull値を返します。

一般に、 Snowflake Native App 内の共有データコンテンツに適用されるポリシーでコンテキスト関数を使用する場合は、注意が必要です。たとえば、 CURRENT_IP_ADDRESS のようないくつかの関数は、 Snowflake Native App のコンテキストによって動作が異なります。

クライアント組織内の名前空間に依存するコンテキスト関数を使用する場合は、他の名前空間の関数と競合する可能性があることに注意してください。たとえば、 CURRENT_USER を使用した行アクセスポリシーでは、同じユーザー名が複数のアカウントに存在する可能性があることを認識する必要があります。

次のテーブルは、 Snowflake Native App Framework でサポートされていないコンテキスト関数のリストです。

外部コードファイルの参照¶

アプリケーションパッケージに含めることができるコードファイルには2種類あります。

• 参照されるファイル: バイナリ、ライブラリ、その他のコードファイルを含みます。これらのファイルは、アプリケーションパッケージで定義されたバージョンに固有です。これらのファイルは、アプリケーションパッケージにバージョンを作成または追加する際、ステージのルートディレクトリに配置する必要があります。

  参照されるファイルは、アプリケーションパッケージのセットアップスクリプトで定義されないため、ユーザー定義関数やストアドプロシージャとは異なります。これらのファイルは、セットアップスクリプトで定義されるストアドプロシージャや UDFs などのインポートステートメントによって参照されます。

• リソースファイル: 半構造化データ、構造化データ、バイナリ、たとえば機械学習モデルなどを含みます。また、これらのファイルは、アプリケーションパッケージがアクセスできる名前付きステージにアップロードする必要があります。

これらの種類のコードファイルを参照するストアドプロシージャ、ユーザー定義関数、または外部関数は、セットアップスクリプトのバージョン管理されたスキーマ内に作成する必要があります。バージョン管理されたスキーマ内でストアドプロシージャや関数を作成する場合は、名前付きステージのルートディレクトリに相対するコードファイルを参照する必要があります。

たとえば、名前付きステージのルートディレクトリが /app_files/dev の場合、このディレクトリには以下のファイルとディレクトリが含まれます。

• manifest.yml ファイル。

• セットアップスクリプトを含むディレクトリ、たとえば scripts/setup_version.sql。

• セットアップスクリプト内でストアドプロシージャ、 UDF、外部関数などを作成する際にインポートされる参照ファイル。

  • libraries/jars/lookup.jar

  • libraries/jars/log4j.jar

  • libraries/python/evaluate.py

このシナリオでは、ディレクトリ構造は以下のようになります。

@DEV_DB.DEV_SCHEMA.DEV_STAGE/V1:
└── app_files/
    └── dev
        ├── manifest.yml
        └── scripts/
            ├── setup_script.sql
            └── libraries/
                └── jars/
                    ├── lookup.jar
                    └── log4j.jar
            └── python
                └── evaluation.py

このディレクトリ構造内の JAR ファイルにアクセスするために、セットアップスクリプトで定義されたストアドプロシージャが、次の例に示すようにこれらのファイルを参照します。

CREATE PROCEDURE PROGRAMS.LOOKUP(...)
 RETURNS STRING
 LANGUAGE JAVA
 PACKAGES = ('com.snowflake:snowpark:latest')
 IMPORTS = ('/scripts/libraries/jar/lookup.jar',
            '/scripts/libraries/jar/log4j.jar')
 HANDLER = 'com.acme.programs.Lookup';

この例では、 IMPORTS ステートメントには、バージョンの作成に使用されたルートディレクトリ（例: manifest.yml ファイルの場所）からの相対パスがあります。

アプリケーションパッケージへのJavaおよびScalaコードの追加¶

Snowflake Native App Framework は、ストアドプロシージャや外部コードファイルでのJavaとScalaの使用をサポートしています。

CREATE OR ALTER VERSIONED SCHEMA app_code;
CREATE STAGE app_code.app_jars;

CREATE FUNCTION app_code.add(x INT, y INT)
 RETURNS INTEGER
 LANGUAGE JAVA
 HANDLER = 'TestAddFunc.add'
 TARGET_PATH = '@app_code.app_jars/TestAddFunc.jar'
 AS
 $$
   class TestAddFunc {
       public static int add(int x, int y) {
           Return x + y;
       }
   }
 $$;

@DEV_DB.DEV_SCHEMA.DEV_STAGE/V1:
└── V1/
 ├── manifest.yml
 ├── setup_script.sql
 └── JARs/
     ├── Java/
     │   └── TestAddFunc.jar
     └── Scala/
         └── TestMulFunc.jar

CREATE FUNCTION app_code.add(x INTEGER, y INTEGER)
  RETURNS INTEGER
  LANGUAGE JAVA
  HANDLER = 'TestAddFunc.add'
  IMPORTS = ('/JARs/Java/TestAddFunc.jar');

アプリケーションパッケージへのPythonコードの追加¶

Snowflake Native App Framework は、ストアドプロシージャや外部コードファイルでのPythonの使用をサポートしています。

CREATE FUNCTION app_code.py_echo_func(str STRING)
RETURNS STRING
LANGUAGE PYTHON
HANDLER = 'echo'
AS
$$
  def echo(str):
    return "ECHO: " + str
$$;

CREATE FUNCTION PY_PROCESS_DATA_FUNC()
  RETURNS STRING
  LANGUAGE PYTHON
  HANDLER = 'TestPythonFunc.process'
  IMPORTS = ('/python_modules/TestPythonFunc.py',
    '/python_modules/data.csv')

JavaScript エラーの処理¶

アプリケーションパッケージ内で JavaScript を使用する場合、Snowflakeはエラーをキャッチして処理することを推奨しています。そうしないと、エラーが返すエラーメッセージとスタックトレースがコンシューマーに表示されます。データコンテンツとアプリケーションロジックの秘密を保持するには、機密性の高いオブジェクトやデータにアクセスされる場合にtry/catchブロックを使用します。

次の例は、エラーをキャッチしてメッセージを返す JavaScript ストアドプロシージャです。

CREATE OR REPLACE PROCEDURE APP_SCHEMA.ERROR_CATCH()
  RETURNS STRING
  LANGUAGE JAVASCRIPT
  EXECUTE AS OWNER
  AS $$
     try {
      let x = y.length;
     }
     catch(err){
        return "There is an error.";
     }
     return "Done";
  $$;

この例では、try/catchブロックを含む JavaScript ストアドプロシージャを作成します。ストアドプロシージャが try ブロックでステートメントを実行する際にエラーが発生した場合は、コンシューマーに表示される「There is an error」というメッセージを返します。

try/catchブロックがないと、ストアドプロシージャは元のエラーメッセージとコンシューマーに表示される完全なスタックトレースを返します。