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

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

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 中的元数据字段。

语言: 中文