Compartir a través de

ALTER EXTERNAL LOCATION

  • Artículo

Se aplica a:casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 10.4 LTS y versiones posteriores casilla marcada como Sí solo a Unity Catalog

Modifica las propiedades de una ubicación externa o cambia el nombre de la ubicación.

Sintaxis

ALTER EXTERNAL LOCATION location_name
   { RENAME TO to_location_name |
     SET URL url_str [ FORCE ] |
     SET STORAGE CREDENTIAL credential_name |
     [ SET ] OWNER TO principal }

Cualquier nombre de objeto que incluya caracteres especiales, como guiones (-), debe estar rodeado de acentos inversas (` `). Los nombres de objeto con caracteres de subrayado (_) no requieren acentos versos. Consulte Nombres y Ejemplos.

Parámetros

  • location_name

    Identifica la ubicación externa que se va a modificar.

  • RENAME TO to_location_name

    Cambia el nombre de la ubicación. El nombre debe ser único entre todas las ubicaciones del metastore.

  • SET URL url_str [ FORCE ]

    url_str debe ser una expresión literal STRING con la ubicación del almacenamiento en la nube descrita como dirección URL absoluta.

    A menos que especifique FORCE, se producirá un error en la instrucción si la ubicación está en uso actualmente.

  • SET STORAGE CREDENTIAL credential_name

    Actualiza la credencial con nombre usada para acceder a esta ubicación. Si la credencial no existe, Databricks SQL genera un error.

  • [ SET ] OWNER TO principal

    Transfiere la propiedad de la ubicación de almacenamiento a principal.

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

    SET se permite como una palabra clave opcional.

Ejemplos

En los siguientes ejemplos se usan nombres de ubicación que no incluyen caracteres especiales, como guiones (-). Cualquier nombre de objeto que incluya caracteres especiales debe estar rodeado por acentos graves (` `). Vea Nombres.

-- Rename a location
> ALTER EXTERNAL LOCATION descend_loc RENAME TO decent_loc;

-- Redirect the URL associated with the location
> ALTER EXTERNAL LOCATION best_loc SET URL 'abfss://container@storageaccount.dfs.core.windows.net/best_location' FORCE;

-- Change the credentials used to access the location
> ALTER EXTERNAL LOCATION best_loc SET STORAGE CREDENTIAL street_cred;

-- Change ownership of the external location
> ALTER EXTERNAL LOCATION best_loc OWNER TO `alf@melmak.et`