スキーマ:: 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	アプリのリソース（例: タスク、サービス、コンピューティングプール）は現在再開中です。	有り

使用上の注意¶

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