BUAT VOLUME

  • Artikel

Berlaku untuk:centang ditandai ya Databricks SQL centang ditandai ya Databricks Runtime 13.3 LTS dan di atas centang ditandai ya Unity Catalog saja

Membuat volume dengan nama yang ditentukan. Jika volume dengan nama yang sama sudah ada dalam skema SCHEMA_NOT_FOUND 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. Jika EXTERNAL tidak ditentukan, pernyataan akan membuat volume terkelola.

  • IF NOT EXISTS

    Membuat volume dengan nama yang diberikan jika tidak 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_pathadalah literal yang STRING menentukan jalur sistem file tempat 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