ALTER BUDGET

完全限定名称 ：SNOWFLAKE.CORE.BUDGET

修改 自定义 预算的属性：

  • 重命名预算。

  • 设置或取消设置标签。

  • 设置或取消设置注释。

另请参阅：

CREATE BUDGET、SHOW BUDGET、DROP BUDGET

语法

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET COMMENT

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

参数

name

指定预算的标识符（即名称）。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

SET ...

指定要设置的一个或多个预算属性。

COMMENT = 'string_literal'

设置预算的注释。也可以使用 COMMENT 命令来完成。

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

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

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

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

UNSET ...

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

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限/角色

对象

备注

ADMIN

预算

用于修改自定义预算属性的角色必须被授予此 实例角色。

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需 同时 被授予该架构的 USAGE 权限。

有关更多信息，请参阅 Budgets 角色和权限。

使用说明

  • 您只能修改 自定义 预算的属性。

  • 要通过其非限定名称引用该类，请在 搜索路径 中包含该类的数据库和架构。

示例

在当前架构中设置预算 my_budget 的标签 dept：

ALTER SNOWFLAKE.CORE.BUDGET my_budget SET TAG dept = 'finance';
Copy
语言: 中文