ALTER EXTERNAL LOCATION

  • Articolo

Si applica a:segno di spunta sì Solo databricks SQL segno di spunta sì Databricks Runtime 10.4 LTS e versioni successive segno di spunta sì al catalogo Unity

Modifica le proprietà di un percorso esterno o rinomina il percorso.

Sintassi

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

Qualsiasi nome di oggetto che include caratteri speciali, ad esempio trattini (-), deve essere racchiuso da backtick (` `). I nomi degli oggetti con caratteri di sottolineatura (_) non richiedono backtick. Vedere Nomi ed esempi.

Parametri

  • location_name

    Identifica la posizione esterna modificata.

  • RINOMINA IN to_location_name

    Rinomina il percorso. Il nome deve essere univoco tra tutte le posizioni nel metastore.

  • SET URL url_str [ FORCE ]

    url_str deve essere un STRING valore letterale con la posizione dell'archiviazione cloud descritta come URL assoluto.

    A meno che non si specifichi FORCE l'istruzione avrà esito negativo se il percorso è attualmente in uso.

  • SET STORAGE CREDENTIAL credential_name

    Aggiorna le credenziali denominate usate per accedere a questo percorso. Se la credenziale non esiste in Databricks SQL genera un errore.

  • [ SET ] OWNER TO principal

    Trasferisce la proprietà della posizione di archiviazione a principal.

    Si applica a: segno di spunta sì Databricks SQL segno di spunta sì Databricks Runtime 11.3 LTS e versioni successive

    SET è consentito come parola chiave facoltativa.

Esempi:

Gli esempi seguenti usano nomi di posizione che non includono caratteri speciali, ad esempio trattini (-). Qualsiasi nome di oggetto che include caratteri speciali deve essere racchiuso tra backtick (` `). Vedere Nomi.

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