Bagikan melalui

CREATE 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

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

Parameter-parameternya

  • location_name

    Nama lokasi yang akan dibuat.

  • JIKA TIDAK ADA

    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 tanda petik terbalik. 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';