CREATE VOLUME

Berlaku untuk:dicentang Databricks SQL dicentang Databricks Runtime 13.3 LTS ke atas dicentang Unity Catalog saja

Membuat volume dengan nama yang ditentukan. Jika volume dengan nama yang sama sudah ada dalam skema VOLUME_ALREADY_EXISTS dinaikkan.

Lihat Volume untuk detail tentang menggunakan volume.

Permissions

Untuk membuat volume, Anda harus memiliki semua hal berikut:

  • USE CATALOG pada katalog dan USE SCHEMA pada skema tempat Anda membuat volume
  • CREATE VOLUME pada skema tempat Anda membuat volume
  • CREATE EXTERNAL VOLUME hak istimewa pada lokasi location_path eksternal jika membuat volume eksternal

Sintaks

CREATE [ EXTERNAL ] VOLUME [ IF NOT EXISTS ] volume_name
    [ LOCATION location_path ]
    [ COMMENT comment ]

Parameter

  • EKSTERNAL

    Membuat volume eksternal. Volume eksternal harus didaftarkan pada direktori dalam lokasi eksternal. Jika EXTERNAL tidak ditentukan, pernyataan akan membuat volume terkelola.

  • JIKA TIDAK ADA

    Membuat volume dengan nama yang diberikan jika volume tersebut belum ada. Jika volume dengan nama yang sama sudah ada, tidak ada yang akan terjadi.

  • volume_name

    Nama volume yang akan dibuat. Volume hanya dapat dibuat dalam skema Unity Catalog.

  • LOKASI location_path

    location_path adalah literal STRING yang menentukan jalur sistem file di mana volume eksternal yang ditentukan dibuat. Jika jalur yang ditentukan tidak ada di sistem file yang mendasarinya, buat direktori dengan jalur tersebut. Jalur yang dipilih tidak boleh tumpang tindih dengan lokasi volume atau tabel lainnya.

  • Klausa ini tidak berlaku untuk volume terkelola .

  • komentar

    Deskripsi harfiah opsional STRING untuk volume.

Contoh

Klausa LOCATION untuk volume eksternal menggunakan URI penyimpanan cloud:

-- Create an external volume on the specified location with comment
> CREATE EXTERNAL VOLUME my_catalog.my_schema.my_external_volume
    LOCATION 'abfss://my-container@mystorageaccount.dfs.core.windows.net/my-location/my-path'
    COMMENT 'This is my example external volume on ADLS Gen2'
  OK

Setelah volume eksternal dibuat, langkah-langkah yang tersisa sama di setiap cloud:

-- Query the data from the file in the created volume
> SELECT *
    FROM csv.`/Volumes/my_catalog/my_schema/my_external_volume/foo.csv`

-- Create a managed volume with full schema name
> CREATE VOLUME my_catalog.my_schema.my_volume
  OK

-- Create a managed volume in default catalog and schema
> CREATE VOLUME my_another_volume
  OK
  • Last updated on