ALTER APPLICATION PACKAGE

修改 Native Apps Framework 中现有应用程序包的属性。

另请参阅：

CREATE APPLICATION PACKAGE、DROP APPLICATION PACKAGE、SHOW APPLICATION PACKAGES、SHOW VERSIONS、SHOW RELEASE DIRECTIVES

语法

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 ]

ALTER APPLICATION PACKAGE [ IF EXISTS ] <name> UNSET
  [ DATA_RETENTION_TIME_IN_DAYS ]
  [ MAX_DATA_EXTENSION_TIME_IN_DAYS ]
  [ DEFAULT_DDL_COLLATION ]
  [ COMMENT ]
  [ DISTRIBUTION ]

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

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

参数

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。

DEFAULT_DDL_COLLATION = 'collation_specification'

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

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

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

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

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

COMMENT = 'string_literal'

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

DISTRIBUTION = { INTERNAL | EXTERNAL }

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

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

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

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

备注

如果将 DISTRIBUTION 参数设置为 EXTERNAL，则会触发针对应用程序包中定义的每个活跃版本和补丁的自动安全审查。

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

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

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

MULTIPLE_INSTANCES = TRUE

允许使用者从应用程序包中安装一个应用程序的多个实例。无法为试用版或营利性列表中所含的应用程序包设置此属性。

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

小心

将此属性设置为 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.';
Copy
+-------------------------------------------+
| status                                    |
|-------------------------------------------|
| Statement executed successfully.          |
+-------------------------------------------+
语言: 中文