共用方式為

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 }

Parameters

  • volume_name

    要改變之磁碟區的名稱。

  • 重新命名為 new_volume_name

    重新 volume_name 命名為 new_volume_name。 新名稱必須是唯一的，而且 schema 不得變更。

  • [ SET ] 所有者至 主事者

    將磁碟區的擁有權轉移至 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 和更新版本

    從磁碟區移除 Remove 標籤。 您需要擁有 APPLY TAG 許可權才能對磁碟區內的標籤進行 remove 操作。

    • 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