チュートリアル1: 基本的なSnowflake Native Appsを作成する¶

このチュートリアルで学べること¶

このチュートリアルでは、次の方法を学びます。

• アプリのデータとビジネスロジックを含むアプリケーションパッケージを作成する。

• アプリケーションパッケージとデータを共有する。

• アプリケーションパッケージにビジネスロジックを追加する。

• アプリをローカルでテストする。

• Snowsight でアプリを表示およびテストする。

• プライベートリストを作成してアプリを公開する。

• プライベートリストからアプリをインストールする。

• Snowflake CLI を使用して、上記のステップの多くを実行する。

プロバイダーとコンシューマーについて¶

Snowflake Native App Framework のコンテキストでは、プロバイダーとは、コンシューマーである他のSnowflakeユーザーと共有するデータやビジネスロジックを持つロールや組織のことです。コンシューマーは、組織内の別のアカウント、会社内の別の組織、または別の会社のSnowflakeユーザーである場合があります。

このチュートリアルの文脈では、あなたが実行するタスクのほとんどはプロバイダーが通常実行するタスクですが、 アプリケーション開発者やデータベース管理者など、組織内の複数のロールが実行するタスクも含まれます。

このチュートリアルでは、コンシューマーがアプリをインストールするために行うアクションを模倣したタスクも実行します。

前提条件¶

• マシンに Snowflake CLI バージョン 3.0.0 以上がインストールされている必要があります。

• セッションコンテキストが必要であるため、すべての SQL コマンドを同じ SQL コマンドセッションで実行する必要があります。

  たとえば、これを Snowsight で実行するには、作業をしながらすべてのコードを同じワークシートに貼り付けます。セクションからセクションに進むにつれて、各セクションは前のセクションに基づいて構築されます。

• ACCOUNTADMIN ロールを使用して以下のタスクを実行できる必要があります。

  • このチュートリアルで使用するロール（tutorial1_role ロール）を作成します。

  • tutorial1_role ロールに必要な権限を付与します。

  • アプリのリストを作成します。

  このチュートリアルでは、 tutorial1_role ロールを使用して、基本的な Snowflake Native App を作成する手順を実行します。ただし、一般的には、実行するアクションに対して特別に定義された権限を持つロールを使用します。例えば、次のようなユーザーに別々のロールを設定することができます。

  • UDFs とストアドプロシージャを作成する開発者

  • ロールと権限を管理するデータベース管理者

  • Snowflake Collaboration を使用して リストを管理する 管理者

• プライベートリストからアプリをインストールするには、2つ目のSnowflakeアカウントにアクセスする必要があります。このアカウントを使用して、コンシューマーがアプリをインストールする方法を模倣します。

  注釈

  Snowflake Native App Framework は、異なる組織のアカウントによるアプリの共有をサポートしていますが、このチュートリアルでは、両方のアカウントが同じ組織に属している必要があります。

• 現在のウェアハウスを設定する必要があります。 USE WAREHOUSE をご参照ください。

新しいプロジェクトフォルダーの初期化¶

Snowflake CLI を使って、ローカルのファイルシステムにある新しい Snowflake Native App プロジェクトを初期化します。

これを実行するには、

1. 次のコマンドを実行します：

   snow init --template app_basic tutorial
   

   Copy

2. プロジェクト識別子の値を入力してください。

   この値は、snowアプリコマンドが生成するエンティティのベース名として使用されます。例えば、 foo と入力すると、アプリケーションパッケージは foo_pkg となり、アプリケーションエンティティは foo となります。ただし、このチュートリアルでは、プロジェクト定義ファイル（snowflake.yml）の内容を置き換えるので、プロジェクト識別子として指定した値は上書きされます。

このコマンドは、現在の作業ディレクトリ内に tutorial という名前のフォルダーを作成し、基本テンプレートに基づいて基本的な Snowflake Native App プロジェクトを作成します。これは、すべてのアプリケーションファイルのルートディレクトリです。

セットアップスクリプトを作成する¶

app/setup_script.sql ファイルの内容を次のように変更または置き換えます。

-- Setup script for the Hello Snowflake! app.

Copy

この行をプレースホルダーとして追加するのは、セットアップスクリプトを空にはできないためです。

注釈

このチュートリアルでは、セットアップスクリプトの特定の構造とファイル名を参照します。しかし、独自のアプリを構築する際には、このファイルの名前やディレクトリ構造を自分で決めることができます。

アプリの README ファイルを作成する¶

Readmeファイルは、アプリケーションが何をするのかについての説明を提供します。 Snowsight でアプリを表示すると Readme が表示されます。

app/README.md の内容を次のように変更または置き換えます。

This is the readme file for the Hello Snowflake app.

Copy

マニフェストファイルを作成する¶

Snowflake Native App Framework では、アプリごとにマニフェストファイルが必要です。マニフェストファイルには、アプリのメタデータと構成パラメーターが含まれており、アプリの実行時の動作に影響を与えます。

app/manifest.yml の内容を次のように変更または置き換えます。

manifest_version: 1
artifacts:
   setup_script: setup_script.sql
   readme: README.md

setup_script プロパティは、マニフェストファイルの場所に対するセットアップスクリプトの場所を指定します。ここで指定するパスとファイル名は、上記で変更したセットアップスクリプトの相対的な場所と同じである必要があります。 readme プロパティも同じルールに従います。

プロジェクト定義ファイルを作成する¶

Snowflake CLI は、プロジェクト定義ファイルを使用して、Snowflakeにデプロイ可能なオブジェクトを記述します。このファイルの名前は snowflake.yml にする必要があります。このファイルは、デプロイされたアプリケーションパッケージとオブジェクトの名前、およびプロジェクトステージにアップロードされるファイルを制御します。

注釈

このファイルには snowflake.yml という名前を付け、ファイルはプロジェクトのルートレベルに存在する必要があります。 manifest.yml やセットアップスクリプトなどの他のファイルへのパスは、このファイルの場所を基準とします。

snowflake.yml の内容を次のように変更または置き換えます。

definition_version: 2
entities:
   hello_snowflake_package:
      type: application package
      stage: stage_content.hello_snowflake_stage
      manifest: app/manifest.yml
      identifier: hello_snowflake_package
      artifacts:
         - src: app/*
           dest: ./
   hello_snowflake_app:
      type: application
      from:
         target: hello_snowflake_package
      debug: false

Copy

このチュートリアルの次のセクションでは、これらの各プロパティの使用方法について説明します。

このセクションで学んだことを復習する¶

このセクションのステップを実行した後、ディレクトリ構造は次のようになります。

/tutorial
  snowflake.yml
  README.md
  /app/
    manifest.yml
    README.md
    setup_script.sql

このセクションでは、 Snowflake Native App Framework に必要なセットアップスクリプトとマニフェストファイル、およびSnowflake CLI に必要なプロジェクト定義ファイルを作成する方法を学習しました。

セットアップスクリプトとマニフェストファイルの両方に追加した内容は基本的なものですが、すべてのアプリにこれらのファイルが必要です。

また、 Snowsight でアプリを表示するときや、アプリをリストとして公開するときに表示されるReadmeファイルも追加しました。

セットアップスクリプトにストアドプロシージャを追加する¶

このセクションでは、ストアドプロシージャのコードをローカルファイルシステム上のセットアップスクリプトに追加して、アプリにストアドプロシージャを追加します。

セットアップスクリプトにストアドプロシージャを追加するには、

1. このチュートリアルの前のセクションで作成した setup_script.sql ファイルの最後に次の SQL ステートメントを追加します。

   CREATE APPLICATION ROLE IF NOT EXISTS app_public;
   CREATE SCHEMA IF NOT EXISTS core;
   GRANT USAGE ON SCHEMA core TO APPLICATION ROLE app_public;
   

   Copy

   アプリのインストール中にセットアップスクリプトが実行されると、これらのステートメントによって app_public という名前のアプリケーションロールが作成されます。アプリケーションロールはデータベースロールに似ていますが、アプリのコンテキスト内でのみ使用できます。これらは、コンシューマーアカウントで作成されたアプリケーションオブジェクト内のオブジェクトへのアクセスを許可するために使用されます。

   この例では、ストアドプロシージャを格納するスキーマも作成し、そのスキーマの USAGE 権限をアプリケーションロールに付与しています。アプリケーションロールを作成し、スキーマなどのオブジェクトに対する権限をアプリケーションロールに付与することは、セットアップスクリプト内で一般的なパターンです。

2. ストアドプロシージャのコードを setup_script.sql ファイルの最後に追加します。

   CREATE OR REPLACE PROCEDURE CORE.HELLO()
     RETURNS STRING
     LANGUAGE SQL
     EXECUTE AS OWNER
     AS
     BEGIN
       RETURN 'Hello Snowflake!';
     END;
   

   Copy

   この例では、文字列「Hello Snowflake!」を出力するストアドプロシージャを作成します。

3. setup_script.sql ファイルの末尾に次のステートメントを追加します。

   GRANT USAGE ON PROCEDURE core.hello() TO APPLICATION ROLE app_public;
   

   Copy

   この例では、ストアドプロシージャに対する USAGE 権限をアプリケーションロールに付与しています。

このセクションでは、セットアップスクリプトにストアドプロシージャを追加しました。また、アプリケーションロールを作成し、このロールに USAGE 権限を付与しました。これにより、アプリのインストール時にセットアップスクリプトによってストアドプロシージャが作成されます。また、ストアドプロシージャを実行する権限もアプリに付与します。

ステージ開発モードでアプリをインストールしてテストする¶

これで、アプリケーションパッケージ、アプリ、プロジェクト定義ファイルで指定したその他すべてのエンティティを作成する準備が整いました。

これらのタスクを実行するには：

1. ターミナルで、 tutorial フォルダに移動します。

2. 以下のSnowflake CLI コマンドを実行します。

   snow app run -c tut1-connection
   

   Copy

このコマンドは次のタスクを実行します。

1. スキーマ stage_content およびステージ hello_snowflake_stage を使用して、アプリケーションパッケージ名 hello_snowflake_package を作成します。

2. 必要なファイルをすべて名前付きステージにアップロードします。

3. このステージのファイルを使用して、アプリ hello_snowflake_app を作成またはアップグレードします。

コマンドが正常に実行されると、 URL が出力され、アプリが Snowsight に表示されます。

前のセクションで setup_script.sql に追加した HELLO ストアドプロシージャを実行するには、次のSnowflake CLI コマンドを実行します。

snow sql -q "call hello_snowflake_app.core.hello()" -c tut1-connection

このコマンドを実行すると、次のような出力が表示されます。

+------------------+
| HELLO            |
|------------------|
| Hello Snowflake! |
+------------------+

このセクションで学んだことを復習する¶

おめでとうございます。 Snowflake Native App Framework を使用して最初の Snowflake Native App を作成、インストール、テストしました。アプリには基本的な機能しかありませんが、アプリを構築するために使用したコンポーネントは、より複雑なアプリでも同じです。

このセクションでは、以下を完了しました。

• セットアップスクリプトにストアドプロシージャを追加しました。セットアップスクリプトは、コンシューマーアカウントにアプリをインストールする方法を指定します。この後のセクションでは、アプリケーションにデータコンテンツやその他のタイプのアプリケーションロジックを追加します。

• Snowflake CLI を使用して初めてアプリをデプロイしました。

• ストアドプロシージャを実行して、インストールしたアプリをテストしました。

この後のセクションでは、アプリを表示したりテストしたりする他の方法について学びます。

アプリと共有するテーブルを作成する¶

このセクションでは、データコンテンツをアプリと共有する方法を学びます。具体的には、スキーマとテーブルの権限をアプリケーションパッケージに付与することで、プロバイダーアカウントでテーブルを共有します。

1. テーブルを作成し、アプリケーションパッケージにサンプルデータを挿入するには、フォルダー tutorial/scripts を作成し、そのフォルダー内にファイル shared_content.sql を作成します。このファイルに次のコンテンツを追加します。

   USE APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   
   CREATE SCHEMA IF NOT EXISTS shared_data;
   USE SCHEMA shared_data;
   CREATE TABLE IF NOT EXISTS accounts (ID INT, NAME VARCHAR, VALUE VARCHAR);
   TRUNCATE TABLE accounts;
   INSERT INTO accounts VALUES
     (1, 'Joe', 'Snowflake'),
     (2, 'Nima', 'Snowflake'),
     (3, 'Sally', 'Snowflake'),
     (4, 'Juan', 'Acme');
   -- grant usage on the ``ACCOUNTS`` table
   GRANT USAGE ON SCHEMA shared_data TO SHARE IN APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   GRANT SELECT ON TABLE accounts TO SHARE IN APPLICATION PACKAGE <% ctx.entities.hello_snowflake_package.identifier %>;
   

   Copy

   この例では、 <% ctx.entities.hello_snowflake_package.identifier %> はテンプレートで、Snowflake CLI コマンドを実行すると、 snowflake.yml ファイルから application package の解決済み識別子に置き換えられます。

   アプリケーションパッケージ内のオブジェクトにこれらの権限を付与すると、アプリケーションパッケージから作成されたすべてのオブジェクトで shared_data.accounts テーブルを使用できるようになります。この共有は、スクリプトの末尾にある権限 GRANT TO SHARE コマンドによって実行されます。

   注釈

   アプリ内のコンシューマーと共有するスキーマごとに、各スキーマに対する USAGE 権限をアプリケーションパッケージに付与する必要があります。次に、共有するスキーマ内のオブジェクトに SELECT 権限を付与する必要があります。

2. アプリケーションパッケージを更新するときにこのスクリプトが実行されるように、プロジェクト定義ファイルにエントリを追加します。最終的なプロジェクト定義ファイル（Snowflake.yml）は次のようにします。

   definition_version: 2
   entities:
      hello_snowflake_package:
         type: application package
         stage: stage_content.hello_snowflake_stage
         manifest: app/manifest.yml
         identifier: hello_snowflake_package
         artifacts:
            - src: app/*
              dest: ./
         meta:
            post_deploy:
               - sql_script: scripts/shared_content.sql
      hello_snowflake_app:
         type: application
         from:
            target: hello_snowflake_package
         debug: false
   

   Copy

データコンテンツにアクセスするためのビューを追加する¶

このセクションでは、セットアップスクリプトを更新して、アプリをインストールしたコンシューマーが、前のセクションで作成した ACCOUNTS テーブルのデータにアクセスできるようにする表示を追加します。

データコンテンツにアクセスするためのビューを追加するには、

1. ビューのスキーマを作成するには、セットアップスクリプトに以下を追加します。

   CREATE OR ALTER VERSIONED SCHEMA code_schema;
   GRANT USAGE ON SCHEMA code_schema TO APPLICATION ROLE app_public;
   

   Copy

   これらのステートメントは、ビューを含むバージョン管理されたスキーマを作成し、そのスキーマに対する USAGE 権限を付与します。 Snowflake Native App Framework は、バージョン管理されたスキーマを使用して、異なるバージョンのストアドプロシージャや関数を処理します。

2. ビューを作成するには、セットアップスクリプトに以下を追加します。

   CREATE VIEW IF NOT EXISTS code_schema.accounts_view
     AS SELECT ID, NAME, VALUE
     FROM shared_data.accounts;
   GRANT SELECT ON VIEW code_schema.accounts_view TO APPLICATION ROLE app_public;
   

   Copy

   これらのステートメントは、 code_schema スキーマにビューを作成し、ビューに対する必要な権限をアプリケーションロールに付与します。

   この更新されたセットアップスクリプトは、次回Snowflake CLI を使用してアプリをデプロイするときにもステージにアップロードされます。

更新されたアプリをテストする¶

このサブセクションでは、アプリをアップグレードし、インストールされたアプリ内のビューを使用して例のテーブルをクエリします。

アップデートされたアプリをテストするには、以下の手順に従ってください。

1. コンシューマーアカウントにインストールされているアプリケーションパッケージとアプリケーションオブジェクトを更新するには、次のコマンドを実行します。

   snow app run -c tut1-connection
   

   Copy

   これにより、編集されたすべてのファイルがステージにアップロードされ、 scripts/shared_content.sql スクリプトが実行され、ステージ上のファイルを使用してアプリがアップグレードされます。

2. ビューが正しく動作することを確認するには、次のコマンドを実行します。

   snow sql -q "SELECT * FROM hello_snowflake_app.code_schema.accounts_view" -c tut1-connection
   

   Copy

   このコマンドの出力は次のようになります。

   +----+----------+-----------+
   | ID | NAME     | VALUE     |
   |----+----------+-----------|
   |  1 | Joe      | Snowflake |
   |  2 | Nima     | Snowflake |
   |  3 | Sally    | Snowflake |
   |  4 | Juan     | Acme      |
   +----+----------+-----------+
   

   Copy

このセクションで学んだことを復習する¶

このセクションでは、以下のタスクを実行して、共有データコンテンツをアプリに含める方法を学びました。

• アプリケーションパッケージ内に ACCOUNTS テーブルを作成し、そのテーブルにデータを挿入しました。

• アプリケーションパッケージに ACCOUNTS テーブルに対する参照の使用権を付与しました。

• アプリケーションパッケージの ACCOUNTS テーブルを参照するスキーマとビューを作成しました。

• アプリケーションロールにスキーマの使用権を付与しました。

• アプリケーションロールにビューの選択権を付与しました。

また、セットアップスクリプトを更新して、アプリケーションのインストール時に以下を実行するようにしました。

• アプリがサンプルデータにアクセスするために使用するスキーマとビューを作成しました。

• アプリケーションロールにスキーマの使用権を付与しました。

• アプリケーションロールにビューの選択権を付与しました。

インラインPython関数をユーザー定義関数（UDF）として追加する¶

このセクションでは、Python関数を UDF として追加します。

Python UDF をアプリに含めるには、セットアップスクリプト (setup_script.sql) に以下のコードを追加します。

CREATE OR REPLACE FUNCTION code_schema.addone(i int)
RETURNS INT
LANGUAGE PYTHON
RUNTIME_VERSION = '3.11'
HANDLER = 'addone_py'
AS
$$
def addone_py(i):
  return i+1
$$;

GRANT USAGE ON FUNCTION code_schema.addone(int) TO APPLICATION ROLE app_public;

Copy

これらのコマンドは、アプリのインストール時に以下のタスクを実行します。

• code_schema という名前のバージョン管理されたスキーマを作成します。

• APP_PUBLIC アプリケーションロールにスキーマに対する使用権限を付与します。

• code_schema スキーマで ADDONE() UDF を作成します。

• APP_PUBLIC アプリケーションロールに関数に対する使用権限を付与します。

上記のコードの例で作成されたスキーマは、バージョン管理されたスキーマであることに注意してください。ユーザー定義関数とストアドプロシージャは、通常のスキーマではなくバージョン管理されたスキーマで定義する必要があります。これにより、アプリのアップグレードが同時コード実行を妨げることがなくなります。

外部Pythonモジュールを追加する¶

アプリに外部Pythonモジュールを追加するには、次を実行します。

1. 以下のPython関数をセットアップスクリプト(setup_script.sql)に追加します。

   CREATE or REPLACE FUNCTION code_schema.multiply(num1 float, num2 float)
     RETURNS float
     LANGUAGE PYTHON
     RUNTIME_VERSION = 3.9
     IMPORTS = ('/python/hello_python.py')
     HANDLER='hello_python.multiply';
   
   GRANT USAGE ON FUNCTION code_schema.multiply(FLOAT, FLOAT) TO APPLICATION ROLE app_public;
   

   Copy

   前の例と同様に、これらのステートメントはスキーマにPython UDF を作成し、アプリケーションロールに関数に対する権限を付与します。しかし、この例では、 IMPORTS 句があり、あなたが作成し、名前付きステージにインクルードした外部 Python ファイルをリファレンスしています。

2. tutorial フォルダーに python という名前のサブフォルダーを作成します。

3. python サブフォルダーに hello_python.py という名前のファイルを作成します。

4. 次を hello_python.py ファイルに追加します。

   def multiply(num1, num2):
     return num1*num2
   

   Copy

   この外部ファイルで定義された関数は、セットアップスクリプトで定義されたインライン関数と一致します。

5. プロジェクト定義ファイル（Snowflake.yml）の既存の artifacts セクションに以下を追加します。

   - python/hello_python.py
   

   Copy

このセクションでは、アプリにPython UDF を追加しました。この UDF は、アプリケーションパッケージから参照できる外部Pythonモジュールを参照します。

更新されたアプリをインストールしてテストする¶

アプリをインストールしてテストするには:

1. アプリケーションパッケージとアプリを更新するには、次のコマンドを実行します。

   snow app run -c tut1-connection
   

   Copy

   このコマンドは、編集されたファイルと新しいファイルをステージにアップロードし、ステージ上のファイルを使用してアプリをアップグレードします。

2. Pythonストアドプロシージャをテストするには、以下のコマンドを実行します。

   snow sql -q "SELECT hello_snowflake_app.code_schema.addone(1)" -c tut1-connection
   

   Copy

3. 参照されたPython関数をテストするには、以下のコマンドを実行します。

   snow sql -q "SELECT hello_snowflake_app.code_schema.multiply(1,2)" -c tut1-connection
   

   Copy

このセクションで学んだことを復習する¶

このセクションでは、アプリに以下の新機能を追加しました。

• インライン UDF として定義されたPython関数。

• 外部コードを参照する UDF として定義されたPython関数。

また、アプリの更新バージョンをインストールして、各関数を実行し、これらの各例をテストしました。

Streamlitアプリファイルを作成する¶

Streamlitアプリを作成するには、以下の手順に従ってください。

1. tutorial フォルダーに、 streamlit という名前のサブフォルダーを作成します。

2. streamlit フォルダーに、 hello_snowflake.py という名前のファイルを作成します。

3. このファイルに以下のコードを追加します。

   # Import python packages
   import streamlit as st
   from snowflake.snowpark import Session
   
   # Write directly to the app
   st.title("Hello Snowflake - Streamlit Edition")
   st.write(
      """The following data is from the accounts table in the application package.
         However, the Streamlit app queries this data from a view called
         code_schema.accounts_view.
      """
   )
   
   # Get the current credentials
   session = Session.builder.getOrCreate()
   
   #  Create an example data frame
   data_frame = session.sql("SELECT * FROM code_schema.accounts_view")
   
   # Execute the query and convert it into a Pandas data frame
   queried_data = data_frame.to_pandas()
   
   # Display the Pandas data frame as a Streamlit data frame.
   st.dataframe(queried_data, use_container_width=True)
   

   Copy

4. プロジェクト定義ファイル（Snowflake.yml）の既存の artifacts セクションに以下を追加します。

   - streamlit/hello_snowflake.py
   

   Copy

セットアップスクリプトにStreamlitオブジェクトを追加する¶

アプリ内でStreamlitオブジェクトを作成するには、以下の手順に従ってください。

1. setup_script.sql ファイルの末尾に、Streamlitオブジェクトを作成するための以下のステートメントを追加します。

   CREATE STREAMLIT IF NOT EXISTS code_schema.hello_snowflake_streamlit
     FROM '/streamlit'
     MAIN_FILE = '/hello_snowflake.py'
   ;
   

   Copy

   このステートメントはコアスキーマに STREAMLIT オブジェクトを作成します。

2. APP_PUBLIC ロールがStreamlitオブジェクトにアクセスできるように、 setup_script.sql ファイルの末尾に以下のステートメントを追加します。

   GRANT USAGE ON STREAMLIT code_schema.hello_snowflake_streamlit TO APPLICATION ROLE app_public;
   

   Copy

更新されたアプリをインストールする¶

1. アプリケーションパッケージとアプリを更新するには、次のコマンドを実行します。

   snow app run -c tut1-connection
   

   Copy

   このコマンドは、編集されたファイルと新しいファイルをステージにアップロードし、ステージ上のファイルを使用してアプリをアップグレードします。次に、このコマンドが出力する URL に移動して、新しいStreamlitの動作を確認できます。移動したら、アプリケーションの名前の横に表示される HELLO_SNOWFLAKE_STREAMLIT というタブをクリックします。

このセクションで学んだことを復習する¶

このセクションでは、以下を実行してStreamlitアプリを Snowflake Native App に追加しました。

• Streamlitライブラリを使用してユーザーインターフェイスをレンダリングするPythonファイルを作成しました。

• 共有データを表示するStreamlitアプリを Snowflake Native App に作成しました。

デフォルトのリリースディレクティブの設定¶

アプリケーションパッケージのリストを作成する前に、リリースディレクティブを設定する必要があります。リリースディレクティブは、コンシューマーが利用できるアプリのバージョンとパッチを指定します。

このチュートリアルでは、前のセクションで追加したバージョンを使ってデフォルトのリリースディレクティブをセットします。

アプリケーションパッケージにデフォルトのリリースディレクティブをセットするには、以下の手順に従ってください。

1. アプリケーションパッケージに定義されているバージョンとパッチを表示するには、以下のコマンドを実行します。

   snow app version list -c tut1-connection
   

   Copy

   このコマンドは、アプリケーションパッケージに定義されているバージョンとパッチを表示します。

2. デフォルトのリリースディレクティブをバージョン v1_0 とパッチ 0 に設定するには、以下のコマンドを実行します。

   snow sql -q "ALTER APPLICATION PACKAGE hello_snowflake_package SET DEFAULT RELEASE DIRECTIVE VERSION = v1_0 PATCH = 0" -c tut1-connection
   

   Copy

   このコマンドの出力を次の例に示します。

   +-----------------------------------------------------------+
   | status                                                    |
   |-----------------------------------------------------------|
   | Default release directive set to version 'V1_0', patch 0. |
   +-----------------------------------------------------------+
   

   Copy

このセクションでは、アプリケーションパッケージにどのようなバージョンとパッチが存在するかを確認しました。この情報を使用して、アプリケーションパッケージのデフォルトのリリースディレクティブを定義しました。

アプリケーションのリストを作成する¶

アプリケーション・パッケージにリリース指示文を指定したので、リストを作成し、リストのデータ内容としてアプリケーション・パッケージを追加します。これにより、アプリを他のSnowflakeユーザーと共有し、そのユーザーが自身のアカウントにアプリをインストールして使用できるようになります。

アプリのリストを作成するには:

1. Snowsight にサインインします。

2. ナビゲーションメニューで Data Products » Provider Studio を選択します。

3. + Listing を選択し、次に Specified consumers を選択すると、リストを特定のアカウントと非公開で共有できます。

4. Select role ドロップダウンから、 ACCOUNTADMIN を選択します。

5. リストトの名前を入力します。

6. Next を選択します。

7. + Select をクリックして、リストのアプリケーションパッケージを選択します。

8. リストの説明を入力します。

9. Add consumer accounts セクションでは、リストからアプリをインストールするためのコンシューマーエクスペリエンスのテストに使用するアカウントの識別子を追加します。

10. Publish を選択します。

このセクションでは、共有データコンテンツとしてアプリケーションパッケージを含むプライベートリストを作成しました。

コンシューマーアカウントにアプリをインストールする¶

このセクションでは、前のセクションで作成したリストに関連するアプリをインストールします。コンシューマーが自分のアカウントにアプリをインストールする方法を真似て、別のアカウントにリストをインストールします。

リストからアプリをインストールするには、以下の手順に従ってください。

1. Snowsight にサインインします。

2. ナビゲーションメニューで Data Products » Apps を選択します。

3. Recently shared with you にあるリストのタイルを選択します。

4. Get を選択します。

5. Options を選択し、アプリの顧客向けの名前を入力します。このチュートリアルでは、"HelloSnowflakeApp"を使用します。

6. アプリをインストールするウェアハウスを選択します。

7. Get を選択します。

8. Open を選択してリストを表示するか、 Done を選択して終了します。

このセクションでは、アプリを他のSnowflakeユーザーと共有するためのリストを公開し、インストールする方法を学びました。