ALTER VOLUME
适用于: Databricks SQL Databricks Runtime 13.3 LTS 及更高版本 仅 Unity Catalog
更改卷的名称或所有者。
语法
ALTER VOLUME volume_name
{ RENAME TO new_volume_name |
[ SET ] OWNER TO principal |
SET TAGS clause |
UNSET TAGS clause }
参数
-
要更改的卷的名称。
将 重命名为 new_volume_name
将
volume_name
重命名为new_volume_name
。 新名称必须是唯一的,并且不得更改架构。[ SET ] OWNER TO principal
将卷的所有权转移给
principal
。允许使用
SET
作为可选关键字。SET TAGS ( { tag_name = tag_value } [, ...] )
适用于: Databricks SQL Databricks Runtime 14.3 及更高版本
将标记应用于卷。 需要具有
APPLY TAG
权限才能向卷添加标记。tag_name
文本
STRING
。tag_name
在与指定卷关联的所有标记中必须是唯一的。tag_value
文本
STRING
。
UNSET TAGS ( tag_name [, ...] )
适用于: Databricks SQL Databricks Runtime 14.3 及更高版本
从卷中删除标记。 需要具有
APPLY TAG
权限才能从卷中删除标记。tag_name
文本
STRING
。tag_name
在与指定卷关联的所有标记中必须是唯一的。
示例
- Change the owner of the volume `my_volume`
> ALTER VOLUME my_volume SET OWNER TO alf@melmak.et
OK
- Change the name of the volume from `my_volume` to `new_name_volume`
> ALTER VOLUME my_volume RENAME TO new_name_volume
OK
-- Applies three tags to the volume named `my_volume`.
> ALTER VOLUME my_volume SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');
OK
-- Removes three tags from the volume named `my_volume`.
> ALTER VOLUME my_volume UNSET TAGS ('tag1', 'tag2', 'tag3');
OK