Sdílet prostřednictvím

ALTER EXTERNAL LOCATION

  • Článek

Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 10.4 LTS a vyšší zaškrtnutí označeného ano pouze katalog Unity

Změní vlastnosti externího umístění nebo přejmenuje umístění.

Syntaxe

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

Libovolný název objektu, který obsahuje speciální znaky, jako jsou spojovníky (-), musí být obklopený zpětnými znaky (` `). Názvy objektů s podtržítky (_) nevyžadují zpětné znaky. Viz názvy a příklady.

Parametry

  • location_name

    Identifikuje změněné externí umístění.

  • PŘEJMENOVAT NA to_location_name

    Přejmenuje umístění. Název musí být jedinečný mezi všemi umístěními v metastoru.

  • SET URL url_str [ FORCE ]

    url_str musí být literál s umístěním cloudového úložiště, které je STRING popsáno jako absolutní adresa URL.

    Pokud nezadáte FORCE příkaz, selže, pokud se umístění právě používá.

  • NASTAVENÍ CREDENTIAL_NAME PŘIHLAŠOVACÍCH ÚDAJŮ ÚLOŽIŠTĚ

    Aktualizuje pojmenované přihlašovací údaje používané pro přístup k tomuto umístění. Pokud přihlašovací údaje neexistují, sql Databricks vyvolá chybu.

  • [ SET ] VLASTNÍK K objektu zabezpečení

    Přenese vlastnictví umístění úložiště do principalumístění úložiště .

    Platí pro: zaškrtnutí označeného ano Databricks SQL zaškrtnutí označeného ano Databricks Runtime 11.3 LTS a vyšší

    SET je povolený jako volitelné klíčové slovo.

Příklady

Následující příklady používají názvy umístění, které neobsahují speciální znaky, například spojovníky (-). Libovolný název objektu, který obsahuje speciální znaky, musí být obklopen zpětnými znaky (` `). Viz názvy.

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