ALTER VOLUME

  • Článek

Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 13.3 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

Změní jméno nebo vlastníka svazku.

Syntaxe

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

Parametry

  • volume_name

    Název svazku, který se má změnit.

  • PŘEJMENOVÁNÍ NA new_volume_name

    Přejmenuje volume_name na new_volume_name. Nový název musí být jedinečný a schéma se nesmí změnit.

  • [ SET ] VLASTNÍK K objektu zabezpečení

    Přenese vlastnictví svazku do principal.

    SET je povolený jako volitelné klíčové slovo.

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

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 14.3 a vyšší

    Použijte značky na svazek. Ke přidávání značek do svazku potřebujete apply_tag oprávnění.

    • tag_name

      Literál STRING. Musí tag_name být jedinečný mezi všemi značkami přidruženými k zadanému svazku.

    • tag_value

      Literál STRING.

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

    Platí pro:zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 14.3 a vyšší

    Odeberte značky ze svazku. Musíte mít apply_tag oprávnění k odebrání značek ze svazku.

    • tag_name

      Literál STRING. Musí tag_name být jedinečný mezi všemi značkami přidruženými k zadanému svazku.

Příklady

- 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