Dela via

ALTER EXTERNAL LOCATION

  • Artikel

gäller för:markerad som ja Databricks SQL markerad som ja Databricks Runtime 10.4 LTS och senare markerad som ja Unity Catalog

Ändrar egenskaper för en extern plats eller byter namn på platsen.

Syntax

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

Alla objektnamn som innehåller specialtecken, till exempel bindestreck (-), måste omges av backticks (` `). Objektnamn med understreck (_) kräver inte backticks. Se Namn och exempel.

Parameters

  • location_name

    Identifierar den externa plats som ändras.

  • BYT NAMN TILL TO_LOCATION_NAME

    Byter namn på platsen. Namnet måste vara unikt bland alla platser i metaarkivet.

  • SET URL url_str [ FORCE ]

    url_str måste vara en STRING literal med platsen för molnlagringen som beskrivs som en absolut URL.

    Om du inte anger FORCE instruktionen misslyckas om platsen används för närvarande.

  • SET STORAGE CREDENTIAL credential_name

    Uppdaterar den namngivna autentiseringsuppgiften som används för att komma åt den här platsen. Om autentiseringsuppgifterna inte finns genererar Databricks SQL ett fel.

  • [ SET ] ÄGARE TILL huvudman

    Överför ägarskapet för lagringsplatsen till principal.

    Gäller för:markerad ja Databricks SQL markerad ja Databricks Runtime 11.3 LTS och senare

    SET tillåts som ett valfritt nyckelord.

Exempel

I följande exempel används platsnamn som inte innehåller specialtecken, till exempel bindestreck (-). Alla objektnamn som innehåller specialtecken måste omges av backticks (` `). Se Namn.

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