ALTER VOLUME

Van toepassing op:gemarkeerd als ja Databricks SQL gemarkeerd als ja Databricks Runtime 13.3 LTS en hoger gemarkeerd als ja alleen Unity Catalog

Hiermee wijzigt u de naam of eigenaar van een volume.

Permissions

RENAMEen het eigendom van het volume (of MANAGE erop) vereisenSET OWNER, plus USE CATALOG op de bovenliggende catalogus en USE SCHEMA in het bovenliggende schema.

SET TAGS en UNSET TAGS vereisen APPLY TAG op het volume, plus USE CATALOG op de bovenliggende catalogus en USE SCHEMA in het bovenliggende schema.

Syntaxis

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

Parameters

  • volume_name

    De naam van het volume dat moet worden gewijzigd.

  • NAAM WIJZIGEN IN new_volume_name

    Wijzigt de naam in volume_namenew_volume_name. De nieuwe naam moet uniek zijn en het schema mag niet worden gewijzigd.

  • [ SET ] EIGENAAR NAAR principal

    Draagt het eigendom van het volume over naar principal.

    SET is toegestaan als een optioneel trefwoord.

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

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 14.3 en hoger

    Tags toepassen op het volume. U moet gemachtigd zijn APPLY TAG om tags toe te voegen aan het volume.

    • tag_name

      Een letterlijke .STRING De tag_name waarde moet uniek zijn voor alle tags die zijn gekoppeld aan het opgegeven volume.

    • tag_value

      Een letterlijke .STRING

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

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 14.3 en hoger

    Verwijder tags uit het volume. Je hebt toestemming APPLY TAG nodig om tags van het volume te verwijderen.

    • tag_name

      Een letterlijke .STRING De tag_name waarde moet uniek zijn voor alle tags die zijn gekoppeld aan het opgegeven volume.

Voorbeelden

- 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