Udostępnij za pośrednictwem

ALTER EXTERNAL LOCATION

  • Artykuł

Dotyczy:zaznaczone jako tak Databricks SQL zaznaczone jako tak Databricks Runtime 10.4 LTS i nowsze zaznaczone jako tak Unity tylko Catalog

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

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 ze podkreśleniami (_) nie wymagają backticksów. Zobacz Nazwy i przykłady.

Parameters

  • 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`