KÜLSŐ HELY MÓDOSÍTÁSA
A következőkre vonatkozik: Databricks SQL Databricks Runtime 10.4 LTS és a Unity Catalog felett csak
Módosítja egy külső hely tulajdonságait, vagy átnevezi a helyet.
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 }
Minden olyan objektumnevet, amely speciális karaktereket, például kötőjeleket (-
) tartalmaz, háttérjelekkel (` `
) kell körülvenni. Az aláhúzásjelekkel (_
) rendelkező objektumnevekhez nincs szükség háttérjelekre. Lásd a neveket és példákat.
Paraméterek
-
Azonosítja a módosított külső helyet.
-
Átnevezi a helyet. A névnek egyedinek kell lennie a metaadattár minden helye között.
Standard kiadás T URL-cím url_str [ FORCE ]
url_str
A felhőtárhely helyének abszolút URL-címként leírt literálnak kell lennieSTRING
.Ha nem adja meg
FORCE
az utasítást, az sikertelen lesz, ha a hely jelenleg használatban van.Standard kiadás T STORAGE CREDENTIAL credential_name
Frissítések a hely eléréséhez használt elnevezett hitelesítő adatokat. Ha a hitelesítő adat nem létezik, a Databricks SQL hibát jelez.
[ Standard kiadás T ] TULAJDONOS– MEGBÍZÓ
A tárolóhely tulajdonjogát a következőre
principal
továbbítja: .A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb
SET
választható kulcsszóként engedélyezett.
Példák
Az alábbi példák olyan helyneveket használnak, amelyek nem tartalmaznak speciális karaktereket, például kötőjeleket (-
). A speciális karaktereket tartalmazó objektumok nevét háttérjelekkel (` `
) kell körülvenni. Lásd a neveket.
-- 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`