アプリをアップグレードする¶

アップグレードについて¶

Snowflake Native App Framework では、プロバイダーはアプリを新しいバージョンやパッチにアップグレードすることができます。アプリの新しいバージョンやパッチを開発するための全体的なワークフローの中で、アップグレードがどのように適合するかについては、 アプリ更新のワークフロー をご参照ください。

プロバイダーは、アプリケーションパッケージにリリースディレクティブをセットすることで、アプリケーションの新しいバージョンやパッチへのアップグレードを開始することができます。リリースディレクティブが変更されると、Snowflakeは自動的に現在のバージョンのアプリのインストールされているすべてのインスタンスをリリースディレクティブで指定されたバージョンにアップグレードします。

プロバイダーがアップグレードを開始すると、Snowflakeはアップグレードする各アプリをキューに追加します。各アプリはリソースの可用性に応じてアップグレードされます。アップグレードプロセスは、インストールされているすべてのバージョンのアプリで完了するまでに時間がかかることがあります。アップグレードプロセスを迅速化するために、コンシューマーは、新しいバージョンやパッチが利用可能になったときに、手動でアプリのアップグレードを開始することもできます。

ワークフローのアップグレード¶

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

1. 新しい機能があれば、アプリをアップデートしてください。

2. アプリの新しいバージョンを作成していて、現在アプリに2つのバージョンが定義されている場合：

   1. 現在、そのバージョンを実行しているコンシューマーがいないことを確認してください。

   2. 交換するアプリのバージョンを削除します。

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

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

4. テストアカウントにアプリをインストールして、新しいバージョンをテストしてください。

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

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

アップグレードの開始¶

プロバイダーがアプリケーションパッケージのリリースディレクティブ（デフォルトまたはカスタム）を更新し、新しいバージョンやパッチを指すようにすると、アップグレードプロセスが自動的に開始されます。以下の例に示すように、 ALTER APPLICATION PACKAGE ... RELEASE DIRECTIVE コマンドを使用してリリースディレクティブをセットします。

ALTER APPLICATION PACKAGE my_application_package SET DEFAULT RELEASE DIRECTIVE
  VERSION = v2
  PATCH = 0;

このコマンドは、デフォルトのリリースディレクティブをバージョン v2 とパッチ 0 にセットします。

ALTER APPLICATION PACKAGE my_application_package
  SET RELEASE DIRECTIVE my_custom_release_directive
  ACCOUNTS = ( USER_ACCOUNT.snowflakecomputing.com )
  VERSION = v2
  PATCH = 0;

このコマンドは my_custom_release_directive というカスタムリリースディレクティブを USER_ACCOUNT.snowflakecomputing.com というアカウントのバージョン v2 とパッチ 0 にセットします。

詳細については、 アプリのリリースディレクティブを設定する をご参照ください。

アプリの手動アップグレード¶

手動アップグレードでは、コンシューマーは自動アップグレードよりも早くインストールしたアプリをアップグレードできます。新しいバージョンやパッチが可用性になった場合、プロバイダーはコンシューマーに手動アップグレードの実行を求めることができます。

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

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

ALTER APPLICATION <name> UPGRADE

リージョンをまたいだアプリのアップグレード¶

アプリのアップグレード後、リモートリージョンへの更新が実行されるまで、コンシューマーアカウントにインストールされた Snowflake Native App の変更が表示されない場合があります。

Data Sharingの更新 スキーマの APPLICATION_STATE ビュー を使って状態をモニターすることができます。アップグレード後の最初の更新から1日以上経過してもアップグレードが完了しない場合は、更新プロセスに問題がある可能性があります。 Snowflakeサポート にお問い合わせください。

プロバイダーが Cross-Cloud Auto-Fulfillment を使用して Snowflake Native App を発行している場合、自動アップグレードは、以下のような複数の要因によってアップグレードに時間がかかることがあります。

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

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

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

アップグレードに、リモート リージョンでアップグレードする必要のある緊急の修正が含まれている場合、プロバイダーはリストの更新頻度をより小さな値に減らすことができます。アカウントレベルの更新頻度のセットに関する情報は、 自動履行設定の監視と管理 をご参照ください。

注意

更新頻度を下げると、複製に関連するコストが増加する可能性があります。

アップグレード状態¶

アップグレードの過程で、アプリはさまざまな状態を通過します。次の図は、旧バージョンv1から新バージョンv2へのアップグレード時に考えられる状態を示しています。

次の表は、アプリケーションパッケージが配置されているリージョンと同じリージョン内のアプリのアップグレードプロセスの各ステージを示しています。

次の表は、リモートリージョンにデプロイされたアプリのアップグレード手順を示しています。

次の表では、アップグレード処理で考えられる各状態について説明します。

アップグレード状況のモニター¶

アプリのアップグレード状態を表示するには、 APPLICATION_STATE ビュー を使用します。

たとえば、デフォルトのリリースディレクティブを更新し、すべてのアプリがターゲットバージョンに達したかどうかを確認したい場合です。アップグレードが完了していないアプリケーション・インスタンスを検索するには、次の例のクエリを使用します。

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

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

アップグレードに関する問題のトラブルシューティング¶

Snowflake Native App Framework には、アップグレードのトラブルシューティングの方法がいくつか用意されています。

無効化されたアプリ¶

コンシューマーアカウントにインストールされたアプリが無効になると、そのアプリは使用できなくなります。コンシューマーアカウントにインストールされたアプリは、以下のような複数の理由で使用できなくなる可能性があります。

• アプリケーションパッケージの問題点

• インストールされたアプリケーションの問題

• コンシューマーアカウントに関する問題

プロバイダーもコンシューマーも、アプリが長期間使用できない状態を避けるべきです。無効化されたアプリは使用できなくなり、再インストールする必要があります。