ALTER EXTERNAL LOCATION

Berlaku untuk:centang tanda ya Databricks SQL centang tanda ya Databricks Runtime 10.4 LTS ke atas centang tanda ya Unity Catalog saja

Mengubah properti dari lokasi eksternal atau mengganti nama lokasi.

Permissions

Untuk mengubah lokasi eksternal, Anda harus memiliki MANAGE hak istimewa pada lokasi atau menjadi pemiliknya.

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 underscore (_) tidak memerlukan tanda kutip terbalik. Lihat Nama dan Contoh.

Parameter-parameternya

  • location_name

    Mengidentifikasi lokasi eksternal yang diubah.

  • GANTI NAMA MENJADI 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.

  • KREDENSIAL PENYIMPANAN SETcredential_name

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

  • [ SET ] PEMILIK KE UTAMA

    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`
  • Last updated on