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 }

参数

  • volume_name

    要更改的卷的名称。

  • 重命名为 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

      文本 STRINGtag_name 在与指定卷关联的所有标记中必须是唯一的。

    • tag_value

      文本 STRING

  • UNSET TAGS ( tag_name [, ...] )

    适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime 14.3 及更高版本

    从卷中删除标记。 需要具有 APPLY TAG 权限才能从卷中删除标记。

    • tag_name

      文本 STRINGtag_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