Поделиться через

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 должен иметь тип литерального выражения 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`