スキーマ:

DATA_SHARING_USAGE

APPLICATION_STATE ビュー

DATA_SHARING_USAGE スキーマのこのビューは、現在のアカウントにあるすべてのアプリケーションパッケージのリストから、インストールされたアプリに関する情報を表示するために使用できます。

リストが クロスクラウド自動複製 を使用して公開された場合、このビューにはすべてのリージョンにわたってインストールされたアプリの情報が表示されます。

列名

データ型

説明

CONSUMER_SNOWFLAKE_REGION

VARCHAR

アプリがインストールされているコンシューマーアカウントのSnowflakeリージョン。

CONSUMER_ORGANIZATION_NAME

VARCHAR

コンシューマーアカウントの組織名。

CONSUMER_ACCOUNT_LOCATOR

VARCHAR

コンシューマーアカウントロケーター。

CONSUMER_ACCOUNT_NAME

VARCHAR

コンシューマーアカウント名。

PROVIDER_SNOWFLAKE_REGION

VARCHAR

アプリケーションパッケージを作成したプロバイダーアカウントのSnowflakeリージョン。

PROVIDER_ACCOUNT_LOCATOR

VARCHAR

プロバイダーアカウントロケーター

PROVIDER_ACCOUNT_NAME

VARCHAR

プロバイダーアカウント名。

PACKAGE_NAME

VARCHAR

アプリケーションがインストールされたプロバイダーのアカウントにあるアプリケーションパッケージの現在の名前。

APPLICATION_NAME_HASH

VARCHAR

コンシューマーアカウントにインストールされたアプリインスタンス名のハッシュ文字列。コンシューマーは、 SHA1 関数を使用して、インストールされたアプリケーションのハッシュ値を計算します。コンシューマーは、プロバイダーに連絡する際にこの値を使用できます。

CREATED_ON

DATETIME

アプリインスタンスが最初にインストールされたタイムスタンプ。

CURRENT_VERSION

VARCHAR

アプリの現在のバージョン。

CURRENT_PATCH

INT

アプリの現在のパッチレベル。

CURRENT_INSTALLED_ON

DATETIME

現在のバージョンのアプリがインストールされたタイムスタンプ。

PREVIOUS_VERSION_STATE

VARCHAR

以前の前バージョンの状態。可能な値は COMPLETE と FINALIZING です。

  • COMPLETE は、アップグレードが完了し、以前のバージョンからのクエリがある場合は、それらが実行中ではないことを示します。

  • FINALIZING はインスタンスが以前のバージョンからアップグレードされたことを示しますが、1つ以上のクエリが以前のバージョンを使用してまだ実行されている可能性があります。

PREVIOUS_VERSION

VARCHAR

アプリの以前のバージョン。

PREVIOUS_PATCH

INT

アプリの以前のパッチレベル。

UPGRADE_STATE

VARCHAR

アプリのバージョンアップグレードの状態。可能な値は次のとおりです。

  • INSTALLING: アプリケーションオブジェクトは作成中です。

  • INSTALL_FAILED: アプリケーションオブジェクトの作成に失敗しました。アプリケーションオブジェクトは、ドロップされるまで INSTALL_FAILED の状態を維持します。インストールやアップグレードに失敗した原因については、 DESCRIBE APPLICATION コマンドの UPGRADE_FAILURE_REASON 列をご参照ください。

  • COMPLETE: セットアップスクリプトが正常に完了し、アプリケーションオブジェクトが作成またはアップグレードされました。

  • QUEUED: アプリケーションオブジェクトはアップグレードのためにキューに入っています。

  • UPGRADING: アプリケーションオブジェクトはアップグレード中です。

  • FAILED: すべてのアップグレード試行に失敗しました。失敗の理由(ある場合)が UPGRADE_FAILURE_REASON 列にリストされます。インスタンスは、 TARGET_UPGRADE_VERSION 列で定義されているように、リリースディレクティブがアップグレードのターゲットとしていたバージョンとは異なるバージョンをポイントするように更新されるまで、 FAILED の状態のままです。

  • QUEUED_RETRY: インスタンスは1つ以上のアップグレード試行に失敗しました。失敗の理由は UPGRADE_FAILURE_REASON で示されます: インスタンスは別のアップグレードを実行するためにキューに入っています。

  • DISABLED: アプリケーションオブジェクトとそのアップグレードが無効になりました。この状態では、コンシューマーはインスタンスにアクセスできなくなり、アップグレードの対象とはみなされず、アプリケーションパッケージのバージョンドロップはブロックされません。失敗の理由(ある場合)が UPGRADE_FAILURE_REASON 列にリストされます。

TARGET_UPGRADE_VERSION

VARCHAR

実行中または保留中のアプリのターゲットバージョン。

TARGET_UPGRADE_PATCH

INT

実行中または保留中のアプリのバージョンパッチレベル。

UPGRADE_STARTED_ON

DATETIME

アプリのアップグレードが開始されたタイムスタンプ。

UPGRADE_ATTEMPT

INT

ターゲットバージョンまたはパッチへのアップグレードの試行回数。

UPGRADE_ATTEMPTED_ON

DATETIME

直近のアップグレードが試みられた時のタイムスタンプ。

UPGRADE_FAILURE_REASON

VARCHAR

前回のアプリのアップグレードが失敗した場合の失敗の説明。

LISTING_NAME

VARCHAR

アプリがインストールされたデータ交換のリスト名。

LISTING_DISPLAY_NAME

VARCHAR

リストの表示名。

EXCHANGE_NAME

VARCHAR

アプリがインストールされたリストのデータ交換名。

LAST_HEALTH_STATUS

VARCHAR

最後に報告されたアプリの正常性状態。可能な値は次のとおりです。

  • OK

  • FAILED

  • PAUSED

LAST_HEALTH_STATUS_UPDATED_ON

VARCHAR

正常性状態が最後に報告されたときのタイムスタンプ。

ENABLED_TELEMETRY_EVENT_DEFINITIONS

VARCHAR

コンシューマーが有効にしているイベント定義のリスト。詳細については、 イベント定義について をご参照ください。

UPGRADE_STATE_UPDATED_ON

TIMESTAMP_LTZ

アプリが現在のアップグレード状態になったときのタイムスタンプ。この値はSnowflakeによって自動的に設定されます。

DISABLEMENT_REASONS

VARCHAR

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

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

有り

使用上の注意

  • このビューにはデータ保持はありません。アプリがアンインストールされると、このビューに含まれる情報は利用できなくなります。