Freigeben über

ALTER VOLUME

  • Artikel

Gilt für:Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher durch Häkchen mit „Ja“ markiert nur für Unity Catalog

Ändert den Namen oder Besitzer eines Volumes

Syntax

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

Parameter

  • volume_name

    Der Name des Volumes, das geändert werden soll

  • RENAME TO new_volume_name

    volume_name wird in new_volume_nameumbenannt. Der neue Name muss eindeutig sein, und das Schema darf sich nicht ändern.

  • [ SET ] OWNER TO principal

    Überträgt den Besitz des Volumes an den principal.

    SET ist als optionales Schlüsselwort zulässig.

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

    Gilt für:Häkchen ja Databricks SQL Häkchen gesetzt ja Databricks Runtime 14.3 und höher

    Wenden Sie Tags auf das Volume an. Sie benötigen die Berechtigung apply_tag, um dem Volume Tags hinzufügen zu können.

    • tag_name

      Ein STRING-Literal. Dieser tag_name muss für alle Tags, die dem angegebenen Volume zugeordnet sind, eindeutig sein.

    • tag_value

      Ein STRING-Literal.

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

    Gilt für:Häkchen ja Databricks SQL Häkchen gesetzt ja Databricks Runtime 14.3 und höher

    Entfernen Sie Tags vom Volume. Sie benötigen die Berechtigung apply_tag, um Tags vom Volume entfernen zu können.

    • tag_name

      Ein STRING-Literal. Dieser tag_name muss für alle Tags, die dem angegebenen Volume zugeordnet sind, eindeutig sein.

Beispiele

- 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