Snowflake Native App の更新とアップグレード¶

バージョンとパッチの相違¶

プロバイダーがアプリの新バージョンを公開するとき、 Snowflake Native App Framework はアプリの旧バージョンのみがアクティブであることを確認します。たとえば、プロバイダーがアプリのV1とV2を公開した場合、 Snowflake Native App Framework は、V3にアップグレードする前に、V2のみが現在コンシューマアカウントにインストールされていることを確認します。これにより、セットアップスクリプトはV2とV3の相違だけを考慮すればよいことになります。つまり、セットアップスクリプトは、アプリの最新バージョンとしか後方互換性がないということです。プロバイダーがアプリの状態を変更する場合、たとえば、新しいテーブルを作成したり、テーブルに列を追加したりしても、バージョン間の互換性に問題はありません。

対照的に、プロバイダーがアプリのバージョンに対して新しいパッチを公開するとき、 Snowflake Native App Framework は実行中のアクティブなパッチの数に対する制限を強制しません。プロバイダーは、パッチでアプリの状態を変更することは避ける必要があります。

リージョン間のアップグレードについて¶

リージョン間でインストール済みアプリをアップグレードする方法については、 複数リージョンでインストール済みアプリをアップグレードする をご参照ください。

バージョンやパッチの追加・削除に必要な権限¶

アプリケーションパッケージのバージョンやパッチを指定するには、そのアプリケーションパッケージのロールに以下のいずれかの権限が付与されている必要があります。

• OWNERSHIP

• MANAGE VERSIONS

たとえば、アプリケーションパッケージの MANAGE VERSION 権限を release_mgr ロールに付与するには、次の例に示すように GRANT <権限> コマンドを使用します。

GRANT MANAGE VERSIONS ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;

SQL を使用してアプリケーションパッケージにバージョンを追加する¶

次の例では、 ALTER APPLICATION PACKAGE コマンドを使用してアプリケーションパッケージにバージョンを追加する方法を示します。

ALTER APPLICATION PACKAGE MyAppPackage
  ADD VERSION v1_0
  USING '@dev_stage/v1_0'
  LABEL = 'MyApp Version 1.0';

この例では、 v1_0 は、コンシューマーがアプリケーションをインストールするときには表示されないバージョンの識別子です。コンシューマーには、 LABEL 句で定義されたバージョン情報が表示されます。

同時に存在できるアプリケーションのバージョンは2つのみです。たとえば、アプリケーションでv1_0とv1_1を定義した場合、v1_2を作成するにはv1_0をドロップする必要があります。ただし、1つのバージョンに複数のパッチを適用することはできます。

バージョン名とラベルは、 manifest.yml ファイルで定義するか、 ALTER APPLICATION PACKAGE コマンドで直接指定できます。SQL コマンドと同様に manifest.yml ファイルで定義した場合は、 SQL コマンドで指定した値が manifest.yml ファイルで指定した値よりも優先されます。

SQL を使用してアプリケーションパッケージにパッチを追加する¶

アプリのバージョンを作成するだけでなく、特定のバージョンのパッチを作成することもできます。バージョンと同様に、アプリパッチにも独自のアプリケーションファイルがあります。

アプリケーションパッケージの新しいパッチを作成するには、次の例に示すように ALTERAPPLICATIONPACKAGE ... VERSION コマンドの ADD PATCH FOR VERSION 句を使用します。

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

この例では、パッチ番号は ADD PATCH FOR VERSION V1_0句には提供されません。この場合、Snowflakeは自動的にパッチ番号を1だけインクリメントします。

カスタムパッチ番号でアプリケーションの新しいパッチを作成するには、次の例に示すように ALTERAPPLICATIONPACKAGE ... VERSION コマンドの ADD PATCH FOR VERSION 句にパッチ番号を提供します。

ALTER APPLICATION PACKAGE MyAppPackage
 ADD PATCH 3
 FOR VERSION V1_0
 USING '@dev_stage/v1_0_p1;

アプリケーションパッケージのバージョンおよびパッチを表示する¶

プロバイダーとして、アプリケーションパッケージに対して SHOW VERSIONS コマンドを実行すると、アプリケーションに定義されたバージョンとパッチを表示することができます。

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

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

アプリケーションパッケージからバージョンを削除する¶

アプリケーションパッケージからバージョンを削除するには、削除したいバージョンを指すリリースディレクティブが現在存在しないことを確認する必要があります。

アプリケーションパッケージで指定されたリリースディレクティブを表示するには、次の例のように SHOW RELEASE DIRECTIVES コマンドを実行します。

SHOW RELEASE DIRECTIVES IN APPLICATION PACKAGE hello_snowflake_package;

アプリケーションパッケージからバージョンを削除するには、次の例に示すように ALTER APPLICATION PACKAGE コマンドの DROP VERSION 句を使用します。

ALTER APPLICATION PACKAGE hello_snowflake_package
  DROP VERSION v1_0;

このコマンドの実行後も、アプリのインストール済みインスタンスがすべて削除されるまで、バージョンはドロップされません。ドロップコマンドのステータスを確認するには、次の例のように SHOW VERSIONS を使用します。

SHOW VERSIONS IN APPLICATION PACKAGE hello_snowflake_package;

dropped_on 列には、ドロップが開始されたときのタイムスタンプが一覧表示されます。

あるバージョンが削除されると、コンシューマーはそのバージョンのアプリを新たにインストールすることができなくなります。

アプリケーションがどのようにコンシューマーに公開されるかによって、バージョンがドロップされるまでにかかる時間は異なります。

• アプリケーションパッケージがコンシューマーに公開されていない場合、そのバージョンは直ちにドロップされます。

• アプリケーションパッケージが1つのリージョン内でパブリックリストまたはプライベートリストとして公開されている場合、そのバージョンは直ちにドロップされます。

• アプリケーションパッケージが、アプリケーションパッケージと同じリージョン内で共有されるリストのデータ製品として公開された場合、そのバージョンは数時間以内にドロップされます。

• アプリケーションパッケージが クロスクラウド自動複製 を使用したリストのデータ製品として公開されている場合、すべてのリージョンでバージョンがドロップされるまでに時間がかかることがあります。

リリースディレクティブの設定に必要な権限¶

リリースディレクティブを設定するには、プロバイダーは MANAGE RELEASES 権限かアプリケーションパッケージの所有権を持っていなければなりません。

GRANT MANAGE RELEASES ON APPLICATION PACKAGE hello_snowflake_package
  TO ROLE release_mgr;

アプリケーションパッケージのデフォルトリリースディレクティブを設定する¶

SET DEFAULT RELEASE DIRECTIVE を指定して ALTER APPLICATION PACKAGE を使用し、以下の例に示すようにデフォルトのリリースディレクティブを設定します。

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = v1_0
  PATCH = 2;

アプリケーションパッケージのデフォルトリリースディレクティブを更新するには、再度 SET DEFAULT RELEASE DIRECTIVE で ALTER APPLICATION PACKAGE コマンドを実行し、適宜 VERSION と PATCH に新しい値を指定します。

アプリケーションパッケージにカスタムリリースディレクティブを設定する¶

カスタムリリースディレクティブを追加するには、 SET RELEASE DIRECTIVE を指定して ALTER APPLICATION PACKAGE コマンドを使用します。ACCOUNTS 句を使用して、このリリースディレクティブが適用されるアカウントを指定します。例:

ALTER APPLICATION PACKAGE hello_snowflake_package
  SET RELEASE DIRECTIVE hello_snowflake_package_custom
  ACCOUNTS = (CONSUMER_ORG.CONSUMER_ACCOUNT)
  VERSION = v1_0
  PATCH = 0;

カスタムリリースディレクティブを更新する¶

リリースディレクティブに基づいてアプリケーションパッケージを作成するには、次の例に示すように MODIFY RELEASE DIRECTIVE を指定して ALTER APPLICATION PACKAGE コマンドを使用します。

ALTER APPLICATION PACKAGE hello_snowflake_package
  MODIFY RELEASE DIRECTIVE hello_snowflake_package_custom
  VERSION = v1_0
  PATCH = 0;

しかし、リリースディレクティブに関連付けられたアカウントを変更することはできません。リリースディレクティブに関連する組織とアカウントを変更するには、以下を実行します。

1. アプリケーションパッケージからリリースディレクティブを削除するには、 UNSET RELEASE DIRECTIVE を指定して ALTER APPLICATION PACKAGE コマンドを実行します。

2. SET RELEASE DIRECTIVE を指定して ALTER APPLICATION PACKAGE を実行し、 ACCOUNTS 句を使用してアカウントのリストを指定し、リリースディレクティブをアプリケーションパッケージに戻します。

カスタムリリースディレクティブを削除する¶

アプリケーションパッケージからカスタムリリースディレクティブを削除するには、次の例に示すように UNSET RELEASE DIRECTIVE を指定して ALTER APPLICATION PACKAGE コマンドを使用します。

ALTER APPLICATION PACKAGE hello_snowflake_package
  UNSET RELEASE DIRECTIVE hello_snowflake_package_custom;

リリースディレクティブを使用してバージョンとパッチをテストする¶

開発モードのアプリケーションパッケージからアプリケーションをインストールする場合は、バージョンとパッチを明示的に指定します。ただし、以下のコマンドを使用してアプリケーションをインストールすると、次のようになります。

CREATE APPLICATION hello_snowflake
  FROM APPLICATION PACKAGE hello_snowflake_package

リリースディレクティブが、このコマンドを実行したときにインストールされるバージョンを決定する。

Snowflake Native App をアップグレードするワークフロー¶

プロバイダーは、以下のワークフローを使用して、インストール済みアプリをアップグレードします。

1. アプリケーションパッケージのアプリケーションロジックとセットアップスクリプトを更新します。

2. 現在2つのバージョンが定義されている場合は、アプリケーションパッケージからバージョンを削除します。

3. アプリケーションパッケージの変更に対して、新しいバージョンまたはパッチを作成します。

   アプリケーションの DISTRIBUTION プロパティが EXTERNAL に設定されている場合、 自動セキュリティスキャン が開始されます。アップグレードを行う前に、セキュリティスキャンに合格する必要があります。

4. プロバイダーのテストアカウントに APPLICATION オブジェクトを作成して、新しいバージョンをテストします。

5. バージョンやパッチのリリースディレクティブを更新します。

   これにより自動アップグレードが開始され、インストールされているすべての旧バージョンのインスタンスが更新されます。プロバイダーは、アップグレードが可能であることをコンシューマーに通知し、 手動アップグレード を実行するよう求めることができます。

複数リージョンでインストール済みアプリをアップグレードする¶

プロバイダーが Snowflake Native App を クロスクラウド自動複製 を使用して公開する場合、自動アップグレードでは以下の要因によってアップグレードに時間がかかることがあります。

• リフレッシュスケジュールの値。

• アプリのインストール済みインスタンス数。

• アプリが展開されているリージョン数。

アップグレードに緊急の修正が含まれ、リモートリージョンでのアップグレードが必要な場合、プロバイダーはアップグレードをより迅速に実行するために以下の方法を検討することができます。

• リストの更新頻度を減らす。

  注釈

  更新頻度を下げると、複製に関連するコストが増加する可能性があります。詳細については、 クロスクラウド自動複製の構成 をご参照ください。

• コンシューマーに 手動アップグレード を実行するよう依頼します。

インストール済みアプリの手動アップグレードを実行する¶

手動アップグレードは、コンシューマーがアプリケーションパッケージで指定されたリリースディレクティブを使用して、インストール済みアプリのバージョンやパッチのアップグレードを開始することを可能にします。

インストール済み Snowflake Native App を利用可能な最新バージョンにアップグレードするには、コンシューマーは ALTER APPLICATION コマンドの UPGRADE 句を使用してアプリケーションオブジェクトを変更することができます。

ALTER APPLICATION <name> UPGRADE

アップグレードのステータスを表示する¶

アプリのアップグレード状態を表示するには、次の例のように APPLICATION_STATE ビュー システムビューを使用します。

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

このビューには、アップグレードの状態やアプリが展開されているリージョンなど、アップグレードに固有の列が含まれています。