ALTER VOLUME

gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 13.3 LTS och senare markerad som ja Unity Catalog

Ändrar namnet eller ägaren av en volym.

Permissions

RENAME och SET OWNER kräver ägarskap för volymen (eller MANAGE på den), plus USE CATALOG i den överordnade katalogen och USE SCHEMA i det överordnade schemat.

SET TAGS och UNSET TAGS kräver APPLY TAG på volymen, plus USE CATALOG på den överordnade katalogen och USE SCHEMA på det överordnade schemat.

Syntax

ALTER VOLUME volume_name
      { RENAME TO new_volume_name |
        [ SET ] OWNER TO principal |
        SET TAGS clause |
        UNSET TAGS clause }

Parametrar

  • volume_name

    Namnet på volymen som ska ändras.

  • Döp om till new_volume_name

    volume_name Byter namn till new_volume_name. Det nya namnet måste vara unikt och schemat får inte ändras.

  • [ SET ] ÄGARE TILL huvudman

    Överför ägarskapet för volymen till principal.

    SET tillåts som ett valfritt nyckelord.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 14.3 och senare

    Tillämpa taggar på volymen. Du måste ha APPLY TAG behörighet att lägga till taggar i volymen.

    • tag_name

      En bokstavlig STRING. tag_name Måste vara unikt bland alla taggar som är associerade med den angivna volymen.

    • tag_value

      En bokstavlig STRING.

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

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 14.3 och senare

    Ta bort taggar från volymen. Du måste ha behörighet APPLY TAG för att ta bort taggar från volymen.

    • tag_name

      En bokstavlig STRING. tag_name Måste vara unikt bland alla taggar som är associerade med den angivna volymen.

Exempel

- 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
  • Last updated on