ALTER VOLUME

  • Artículo

se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 13.3 LTS y versiones posteriores solo casilla de verificación marcada Unity Catalog

Modifica el nombre o el propietario de un volumen.

Sintaxis

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

Parámetros

  • volume_name

    Nombre del volumen que se va a modificar.

  • CAMBIE EL NOMBRE A new_volume_name

    Cambia el nombre de volume_name a new_volume_name. El nuevo nombre debe ser único y el esquema no debe cambiar.

  • [ SET ] OWNER TO principal

    Transfiere la propiedad del volumen a principal.

    SET se permite como una palabra clave opcional.

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

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 14.3 y versiones posteriores

    Aplique etiquetas al volumen. Debe tener el permiso apply_tag para agregar etiquetas al volumen.

    • tag_name

      Un literal de STRING. tag_name debe ser única entre todas las etiquetas asociadas al volumen especificado.

    • tag_value

      Un literal de STRING.

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

    Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 14.3 y versiones posteriores

    Elimine las etiquetas de la columna. Debe tener el permiso apply_tag para quitar etiquetas del volumen.

    • tag_name

      Un literal de STRING. tag_name debe ser única entre todas las etiquetas asociadas al volumen especificado.

Ejemplos

- 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