ALTER EXTERNAL LOCATION

  • Artikel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 10.4 LTS dan di atas centang ditandai ya Unity Catalog saja

Mengubah properti dari lokasi eksternal atau mengganti nama lokasi.

Sintaks

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

Nama objek apa pun yang menyertakan karakter khusus, seperti tanda hubung (-), harus dikelilingi oleh backtick (` `). Nama objek dengan garis bawah (_) tidak memerlukan backtick. Lihat Nama dan Contoh.

Parameter

  • location_name

    Mengidentifikasi lokasi eksternal yang diubah.

  • RENAME TO to_location_name

    Mengganti nama lokasi. Nama harus unik di antara semua lokasi di metastore.

  • SET URL url_str [ FORCE ]

    url_str harus STRING literal dengan lokasi penyimpanan cloud yang digambarkan sebagai URL absolut.

    Kecuali Anda menentukan FORCE pernyataan akan gagal jika lokasi saat ini sedang digunakan.

  • SET STORAGE CREDENTIAL credential_name

    Memperbarui info masuk bernama yang digunakan untuk mengakses lokasi ini. Jika info masuk tidak ada, Databricks Runtime akan menimbulkan kesalahan.

  • [ SET ] OWNER TO principal

    Mentransfer kepemilikan penyimpanan ke principal.

    Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 11.3 LTS ke atas

    SET diperbolehkan sebagai kata kunci opsional.

Contoh

Contoh berikut menggunakan nama lokasi yang tidak menyertakan karakter khusus, seperti tanda hubung (-). Nama objek apa pun yang menyertakan karakter khusus harus dikelilingi oleh backtick (` `). Lihat Nama.

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