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

    변경되는 외부 위치를 식별합니다.

  • RENAME TO to_location_name

    위치의 이름을 바꿉니다. 이름은 메타스토어에 있는 모든 위치에서 고유해야 합니다.

  • SET URL url_str [ FORCE ]

    url_str은 절대 URL로 설명되는 클라우드 스토리지의 위치가 있는 STRING 리터럴이어야 합니다.

    FORCE를 지정하지 않으면 위치가 현재 사용 중인 경우 명령문이 실패합니다.

  • SET STORAGE CREDENTIAL credential_name

    이 위치에 액세스하는 데 사용되는 명명된 자격 증명을 업데이트합니다. 자격 증명이 없는 경우 Databricks SQL에서 오류가 발생합니다.

  • [ SET ] OWNER TO principal

    스토리지 위치의 소유권을 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`