Snowflake Native App Framework: SHOW APPLICATION と DESC APPLICATION コマンドの変更

注意

この動作変更は2024_07バンドルにあります。

バンドルの現在のステータスについては、 バンドル履歴 をご参照ください。

この動作変更バンドルが有効になっている場合は、 SHOW APPLICATIONS DESCRIBE APPLICATION コマンドの出力に以下の列が含まれます。

SHOW APPLICATIONS コマンドの変更

SHOW APPLICATIONS コマンドの出力には、以下の新しい列が含まれます。

列名

説明

disablement_reasons

Snowflake Native Appが無効化された理由を含む配列。可能性のある理由のリストについては、 無効化されたアプリにおける可能性のあるステータス をご参照ください。

last_upgraded_on

アプリの成功した最終アップグレードのタイムスタンプ。アップグレードに成功しなかった場合は、タイムスタンプが空です。

DESCRIBE APPLICATION コマンドの変更

変更前:

これまで、アプリが無効になっている場合、 DESCRIBE APPLICATION コマンドはアプリが無効であることを示すエラーコードを返していました。

変更後:

DESCRIBE APPLICATION コマンドは成功し、アプリが無効になった理由が出力の新しい列に含まれます。

列名

説明

disablement_reasons

Snowflake Native Appが無効化された理由を含む配列。可能性のある理由のリストについては、 無効化されたアプリにおける可能性のあるステータス をご参照ください。

無効化されたアプリにおける可能性のあるステータス

次のテーブルは、 DISABLEMENT_REASONS 列の可能な値のリストです。

ステータスの説明

回復可能か?

MANUALLY_DISABLED

アプリはSnowflakeによって無効化されます

あり。アプリを再度有効にするには、 Snowflakeサポート にお問い合わせください。

ACCOUNT_INACTIVE

アカウントがロックまたは停止されてアクティブでなくなると、アプリは利用できなくなります。この状態では、コンシューマーは自分のアカウントで SQL クエリを実行できず、アプリはアップグレードできません。

あり。アカウントのロックまたは停止が解除されると、アプリは自動的に再有効化されます

PACKAGE_VERSION_IS_MISSING

アプリのアプリケーションパッケージのバージョンは、プロバイダーによってドロップされました。アプリは使用できなくなり、有効なリストまたはアプリケーションパッケージからドロップして再インストールする必要があります

不可。

CMK_ACCESS_DENIED

コンシューマーは暗号化キーを自分で管理し(ENCRYPT_USE_CMK_KMS が有効)、Snowflakeはこのキーにはアクセスできません。

あり。アプリを再有効化するには、 CMK を取得するクラウドプロバイダーの構成が正しく、Snowflakeがキーにアクセスできることを確認します。

LISTING_ACCESS_REVOKED

このアプリを作成するために使用されたリストは利用できなくなりました。以下が、このような状態になった理由として考えられます。

  • プロバイダーがリストを削除した

  • プロバイダーがコンシューマーアカウントから非公開リストへのアクセスを手動で削除した

可能性あり。回復可能性は、アクセスが取り消された理由によって異なります。

たとえば、リストが削除された場合は回復できません。コンシューマーアカウントが非公開リストから手動で削除された場合、リストとアプリへのアクセスは復元できます。

LISTING_TRIAL_USAGE_EXCEEDED

このアプリケーションは、従量制試用リストの使用上限を超えました。

無し

LISTING_PAYMENT_REQUIRED

アプリをインストールするために使用されるリストは有料リストであり、さらなる使用には支払いが必要です。

あり。コンシューマーはアプリの支払いを正しく設定する必要があります。

LISTING_TRIAL_TIME_EXCEEDED

アプリケーションの試用期間を超過しました。

無し

APPLICATION_PACKAGE_NOT_AVAILABLE

アプリの作成に使用したアプリケーションパッケージが存在しなくなりました。プロバイダーが対応するアプリケーションパッケージをドロップした可能性があります。

無し

APPLICATION_PACKAGE_DISABLED

アプリの作成に使用されたアプリケーションパッケージは、Snowflakeによって無効化されました。

あり。Snowflakeがアプリケーションパッケージを再有効化すると、アプリは再有効化されます。

APPLICATION_SUSPENDED

アプリが無効化されたため、タスク、サービス、コンピューティングプールなどのアプリリソースが中断されました。

中断されたオブジェクトは、アプリが無効化された他の理由がなければ、アプリが再有効化されるまで中断されたままになります。

有り

APPLICATION_SUSPEND_RESUME_IN_PROGRESS

アプリのリソース(例: タスク、サービス、コンピューティングプール)は現在再開中です。

有り