Bagikan melalui

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.

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


-- Create an external volume on the specified location with comment
> CREATE EXTERNAL VOLUME my_catalog.my_schema.my_external_volume
    LOCATION 's3://my-bucket/my-location/my-path'
    COMMENT 'This is my example external volume on S3'
  OK

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