ALTER APPLICATION PACKAGE¶

语法¶

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> SET
  [ DATA_RETENTION_TIME_IN_DAYS = <integer> ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS = <integer> ]
  [ DEFAULT_DDL_COLLATION = '<collation_specification>' ]
  [ COMMENT = <string-literal> ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]
  [ MULTIPLE_INSTANCES = TRUE ]
  [ ENABLE_RELEASE_CHANNELS = TRUE ]
  [ SET LISTING_AUTO_REFRESH = { TRUE | FALSE } ]

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> UNSET
  [ DATA_RETENTION_TIME_IN_DAYS ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
  [ DEFAULT_DDL_COLLATION ]
  [ COMMENT  = <string-literal> ]
  [ DISTRIBUTION = { INTERNAL | EXTERNAL } ]

ALTER APPLICATION PACKAGE <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER APPLICATION PACKAGE <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

参数¶

name

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

SET ...

指定要为应用程序包设置的一个（或多个）属性（用空格、逗号或换行符分隔）：

DATA_RETENTION_TIME_IN_DAYS = num

指定可以对数据库执行 Time Travel 操作（CLONE 和 UNDROP）的天数，并指定在数据库中创建的所有架构的默认 Time Travel 保留时间。

您可以指定的值取决于您使用的 Snowflake Edition：

• Standard Edition：0 或 1

• Enterprise Edition（或更高版本）：0 至 90

MAX_DATA_EXTENSION_TIME_IN_DAYS = integer

对象参数，用于指定 Snowflake 可以延长数据库中表的数据保留期以防止表上的流过时的最大天数。

有关此参数的详细说明，请参阅 MAX_DATA_EXTENSION_TIME_IN_DAYS。

DEFAULT_DDL_COLLATION = 'collation_specification'

指定以下项的默认 排序规则规范：

• 添加到数据库中现有表的任何新列。

• 添加到数据库的新表中的所有列。

设置该参数 不会 更改任何现有列的排序规则规范。

有关该参数的更多信息，请参阅 DEFAULT_DDL_COLLATION。

COMMENT = 'string_literal'

为数据库添加注释或覆盖现有注释。

DISTRIBUTION = { INTERNAL | EXTERNAL }

指定提供商在使用应用程序包作为列表的数据产品时，可以创建的列表类型。

• INTERNAL 指示提供商只能在创建应用程序包的同一组织之内创建专用列表。当 DISTRIBUTION 属性设置为 INTERNAL 时，不会执行自动安全扫描。

• EXTERNAL 指示提供商可以在创建应用程序包的同一组织之外创建列表。

请参阅 运行自动安全扫描，了解有关设置 DISTRIBUTION 属性以及自动安全扫描的信息。

备注

Setting the DISTRIBUTION parameter to EXTERNAL triggers an automated security review for each active version and patch defined in the application package.

在自动安全审查的状态变为 APPROVED 之前，存在以下限制：

• 不能为版本或补丁设置发布指令。

• 不能发布应用程序包的列表。

LISTING_AUTO_REFRESH = TRUE | FALSE

设置为时 TRUE，当应用程序包的发布指令发生变化时，启动向所有远程区域的复制。发布指令发生变化时，应用程序包不会等待 Cross-Cloud Auto-Fulfillment 时间表。

MULTIPLE_INSTANCES = TRUE

Enables the consumer to install multiple instances of an app from the application package. This property cannot be set for application packages that are included in a trial or paid listing.

当允许多个实例时，使用者最多可以在其账户中安装一个应用程序的 10 个实例。

小心

将此属性设置为 true 之后，无法再将其设置为 FALSE 或取消设置。

ENABLE_RELEASE_CHANNELS = TRUE

启动应用程序包的 发布通道。

小心

将此属性设置为 TRUE 之后，无法再将其设置为 FALSE 或取消设置。

UNSET ...

指定要为应用程序包取消设置的一个（或多个）属性和/或参数，这会将它们重置为默认值：

• DATA_RETENTION_TIME_IN_DAYS

• MAX_DATA_EXTENSION_TIME_IN_DAYS

• EXTERNAL_VOLUME

• CATALOG

• DEFAULT_DDL_COLLATION

• TAG tag_name [ , tag_name ... ]

• COMMENT

您可以使用单个 ALTER 语句重置多个属性/参数；但是，每个属性/参数 必须 用逗号分隔。重置属性/参数时，请仅指定名称；指定属性的值将返回错误。

使用说明¶

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

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

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

• 添加了默认补丁编号为 0 的新版本。

• 关于元数据：

  注意

  客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

示例¶

ALTER APPLICATION PACKAGE hello_snowflake_package SET
  COMMENT = 'Altered the Hello Snowflake app.';

+-------------------------------------------+
| status                                    |
|-------------------------------------------|
| Statement executed successfully.          |
+-------------------------------------------+