次の方法で共有

ALTER VOLUME

  • [アーティクル]

適用対象: check marked yes 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

    変更するボリュームの名前。

  • RENAME TO new_volume_name

    名前を volume_name から new_volume_name に変更します。 新しい名前は一意である必要があり、スキーマは変更できません。

  • [ SET ] OWNER TO プリンシパル

    ボリュームの所有権を principal に移します。

    SET は省略可能なキーワードとして使用できます。

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

    適用対象: check marked yes Databricks SQL Databricks Runtime 14.3 以上

    ボリュームにタグを適用します。 ボリュームにタグを追加するには、APPLY TAG アクセス許可が必要です。

    • tag_name

      リテラル STRING。 tag_name は、指定されたボリュームに関連付けられたすべてのタグ間で一意である必要があります。

    • tag_value

      リテラル STRING。

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

    適用対象: check marked yes 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