アプリをローカルにインストールしてテストする¶

DEVELOP 権限を使用する¶

既定では、アプリケーションパッケージを作成するために使用されるロールは、アプリケーションパッケージに基づいてアプリケーションを作成するために CREATE APPLICATION コマンドを使用する権限を持っています。

しかし、開発環境によっては、他のロールを持つユーザーにアプリケーションパッケージの作成とテストを許可することが必要になる場合があります。そうするには、ロールにアプリケーションパッケージに対するオブジェクトレベルの DEVELOP 権限を付与します。

DEVELOP 権限は、アプリケーションパッケージに基づいてアプリケーションを作成し、テストするために必要な権限を付与します。このアクセス権限により、ユーザーはアクセス権限が付与されたアプリケーションパッケージを使用して、以下のタスクを実行できます。

• アプリケーションパッケージで指定されたバージョンまたはパッチに基づいてアプリケーションを作成します。

• ALTER APPLICATION コマンドを使用して、異なるバージョンのアプリにアップグレードします。

• ステージングされたファイルを使用してアプリを作成またはアップグレードします。

• 開発モードで作成されたアプリのデバッグモードを有効にします。

ロールに DEVELOP 権限を付与するには、次の例に示すように GRANT <権限> ... TO ROLE コマンドを使用します。

GRANT DEVELOP ON APPLICATION PACKAGE hello_snowflake_package TO ROLE other_dev_role;

ステージングされたファイルを使ったアプリの作成¶

名前付きステージにアップロードされたマニフェストファイルとセットアップスクリプトを使用して、アプリを作成できます。これにより、アプリケーションパッケージに新しいバージョンを追加することなく、これらのファイルの変更をテストすることができます。

次の例に示すように、 CREATE APPLICATION コマンドを使用して、ステージングされたファイルを使用してアプリを作成します。

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package
  USING '@hello_snowflake_code.core.hello_snowflake_stage';

バージョンまたはパッチからアプリを作成¶

アプリケーションパッケージでバージョンやパッチを定義した後、そのバージョンやパッチに基づいてアプリケーションを作成することができます。

特定のバージョンからアプリを作成するには、次の例のように CREATE APPLICATION コマンドを使用します。

CREATE APPLICATION hello_snowflake_app
  FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0;

特定のパッチからアプリを作成するには、次の例のように CREATE APPLICATION コマンドを使います。

CREATE APPLICATION hello_snowflake_app
  FROM APPLICATION PACKAGE hello_snowflake_package
  USING VERSION v1_0 PATCH 2;

リリースディレクティブに基づいたアプリの作成¶

アプリケーションパッケージでリリースディレクティブ (カスタムまたはデフォルト) を指定すると、そのリリースディレクティブに基づいてアプリケーションを作成することができます。

リリースディレクティブに基づいてアプリを作成するには、次の例のように CREATE APPLICATION コマンドを使用します。

CREATE APPLICATION hello_snowflake_app FROM APPLICATION PACKAGE hello_snowflake_package;

ステージを使用したアプリのアップグレード¶

名前付きステージ上のファイルを使用してアプリをアップグレードするには、次の例に示すように、 ALTER APPLICATION コマンドを使用します。

ALTER APPLICATION HelloSnowflake
  UPGRADE USING @CODEDATABASE.CODESCHEMA.AppCodeStage;

バージョンまたはパッチからのアプリのアップグレード¶

特定のバージョンやパッチを使用して作成されたアプリをアップグレードするには、次の例に示すように ALTER APPLICATION コマンドを使用します。

ALTER APPLICATION HelloSnowflake
 UPGRADE USING VERSION "v1_1";

開発モードについて¶

バージョンの指定 または アプリケーションファイルを名前付きステージ の指定をして、アプリケーションパッケージからローカルにアプリを作成する場合、アプリは開発モードであるとみなされます。

開発モードを使用して、1つのアカウント内でアプリのテストとトラブルシューティングを行います。開発モードでは、アプリケーションパッケージの特定のバージョンに基づいてアプリケーションを作成し、テストすることができます。ステージングされたアプリケーションファイルを使ってアプリケーションを作成し、テストすることもできます。これにより、セットアップスクリプトやアプリケーションロジックの変更をすばやくテストできます。

開発モードは、コンシューマーが表示できないアプリ内のすべてのオブジェクトを表示し、テストするために使用できる追加の デバッグモード を提供します。

例えば開発モードでは、アプリ内のオブジェクトに対して SHOW や DESC コマンドを実行すると、コンシューマーに表示権限が与えられているオブジェクトのみが表示されます。しかし、 DEBUG モードでは、アプリ内のすべてのオブジェクトを見ることができます。

デバッグモードについて¶

デバッグモードでは、アプリ内のすべてのオブジェクトを表示および変更できます。コンシューマーには表示されないオブジェクト、たとえばデータベースロールに付与されていないオブジェクトや共有コンテンツオブジェクトは、このモードでは表示されます。

デバッグモードでアプリをテストするには、以下のことが必要です。

• アプリは開発モードで作成する必要があります。つまり、ステージ上の特定のバージョンまたはファイルに基づいている必要があります。

• アプリのデバッグモードを明示的に有効にする必要があります。

アプリのデバッグモードを有効にするには、次の例に示すように ALTER APPLICATION コマンドを使用します。

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = TRUE;

このコマンドは、 hello_snowflake_app というアプリのデバッグモードをオンにします。同様に、デバッグ・モードをオフにするには、次の例に示すように同じコマンドを使用します。

ALTER APPLICATION hello_snowflake_app SET DEBUG_MODE = FALSE;

このコマンドは、 hello_snowflake_app というアプリのデバッグモードをオフにします。

セッションデバッグモードを使用するために必要な権限¶

セッション・デバッグ・モードを使用してアプリのオブジェクトを表示するには、以下の要件があります。

• アプリは、 開発モード で作成する必要があります。このモードでは、特定のバージョンに基づいてアプリを作成するか、ステージにあるファイルに基づいてアプリを作成する必要があります。

• アプリのベースとなるアプリケーションパッケージと同じアカウントである必要があります。

• アプリの OWNERSHIP 権限が必要です。

• アプリケーションパッケージには DEVELOP の権限が必要です。

アプリのセッションデバッグモードの有効化¶

現在のセッションのアプリでセッション・デバッグ・モードを有効にするには、次の例に示すように SYSTEM$BEGIN_DEBUG_APPLICATION システム関数を使用します。

SELECT SYSTEM$BEGIN_DEBUG_APPLICATION('hello_snowflake_app');

この関数は、 hello_snowflake_app というアプリのセッションデバッグモードを有効にします。

以下の例のように、アプリの実行モードを指定することで、セッション・デバッグを有効にすることもできます。

SYSTEM$BEGIN_DEBUG_APPLICATION( 'hello_snowflake_app', execution_mode ='AS_APPLICATION')

この関数は、 hello_snowflake_app アプリの実行モードを AS_APPLICATION にセットします。このモードでは、コンシューマーアカウントで作成されたアプリと同じ権限を使用して、すべてのステートメントを実行します。

現在のセッションのアプリのセッションデバッグステータスの表示¶

現在のセッションのセッション・デバッグ・ステータスを表示するには、次の例に示すように、 SYSTEM$GET_DEBUG_STATUS システム関数を使用します。

SELECT SYSTEM$GET_DEBUG_STATUS();

アプリのセッションデバッグモードの無効化¶

現在のセッションでアプリのセッション・デバッグ・モードを無効にするには、次の例に示すように、 SYSTEM$END_DEBUG_APPLICATION システム関数を使用します。

SELECT SYSTEM$END_DEBUG_APPLICATION();

アプリのテスト時にプロバイダーデータの再編集を無効にするために必要な権限¶

アプリのプロバイダーデータの再編集を無効にするには、以下の権限が必要です。

• アプリは開発モードで作成する必要があります。つまり、ステージ上の特定のバージョンまたはファイルに基づいている必要があります。

• アプリケーションは、アプリケーションパッケージを含む同じアカウント内で作成する必要があります。

• アプリの OWNERSHIP 権限が必要です。

• アプリケーションパッケージには DEVELOP の権限が必要です。

プロバイダーデータの情報再編集の無効化¶

アプリの情報を無効にするには、次の例に示すように、 ALTER APPLICATION コマンドを使用します。

ALTER APPLICATION hello_snowflake_app SET DISABLE_APPLICATION_REDACTION = TRUE;

このコマンドは、 hello_snowflake_app というアプリのプロバイダーデータの再編集を無効にします。

プロバイダー・データの再編集を有効にするには、次の例と同じコマンドを使用します。

ALTER APPLICATION hello_snowflake_app SET DISABLE_APPLICATION_REDACTION = FALSE;

開発モードの違い¶

開発モードでは、以下のいずれかに基づいてアプリが作成されます。

• ステージングされたファイル。

• アプリケーションパッケージで定義されたバージョンまたはパッチ。

開発モードでローカルにイベント共有をテストする場合、リストから作成されたアプリとは動作に違いがあります。

• イベント共有を有効にするには、 MANAGE EVENT SHARING グローバル権限は必要ありません。

• 共有イベントはローカルイベントテーブルに集められます。ローカル・イベント・テーブルでは、プロバイダーは1つのイベントに2つのエントリーを見ることができます。

  • アプリがインストールされたときにコンシューマー側でアプリが発するイベント。

  • プロバイダーと共有されるイベント。

開発モードでのイベント共有のテスト¶

1. ログとイベントトレースを使用するようにアプリを構成する。

2. ローカルの開発アカウントにイベントテーブル をセットアップします。

3. 以下のコマンドのいずれかを実行して、アプリをローカルに作成します。

   CopyExpand

   CREATE APPLICATION hello_snowflake_app
     FROM APPLICATION PACKAGE hello_snowflake_package
     USING @path_to_staged_files
     AUTHORIZE_TELEMETRY_EVENT_SHARING = TRUE;
   
   CREATE APPLICATION hello_snowflake_app
     FROM APPLICATION PACKAGE hello_snowflake_package
     USING VERSION v1_0
     PATCH 0
     AUTHORIZE_TELEMETRY_EVENT_SHARING = TRUE;
   

   Show lessSee more

   Scroll to top

4. イベントテーブルでログメッセージとトレースイベントを表示する.