BUAT LOKASI EKSTERNAL

  • 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

Membuat lokasi eksternal dengan nama yang ditentukan. Jika lokasi dengan nama yang sama sudah ada, pengecualian dilemparkan.

Untuk petunjuk cara penggunaan, lihat Membuat lokasi eksternal untuk menyambungkan penyimpanan cloud ke Azure Databricks.

Sintaks

CREATE EXTERNAL LOCATION [IF NOT EXISTS] location_name
    URL url_str
    WITH (STORAGE CREDENTIAL credential_name)
    [COMMENT comment]

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

    Nama lokasi yang akan dibuat.

  • IF NOT EXISTS

    Membuat lokasi dengan nama yang diberikan jika tidak ada. Jika lokasi dengan nama yang sama sudah ada, tidak akan terjadi apa-apa.

  • url_str

    Harfiah STRING dengan lokasi penyimpanan cloud yang digambarkan sebagai URL absolut. Harus dikelilingi oleh tanda kutip tunggal.

  • credential_name

    Info masuk bernama yang digunakan untuk terhubung ke lokasi ini.

  • komentar

    Deskripsi opsional untuk lokasi, atau NULL. Default adalah NULL.

Contoh

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION abfss_remote URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL abfss_remote_cred)
    COMMENT 'Default source for Azure exernal data';

Perhatikan backtick (` `) di sekitar lokasi eksternal dan nama kredensial penyimpanan dalam contoh berikut. Backtick diperlukan untuk nama objek yang menyertakan karakter khusus, seperti tanda hubung (-). Nama objek dengan garis bawah (_), seperti yang ada dalam contoh sebelumnya, tidak memerlukan backtick. Lihat Nama.

-- Create a location accessed using the abfss_remote_cred credential
> CREATE EXTERNAL LOCATION `abfss-remote` URL 'abfss://container@storageaccount.dfs.core.windows.net/location'
    WITH (STORAGE CREDENTIAL `abfss-remote-cred`)
    COMMENT 'Default source for Azure exernal data';