Compartilhar via

ALTER VOLUME

  • Artigo

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 13.3 LTS e versões posteriores verificação marcada como sim Somente Catálogo do Unity

Altera o nome ou o proprietário de um volume.

Sintaxe

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

Parâmetros

  • volume_name

    O nome do volume a ser alterado.

  • RENAME TO new_volume_name

    Renomeia volume_name como new_volume_name. O novo nome deve ser exclusivo e o esquema não deve ser alterado.

  • [ SET ] OWNER TO principal

    Transfere a propriedade do volume para principal.

    SET é permitido como uma palavra-chave opcional.

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

    Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 14.3 e versões posteriores

    Aplique tags ao volume. Você precisa ter APPLY TAG permissão para adicionar tags ao volume.

    • nome_da_tag

      Um literal STRING. O tag_name deve ser exclusivo entre todas as tags associadas ao volume especificado.

    • tag_value

      Um literal STRING.

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

    Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 14.3 e versões posteriores

    Remova tags do volume. Você precisa ter APPLY TAG permissão para remover tags do volume.

    • nome_da_tag

      Um literal STRING. O tag_name deve ser exclusivo entre todas as tags associadas ao volume especificado.

Exemplos

- 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