ÄNDRA EXTERN PLATS

  • Artikel

Gäller endast för: markerad ja Databricks SQL markerad ja Databricks Runtime 10.4 LTS och senare markerad ja i 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.

Parametrar

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

  • ANGE 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.

  • ANGE CREDENTIAL_NAME FÖR LAGRINGSAUTENTISERINGSUPPGIFTER

    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 huvudnamn

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