ALTER APPLICATION

修改已安装的 Snowflake Native App 的属性使用 ALTER APPLICATION 可将应用程序升级到特定版本或补丁。该命令还可用于设置应用程序的其他属性。

另请参阅：

CREATE APPLICATION、DESCRIBE APPLICATION、DROP APPLICATION、SHOW APPLICATIONS

语法

ALTER APPLICATION [ IF EXISTS ] <name> SET
  [ COMMENT = '<string-literal>' ]
  [ SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE } ]
  [ DEBUG_MODE = { TRUE | FALSE } ]

ALTER APPLICATION [ IF EXISTS ] <name> UNSET
  [ COMMENT ]
  [ SHARE_EVENTS_WITH_PROVIDER ]
  [ DEBUG_MODE ]

ALTER APPLICATION [ IF EXISTS ] <name> RENAME TO <new_app_name>

ALTER APPLICATION <name> SET FEATURE POLICY <policy_name> [ FORCE ]

ALTER APPLICATION <name> UNSET FEATURE POLICY;

ALTER APPLICATION <name> SET MAINTENANCE POLICY <policy_name> [ FORCE ]

ALTER APPLICATION <name> UNSET MAINTENANCE POLICY

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

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

ALTER APPLICATION <name> SET SHARED TELEMETRY EVENTS ('<event_definition' [ , <event_definition>, ...])

ALTER APPLICATION <name> SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

ALTER APPLICATION <name> UNSET REFERENCES [ ( '<reference_name>' [ , '<reference_alias>' ] ) ]

ALTER APPLICATION <name> UPGRADE

ALTER APPLICATION <name> UPGRADE USING VERSION <version_name> [ PATCH <patch_num> ]

ALTER APPLICATION <name> UPGRADE USING <path_to_stage>
Copy

参数

name

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

SET

指定要为应用程序设置的一个（或多个）属性（用空格、逗号或新行分隔）。有关可设置的属性的更多详细信息，请参阅 CREATE APPLICATION。

COMMENT = '{string}'

为应用程序添加注释或覆盖现有注释。

DEBUG_MODE = { TRUE | FALSE }

启用或禁用已安装应用程序的调试模式。

  • TRUE 启用已安装应用程序的调试模式。

  • FALSE 禁用已安装应用程序的调试模式。

只有在满足以下条件时，才能在应用程序上设置 DEBUG_MODE：

  • 已安装的应用程序与应用程序包位于同一账户中。

  • 已安装的应用程序必须是在开发模式下创建的。

    开发模式随显式暂存区、版本或补丁一起安装。

  • 您拥有已安装应用程序的 OWNERSHIP 权限，并且您的角色已被授予用于创建已安装应用程序的应用程序包的 DEVELOP 权限。

SHARE_EVENTS_WITH_PROVIDER = { TRUE | FALSE }

指定是否与提供商共享日志和事件数据。

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

指定 标签 名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅 Tag quotas。

UNSET

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

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

  • COMMENT

  • DEBUG_MODE 禁用已安装应用程序的调试模式。此子句在语义上与设置 DEBUG_MODE = FALSE 相同。

  • TAG tag_name [ , tag_name ... ]

  • REFERENCES[ ( 'reference_name' [, 'reference_alias' ] ) ]

    取消设置应用程序的持久引用。如果未传递任何实参，则取消为应用程序设置的所有持久引用。

RENAME TO new_app_name

为应用程序指定新的标识符。该标识符必须是账户的唯一标识符。

SET FEATURE POLICY policy_name [ FORCE ]

指定要应用于应用程序的功能策略。如果已经在应用程序上设置了功能策略，则可以使用 FORCE 来设置功能策略，而不必先取消设置功能策略。

UNSET FEATURE POLICY

从应用程序中移除功能政策。当从应用程序中移除功能策略时，将应用账户级别的功能策略（如果存在）。

SET MAINTENANCE POLICY policy_name [ FORCE ]

Specifies the maintenance policy to apply to the app. If a maintenance policy is already set on the app, you can use FORCE to set the maintenance policy without having to unset the maintenance policy first.

UNSET MAINTENANCE POLICY

Removes the maintenance policy from the app. When a maintenance policy is removed from an app, the account-level maintenance policy, if it exists, is applied.

SET SHARED TELEMETRY EVENTS ( 'event_definition' [ , event_definition, ... ] )

指定要为应用启用的可选事件定义。

SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

设置为 TRUE 时，启用应用程序所需的所有事件定义。但是，可选事件定义仍处于禁用状态。使用 SET SHARED TELEMETRY EVENTS 子句为应用程序设置可选事件定义。

小心

将此值设置为 TRUE 后，如果应用程序中存在所需的事件定义，则无法将该值重置回 FALSE。

UNSET REFERENCES[ ( 'reference_name' [ , 'reference_alias' ] ) ]

从应用程序中移除指定的引用。

UPGRADE

如果提供商发布了应用程序的新版本或补丁，请升级应用程序。

如果提供商设置了应用程序的发布指令，应用程序会自动升级。不过，此命令可用于立即开始升级，而无需等待自动升级。此命令只能用于非开发模式下创建的应用程序。开发模式下的应用程序是从列表中安装的，或者未指定阶段或版本，主要用于测试升级过程。

UPGRADE USING VERSION version_name [ PATCH patch_num ]

将应用程序升级到指定版本。如果未指定 patch_num，则使用最新的补丁。此命令仅对通过指定版本和补丁安装的应用程序有效。

UPGRADE USING path_to_stage

使用由 path_to_stage 指定的路径中的命名暂存区中的文件升级应用程序。

仅当从命名暂存区安装应用程序时，此子句才适用。

使用说明

  • 如果未指定可选参数的值，则从 manifest.yml 文件中获取这些参数的值。如果在清单中和运行命令时都指定了值，则命令中指定的值优先。

  • 关于元数据：

    注意

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

语言: 中文