升级应用程序¶

关于升级¶

Snowflake Native App Framework 允许提供商将应用程序升级到新版本或补丁。要了解升级如何融入开发应用程序新版本或补丁的整体工作流程，请参阅 更新应用程序的工作流程。

提供商可以通过在应用程序包上设置发布指令，将应用程序升级到新版本或补丁。修改发布指令后，Snowflake 会自动将当前版本应用程序的所有已安装实例升级到发布指令指定的版本。

当提供商启动升级时，Snowflake 会将每个要升级的应用程序添加到队列中。每个应用程序都会根据可用资源进行升级。在所有已安装的应用程序版本中，升级过程可能需要一段时间才能完成。为了加快升级过程，使用者还可以在有新版本或补丁时手动启动应用程序升级。

升级工作流程¶

提供商使用以下工作流程升级已安装的应用程序：

1. 更新应用程序以包含任何新功能。

2. 如果您要创建应用程序的新版本，并且当前为应用程序定义了两个版本：

   1. 确保当前没有使用者正在运行该版本。

   2. 删除您要更换的应用程序版本。

3. 为应用程序包中的更改创建新版本或补丁。

   如果应用程序包的 DISTRIBUTION 属性设置为 EXTERNAL，则启动 自动安全扫描。必须先通过安全扫描，然后才能进行升级。

4. 通过在您的测试账户中安装应用程序来测试新版本。

5. 更新版本或补丁的发布指令。

   这将启动自动升级，该升级将更新先前版本的所有已安装实例。提供商可能会通知使用者有升级可用，并要求他们 手动升级 应用程序。

开始升级¶

当提供商更新应用程序包的发布指令（默认或自定义）以指向新版本或补丁时，升级过程将自动启动。使用 ALTER APPLICATION PACKAGE ...RELEASE DIRECTIVE 命令来设置默认发布指令，如以下示例所示：

ALTER APPLICATION PACKAGE my_application_package SET DEFAULT RELEASE DIRECTIVE
  VERSION = v2
  PATCH = 0;

此命令将默认的发布指令设置为版本 v2 和补丁 0。

ALTER APPLICATION PACKAGE my_application_package
  SET RELEASE DIRECTIVE my_custom_release_directive
  ACCOUNTS = ( USER_ACCOUNT.snowflakecomputing.com )
  VERSION = v2
  PATCH = 0;

此命令会为账户 v2.snowflakecomputing.cn 将名为 my_custom_release_directive 的自定义发布指令设置为版本 0 和补丁 USER_ACCOUNT。

有关更多信息，请参阅 为应用程序设置发布指令。

手动升级应用程序¶

手动升级允许使用者比自动升级更快地升级已安装的应用程序。当有新版本或补丁可用时，提供商可能会要求使用者执行手动升级。

使用者通过运行 ALTER APPLICATION 执行手动升级。此命令使用应用程序包中指定的发布指令，启动应用程序已安装版本或补丁的升级。

要将已安装的 Snowflake Native App 升级到最新的可用版本，使用者可以使用 ALTER APPLICATION 命令的 UPGRADE 子句来修改应用程序对象：

ALTER APPLICATION <name> UPGRADE

跨区域升级应用程序¶

升级应用程序后，在执行对远程区域的刷新之前，对使用者账户中已安装 Snowflake Native App 的更改可能不可见。

您可以使用 数据共享使用情况 架构中的 APPLICATION_STATE 视图 来监控状态。如果在升级后，在第一次刷新后超过一天仍未完成升级，则刷新过程可能存在问题。请联系 ` Snowflake 支持部门 `_。

如果提供商使用 Cross-Cloud Auto-Fulfillment 发布 Snowflake Native App，则自动升级可能需要一段时间才能升级，具体取决于多个因素，其中包括：

• 刷新计划的值。

• 应用程序的已安装实例数。

• 部署应用程序的区域数。

如果升级包含需要在远程区域中升级的紧急修复程序，则提供商可以将列表的刷新频率降低为较小的值。有关设置账户级别刷新频率的信息，请参阅 监控和管理自动履行设置 <https://other-docs.snowflake.com/en/collaboration/provider-listings-auto-fulfillment#label-listings-monitor-manage-ccaf>。

小心

降低刷新频率可能增加与复制相关的成本。

升级状态¶

在升级过程中，应用程序会经过几个不同的状态。下图显示了从上一个版本 v1 升级到新版本 v2 时可能出现的状态。

下表显示了应用程序包所在区域内的应用程序升级过程的每个阶段：

下表显示了部署到远程区域的应用程序的升级过程：

下表描述了升级过程的每种可能状态：

监控升级状态¶

要查看应用程序的升级状态，请使用 APPLICATION_STATE 视图。

例如，在您更新了默认发布指令并希望查看所有应用程序是否已达到目标版本的情况下。要查找尚未完成升级的应用程序实例，请使用以下示例中的查询：

SELECT * FROM snowflake.data_sharing_usage.APPLICATION_STATE

此视图包括特定于升级的列，包括升级状态和部署应用程序的区域。有关升级状态的信息，请参阅 升级状态。

排查升级问题¶

Snowflake Native App Framework 提供了多种排查升级问题的方法：

处于禁用状态的应用程序¶

当使用者账户中安装的应用程序处于禁用状态时，它将不再可用。安装在使用者账户中的应用程序可能会因多种原因而处于禁用状态的，其中包括：

• 应用程序包的问题

• 已安装应用程序的问题

• 使用者账户的问题

提供商和使用者都应避免应用程序长时间处于禁用状态的情况。处于禁用状态的应用程序可能无法使用，必须重新安装