共用方式為

ALTER EXTERNAL LOCATION

  • 發行項

適用於：核取記號為「是」Databricks SQL 核取記號為「是」Databricks Runtime 10.4 LTS 和更新版本核取記號為「是」僅限 Unity 目錄

改變外部位置的屬性，或重新命名位置。

語法

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

任何包含特殊字元的物件名稱，例如連字元 （-），都必須以反引號 （` `） 括住。 有底線的物件名稱 (_) 不需要反引號。 請參閱名稱和範例。

參數

  • location_name

    識別要改變的外部位置。

  • 重新命名為 to_location_name

    重新命名位置。 名稱在中繼存放區中的所有位置之間必須是唯一的。

  • SET URL url_str [ FORCE ]

    url_str 必須是 STRING 具有描述為絕對 URL 之雲端記憶體位置的常值。

    除非您指定 FORCE 語句會在目前使用位置時失敗。

  • SET STORAGE CREDENTIAL credential_name

    更新用來存取此位置的具名認證。 如果認證不存在 Databricks SQL，就會引發錯誤。

  • [ SET ]OWNER TO 主體

    將儲存位置的擁有權轉移至 principal。

    適用於：核取記號為「是」 Databricks SQL 核取記號為「是」 Databricks Runtime 11.3 LTS 和更新版本

    允許 SET 作為可選關鍵字。

例子

下列範例使用不包含特殊字元的位置名稱，例如連字元 （-）。 包含特殊字元的任何物件名稱都必須以反引號 （` `） 括住。 請參閱名稱。

-- 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`