適用対象:
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 }
パラメーター
-
変更するボリュームの名前。
new_volume_nameに変更する
名前を
volume_nameからnew_volume_nameに変更します。 新しい名前は一意である必要があり、スキーマは変更できません。[ SET ] 所有者を主要
ボリュームの所有権を
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