架构：: DATA_SHARING_USAGE

APPLICATION_STATE 视图¶

DATA_SHARING_USAGE 架构中的此视图可用于显示当前账户中所有应用程序包的列表中安装的应用程序的相关信息。

如果使用 Cross-Cloud Auto-Fulfillment 发布了列表，则此视图将显示所有区域中已安装应用程序的信息。

列¶

列名称	数据类型	描述
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` 表示实例已从以前的版本升级，但可能仍有一个或多个使用以前版本的查询正在运行。
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` 列中列出。实例将保持 `FAILED` 状态，直到版本指令更新为指向与 `TARGET_UPGRADE_VERSION` 列中定义的升级目标版本不同的版本。 `QUEUED_RETRY`：实例在一次或多次升级尝试中失败。`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	应用程序资源（例如任务、服务和计算池）当前正在恢复。	是

使用说明¶

此视图没有数据保留。如果卸载应用程序，则此视图中包含的信息将不再可用。