다음을 통해 공유

CREATE EXTERNAL LOCATION

  • 아티클

적용 대상:확인 표시 예 Databricks SQL 확인에서 예 Databricks Runtime 10.4 LTS 이상으로 표시되고 확인에서 예 Unity Catalog만 표시되었습니다.

지정된 이름으로 외부 위치를 만듭니다. 동일한 이름의 위치가 이미 있으면 예외가 throw됩니다.

방법 지침은 클라우드 스토리지를 Azure Databricks에 연결하는 외부 위치 만들기를 참조 하세요.

구문

CREATE EXTERNAL LOCATION [IF NOT EXISTS] location_name
    URL url_str
    WITH (STORAGE CREDENTIAL credential_name)
    [COMMENT comment]

하이픈()과 같은 특수 문자를 포함하는 개체 이름은 백틱(-` `)으로 묶어야 합니다. 밑줄(_)을 포함하는 개체 이름에는 백틱이 필요하지 않습니다. 이름 및 예제를 참조하세요.

Parameters

  • location_name

    만들 위치의 이름입니다.

  • IF NOT EXISTS

    지정된 이름의 위치가 없는 경우 새로 만듭니다. 동일한 이름의 위치가 이미 있으면 아무 작업도 수행되지 않습니다.

  • url_str

    절대 URL로 설명된 클라우드 스토리지 위치가 포함된 STRING 리터럴입니다. 작은따옴표로 묶어야 합니다.

  • credential_name

    이 위치에 연결하는 데 사용되는 명명된 자격 증명입니다.

  • comment

    위치에 대한 선택적 설명 또는 NULL입니다. 기본값은 NULL입니다.

예

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION abfss_remote URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL abfss_remote_cred)
    COMMENT 'Default source for Azure exernal data';

다음 예제에서는 외부 위치 및 스토리지 자격 증명 이름 주위의 백틱(` `)을 확인합니다. 하이픈(-)과 같은 특수 문자를 포함하는 개체 이름에는 백틱이 필요합니다. 이전 예제와 같이 밑줄(_)이 있는 개체 이름은 백틱이 필요하지 않습니다. 이름을 참조하세요.

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION `abfss-remote` URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL `abfss-remote-cred`)
    COMMENT 'Default source for Azure exernal data';