CREATE EXTERNAL LOCATION

  • Статья

Область применения:проверка помечены да Databricks SQL проверка помечены да Databricks Runtime 10.4 LTS и более поздней проверка помечены да версии каталога Unity

Создает внешнее расположение с указанным именем. Если расположение с подобным именем уже существует, возникает исключение.

Инструкции см. в статье "Создание внешнего расположения для подключения облачного хранилища к Azure Databricks".

Синтаксис

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

Любое имя объекта, включающее специальные символы, например дефисы (-), должно быть окружено обратными знаками (` `). Имена объектов с символами подчеркивания (_) не требуют обратных символов. См . имена и примеры.

Параметры

  • location_name

    Имя создаваемого расположения.

  • IF NOT EXISTS

    Создает расположение с указанным именем, если оно не существует. Если расположение с подобным именем уже существует, ничего не произойдет.

  • url_str

    Литерал STRING с расположением облачного хранилища в формате абсолютного URL-адреса. Должен быть окружен одними кавычками.

  • 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';