ALTER VOLUME

  • Article

S’applique à : coche marquée oui Databricks SQL coche marquée oui Databricks Runtime 13.3 LTS et versions ultérieures cochée oui Unity Catalog uniquement

Modifie le nom ou le propriétaire d'un volume.

Syntaxe

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

Paramètres

  • volume_name

    Le nom du volume à modifier.

  • RENOMMER EN new_volume_name

    Renomme volume_name en new_volume_name. Le nouveau nom doit être unique et le schéma ne doit pas changer.

  • [ SET ] PROPRIÉTAIRE DU principal

    Transfère la propriété du volume à principal.

    SET est autorisé en tant que mot clé facultatif.

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

    S’applique à : coche marquée oui Databricks SQL case marquée oui Databricks Runtime 14.3 et versions ultérieures

    Appliquez des étiquettes au volume. Vous devez avoir l’autorisation APPLY TAG pour ajouter des étiquettes au volume.

    • tag_name

      Un STRING littéral. tag_name doit être unique parmi toutes les étiquettes associées au volume spécifié.

    • tag_value

      Un STRING littéral.

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

    S’applique à : coche marquée oui Databricks SQL case marquée oui Databricks Runtime 14.3 et versions ultérieures

    Supprimez des étiquettes du volume. Vous devez avoir l’autorisation APPLY TAG pour supprimer des étiquettes du volume.

    • tag_name

      Un STRING littéral. tag_name doit être unique parmi toutes les étiquettes associées au volume spécifié.

Exemples

- 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