ALTER APPLICATION PACKAGE ...VERSION

修改 Native Apps Framework 中现有应用程序包的版本控制。

另请参阅：

ALTER APPLICATION PACKAGE、ALTER APPLICATION PACKAGE ...RELEASE DIRECTIVE

语法

ALTER APPLICATION PACKAGE <name> ADD VERSION [ <version_identifier> ]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]

ALTER APPLICATION PACKAGE <name> DROP VERSION <version_identifier>

ALTER APPLICATION PACKAGE <name> ADD PATCH [<patch_number>] FOR VERSION [<version_identifier>]
  USING <path_to_version_directory> [ LABEL = '<display_label>' ]
Copy

参数

name

指定要更改的应用程序包的标识符。如果标识符包含空格、特殊字符或大小写混合字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

ADD VERSION [ version_identifier ] USING path_to_version_directory

使用位于 path_to_version_directory 指定的暂存区位置路径中的应用程序文件，添加版本或补丁。

您可以使用 version_identifier 指定此版本的标识符。如果未在清单文件中指定 version_identifier，则必须指定 version_identifier 作为此命令的一部分。如果指定 version_identifier 为此命令的一部分，则它优先于清单文件中指定的 version_identifier。

[ LABEL = 'display_label' ]

您可以使用 LABEL 子句为此新版本指定标签。此标签将显示给使用者。如果省略 LABEL 子句，则使用 manifest.yml 文件中指定的标签。

DROP VERSION version_identifier

删除具有指定版本名称的版本。

删除具有指定版本标识符的版本。只有在没有发布指令引用某个版本时，才能删除该版本。删除是一个异步过程，当所有应用程序实例都已从旧版本成功升级，并且不再在删除版本上运行代码时，该过程才会完成。

使用 APPLICATION_STATE 视图 监控应用程序实例的状态。使用 SHOW VERSIONS 命令监控已删除版本的状态。

ADD PATCH patch_number FOR VERSION version_identifier . USING path_to_version_directory [ LABEL = 'display_label' ]

使用位于暂存区位置 (path_to_version_directory) 的指定路径中的应用程序文件，添加指定版本 (version_identifier) 的补丁。

您可以使用 LABEL 子句指定此新补丁的标签。此标签将显示给使用者。如果省略 LABEL 子句，则使用 manifest.yml 文件中指定的标签。

使用说明

  • 版本标识符的上限为 30 个字符。

  • 单个版本最多可以有 130 个补丁。

  • 修改版本需要对应用程序具有 OWNERSHIP 权限或全局 MANAGE VERSIONS 权限的角色。

  • 如未为可选属性指定值，该命令将使用应用程序清单文件中指定的值。

    如果在命令和应用程序清单文件中均指定了属性值，则优先采用命令中指定的值。

  • 如果两个版本处于活跃状态（例如，如果当前版本尚未推出），则添加新版本会导致错误。

示例

ALTER APPLICATION PACKAGE hello_snowflake_package
  ADD VERSION v1_1
  USING '@hello_snowflake_code.core.hello_snowflake_stage';
Copy
+---------------------------------------------------------------------------------------+---------+-------+
| status                                                                                | version | patch |
|---------------------------------------------------------------------------------------+---------+-------|
| Version 'v1_1' of application package 'hello_snowflake_package' created successfully. | v1_1    |     0 |
+---------------------------------------------------------------------------------------+---------+-------+
语言: 中文