Delen via

ALTER EXTERNAL LOCATION

  • Artikel

Van toepassing op:vinkje als ja aanAlleen Databricks SQL vinkje als ja aan Databricks Runtime 10.4 LTS en hoger vinkje als ja aan dan Unity Catalog

Hiermee wijzigt u de eigenschappen van een externe locatie of wijzigt u de naam van de locatie.

Syntaxis

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

Elke objectnaam die speciale tekens bevat, zoals afbreekstreepjes (-), moet worden omgeven door backticks (` `). Objectnamen met onderstrepingstekens (_) vereisen geen backticks. Zie Namen en voorbeelden.

Parameters

  • location_name

    Identificeert de externe locatie die wordt gewijzigd.

  • NAAM WIJZIGEN IN to_location_name

    Wijzigt de naam van de locatie. De naam moet uniek zijn voor alle locaties in de metastore.

  • SET URL url_str [ FORCEREN ]

    url_str moet een STRING letterlijke naam zijn met de locatie van de cloudopslag die wordt beschreven als een absolute URL.

    Tenzij u de instructie opgeeft FORCE , mislukt als de locatie momenteel in gebruik is.

  • SET OPSLAGREFERENTIE credential_name

    Hiermee werkt u de benoemde referentie bij die wordt gebruikt voor toegang tot deze locatie. Als de referentie niet bestaat, wordt er een fout gegenereerd in Databricks SQL.

  • [ SET ] EIGENAAR TO principal

    Hiermee wordt het eigendom van de opslaglocatie overgedragen naar principal.

    Van toepassing op:vinkje als ja aan Databricks SQL vinkje als ja aan Databricks Runtime 11.3 LTS en hoger

    SET is toegestaan als een optioneel trefwoord.

Voorbeelden

In de volgende voorbeelden worden locatienamen gebruikt die geen speciale tekens bevatten, zoals afbreekstreepjes (-). Elke objectnaam die speciale tekens bevat, moet worden omgeven door backticks (` `). Zie 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`