다음을 통해 공유

CREATE EXTERNAL LOCATION

적용 대상:체크 표시됨 Databricks SQL 체크 표시됨 Databricks Runtime 10.4 LTS 이상 체크 표시됨 Unity 카탈로그에만 적용

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

방법 지침은 옵션 2: SQL을 사용하여 외부 위치 만들기를 참조하세요.

구문

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

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

매개 변수

  • location_name

    만들 위치의 이름입니다.

  • 존재하지 않을 경우

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

  • url_str

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

  • credential_name

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

  • 주석

    위치에 대한 선택적 설명 또는 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';
  • Last updated on