Dela via

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.

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