ALTER EXTERNAL LOCATION

Dotyczy:oznaczone jako tak Databricks SQL oznaczone jako tak Databricks Runtime 10.4 LTS i nowsze oznaczone jako tak Unity Catalog only

Zmienia właściwości lokalizacji zewnętrznej lub zmienia nazwę lokalizacji.

Permissions

Aby zmienić lokalizację zewnętrzną, musisz mieć MANAGE uprawnienia do lokalizacji lub być jego właścicielem.

Składnia

ALTER EXTERNAL LOCATION location_name
   { RENAME TO to_location_name |
     SET URL url_str [ FORCE ] |
     SET STORAGE CREDENTIAL credential_name |
     [ SET ] OWNER TO principal }

Każda nazwa obiektu, która zawiera znaki specjalne, takie jak łączniki (-), musi być otoczona przez backticks (` `). Nazwy obiektów z podkreśleniami (_) nie wymagają backticków. Zobacz Nazwy i przykłady.

Parametry

  • location_name

    Identyfikuje zmienianą lokalizację zewnętrzną.

  • ZMIEŃ NAZWĘ NA TO_LOCATION_NAME

    Zmienia nazwę lokalizacji. Nazwa musi być unikatowa we wszystkich lokalizacjach w magazynie metadanych.

  • adres URL SET url_str [ FORCE ]

    url_str musi być literałem STRING z lokalizacją magazynu w chmurze opisaną jako bezwzględny adres URL.

    Jeśli instrukcja nie zostanie określona FORCE , nie powiedzie się, jeśli lokalizacja jest obecnie używana.

  • SET POŚWIADCZEŃ MAGAZYNU NAZWA_POŚWIADCZENIA

    Aktualizuje nazwane poświadczenia używane do uzyskiwania dostępu do tej lokalizacji. Jeśli poświadczenie nie istnieje, program SQL usługi Databricks zgłasza błąd.

  • [ SET ] WŁAŚCICIEL DO zleceniodawcy

    Przenosi własność lokalizacji magazynu na principal.

    Dotyczy:zaznacz pole wyboru oznaczone jako tak Databricks SQL zaznacz pole wyboru oznaczone jako tak Databricks Runtime 11.3 LTS i nowsze

    SET jest dozwolone jako opcjonalne słowo kluczowe.

Przykłady

W poniższych przykładach są używane nazwy lokalizacji, które nie zawierają znaków specjalnych, takich jak łączniki (-). Każda nazwa obiektu, która zawiera znaki specjalne, musi być otoczona backticks (` `). Zobacz Nazwy.

-- 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`
  • Last updated on