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> UPGRADE

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

ALTER APPLICATION <name> UPGRADE USING <path_to_stage>

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> UNSET REFERENCES[ ( '<reference_name>' [ , '<reference_alias>' ] ) ]

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

ALTER APPLICATION <name> SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }
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。

有关在语句中指定标签的信息，请参阅 对象和列的标签配额。

RENAME TO new_app_name

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

UPGRADE

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

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

UPGRADE USING VERSION version_name [ PATCH patch_num ]

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

UPGRADE USING <path_to_version_directory>

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

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

UNSET

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

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

  • COMMENT

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

  • TAG tag_name [ , tag_name ... ]

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

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

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

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

SET AUTHORIZE_TELEMETRY_EVENT_SHARING = { TRUE | FALSE }

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

小心

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

使用说明

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

  • 关于元数据：

    注意

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

语言: 中文