ALTER EXTERNAL LOCATION (Databricks SQL)

  • 项目

重要

Unity Catalog 目前为公共预览版。 要使用该预览版，请联系 Azure Databricks 代表。

更改外部位置的属性或重命名该位置。

语法

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

参数

  • location_name

    标识正在更改的外部位置。

  • RENAME TO to_location_name

    将位置重命名为新名称。 该名称在元存储中的所有位置中必须是唯一的。

  • SET URL url [FORCE]

    url 必须是 STRING 文本，其中云存储的位置描述为绝对 URL。

    如果该位置当前正在使用，除非指定 FORCE，否则语句将失败。

  • SET STORAGE CREDENTIAL credential_name

    更新用于访问此位置的命名凭据。 如果凭据不存在，Databricks SQL 将引发错误。

  • OWNER TO 主体

    将存储位置的所有权转让给 principal。

示例

-- 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 `abfss::/us-east-1-prod/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 lcation
> ALTER EXTERNAL LOCATION best_loc OWNER TO `alf@melmak.et`