Freigeben über


ALTER EXTERNAL LOCATION

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 10.4 LTS und höher Häkchen gesetzt ja Nur Unity Catalog

Ändert die Eigenschaften eines externen Speicherorts oder benennt den Speicherort um.

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 }

Jeder Objektname, der Sonderzeichen enthält, z. B. Bindestriche (-), muss von Backticks (` `) umgeben sein. Objektnamen mit Unterstrichen (_) erfordern keine Backticks. Siehe Namen und Beispiele.

Parameter

  • location_name

    Gibt den externen Speicherort an, der geändert wird.

  • RENAME TO to_location_name

    Weist dem Speicherort einen neuen Namen zu. Der Name aller Speicherorte im Metastore muss eindeutig sein.

  • SET URL url_str [ FORCE ]

    url_str muss ein STRING-Literal mit dem Speicherort des Cloudspeichers sein, beschrieben als absolute URL.

    Sofern Sie nicht FORCE angeben, schlägt die Anweisung fehl, wenn der Speicherort derzeit verwendet wird.

  • SET STORAGE CREDENTIAL credential_name

    Aktualisiert die benannten Anmeldeinformationen, die für den Zugriff auf diesen Speicherort verwendet werden. Wenn die Anmeldeinformationen nicht vorhanden sind, löst Databricks SQL einen Fehler aus.

  • [ SET ] OWNER TO principal

    Überträgt den Besitz des Speicherorts an principal.

    Gilt für: Häkchen ja Databricks SQL Häkchen Databricks Runtime 11.3 LTS und höher

    SET ist als optionales Schlüsselwort zulässig.

Beispiele

In den folgenden Beispielen werden Positionsnamen verwendet, die keine Sonderzeichen enthalten, z. B. Bindestriche (-). Jeder Objektname, der Sonderzeichen enthält, muss in umgekehrte Hochkommas (` `) eingeschlossen werden. Siehe Namen.

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