Delen via


VOLUME WIJZIGEN

Van toepassing op:vinkje als ja aan Alleen Databricks SQL vinkje als ja aan Databricks Runtime 13.3 LTS en hoger vinkje als ja aan dan Unity Catalog

Hiermee wijzigt u de naam of eigenaar van een volume.

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 AAN 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. U moet gemachtigd zijn APPLY TAG 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