Поделиться через

ALTER VOLUME

  • Статья

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

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

Синтаксис

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 ] ВЛАДЕЛЕЦ 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