コンシューマー管理のメンテナンスポリシー：プロバイダーガイド¶

コンシューマー管理のメンテナンスポリシーにより、コンシューマーはアカウントで Snowflake Native App のアップグレードが発生するタイミングを定義できます。新しいバージョンをリリースするとすぐにアップグレードが行われるのではなく、コンシューマーは操作に適したメンテナンスウィンドウまでアップグレードを遅らせることができます。コンシューマーがメンテナンスポリシーを作成および管理する方法の情報については、コンシューマー管理のメンテナンスポリシーをご参照ください。

プロバイダーとして、次を実行する必要があります。

リリースディレクティブでメンテナンスウィンドウのアップグレードを有効にします。
コンシューマーがアップグレードを無期限に延長できないように、アップグレード期限を設定します。
オプションで、 Snowpark Container Services コンピューティングプールのノードメンテナンスをコンシューマーのメンテナンスウィンドウに合わせます。このような調整は、コンシューマーの混乱を最小限に抑えるため、推奨されます。

メンテナンスウィンドウのアップグレードの有効化¶

リリースディレクティブをセットするときに、UPGRADE_IN_MAINTENANCE_WINDOWパラメーターをTRUEに設定することで、アップグレードがコンシューマーのメンテナンスポリシーを尊重するように指定することができます。また、UPGRADE_DEADLINEパラメーターを設定し、アップグレードを完了する必要がある最新の日時を定義する必要もあります。この期限を過ぎると、コンシューマーのメンテナンスポリシーに関係なくアップグレードが行われます。

メンテナンスウィンドウのアップグレードを有効にするには、次の例に示すように ALTER APPLICATION PACKAGE ... MODIFY RELEASE CHANNEL コマンドを使用します。

ALTER APPLICATION PACKAGE my_app_package
  MODIFY RELEASE CHANNEL DEFAULT
  SET DEFAULT RELEASE DIRECTIVE
  VERSION = v1_0
  PATCH = 2
  UPGRADE_IN_MAINTENANCE_WINDOW = TRUE
  UPGRADE_DEADLINE = '2026-2-10T10:00:00Z';

このコマンドは、メンテナンスポリシーを持つコンシューマーが、次のメンテナンスウィンドウまでアップグレードを延期できるように、リリースディレクティブを構成します。最大で2026年2月10日の10:00 AMです。

注釈

UPGRADE_DEADLINEパラメーターは、UPGRADE_IN_MAINTENANCE_WINDOWがTRUEに設定されている場合に必要です。期限は、コンシューマーがメンテナンスウィンドウ内にアップグレードを完了するのに十分な時間を確保する日付と時刻に設定します。
UPGRADE_AFTERおよびUPGRADE_IN_MAINTENANCE_WINDOWパラメーターを同時に設定することはできません。両方を設定しようとすると、コマンドはエラーで失敗します。

コンピューティングプールの自動メンテナンスを有効にする¶

アプリで Snowpark Container Services を使用する場合により、コンピューティングプールノードのソフトウェアのアップグレードをコンシューマーのメンテナンスウィンドウに合わせることができます。この設定がないと、アプリケーションのアップグレードとコンピューティングプールノードのメンテナンスが、異なる時期に発生する可能性のある別の懸念事項になります。自動アプリケーションメンテナンスを有効にすることで、両方がコンシューマーの選択したメンテナンスウィンドウに調整されます。

これを有効にするには、アプリケーションパッケージのAUTOMATIC_APPLICATION_MAINTENANCEプロパティを設定します。

ALTER APPLICATION PACKAGE my_app_package
  SET AUTOMATIC_APPLICATION_MAINTENANCE = TRUE;

これを有効にすると、 Snowpark Container Services コンピューティングプールノードのソフトウェアのアップグレードは、コンシューマーのメンテナンスウィンドウ中に実行されるようにスケジュールされます。アプリケーションが最初にアップグレードされ、その後にコンピューティングプールノードのメンテナンスが続きます。

コンシューマーにメンテナンスポリシーがある場合¶

UPGRADE_IN_MAINTENANCE_WINDOWをTRUEに設定してアップデートをリリースすると、次が発生します。

コンシューマーがメンテナンスポリシーを設定している場合、アップグレードは、コンシューマーのポリシーによって定義された次のメンテナンスウィンドウまで、またはアップグレード期限までのどちらかに到達するまで延期されます。
コンシューマーがメンテナンスポリシーを設定していない場合、デフォルトのシステムメンテナンスウィンドウ中にアップグレードが行われます。
AUTOMATIC_APPLICATION_MAINTENANCEが有効な場合、アプリケーションコードが最初にアップグレードされ、その後に任意の Snowpark Container Services コンピューティングプールのノードメンテナンスが実行されます。これらはすべて同じメンテナンスウィンドウ内で実施されます。