ALTER VOLUME

  • 아티클

적용 대상:검사 '예'로 표시 Databricks SQL 검사 '예'로 표시 Databricks Runtime 13.3 LTS 이상 검사 '예'로 표시 Unity 카탈로그만

볼륨의 이름 또는 소유자를 변경합니다.

구문

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