ALTER VOLUME

  • Статья

Область применения:флажок Databricks SQL флажок Databricks Runtime 13.3 LTS и более поздней флажок версии каталога Unity

Изменяет имя или владельца тома.

Синтаксис

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

Параметры

  • volume_name

    Имя тома, который необходимо изменить.

  • ПЕРЕИМЕНОВАНИЕ В NEW_VOLUME_NAME

    Переименование volume_name new_volume_nameв . Новое имя должно быть уникальным, и схема не должна изменяться.

  • [ SET ] OWNER TO субъект

    Передает права владения томом principal.

    SET разрешено в качестве необязательного ключевого слова.

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

    Область применения: флажок Databricks SQL флажок Databricks Runtime 14.3 и более поздних версий

    Примените теги к тому. Необходимо иметь APPLY TAG разрешение на добавление тегов в том.

    • tag_name

      Литерал STRING. Он tag_name должен быть уникальным среди всех тегов, связанных с указанным томом.

    • tag_value

      Литерал STRING.

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

    Область применения: флажок Databricks SQL флажок Databricks Runtime 14.3 и более поздних версий

    Удалите теги из тома. Необходимо иметь APPLY TAG разрешение на удаление тегов из тома.

    • tag_name

      Литерал STRING. Он tag_name должен быть уникальным среди всех тегов, связанных с указанным томом.

Примеры

- 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