Bagikan melalui

Volumes

Berlaku untuk:ditandai ya Databricks SQL ditandai ya Databricks Runtime 13.3 LTS ke atas ditandai ya hanya untuk Unity Catalog

Volume adalah objek Katalog Unity yang mewakili volume penyimpanan logis di lokasi penyimpanan objek cloud. Volume menyediakan kemampuan untuk mengakses, menyimpan, mengelola, dan mengatur file. Meskipun tabel menyediakan tata kelola atas himpunan data tabular, volume menambahkan tata kelola atas himpunan data non-tabular. Anda dapat menggunakan volume untuk menyimpan dan mengakses file dalam format apa pun, termasuk data terstruktur, semi terstruktur, dan tidak terstruktur.

Volume adalah saudara kandung dari tabel, tampilan, dan objek lain yang diatur di bawah skema di Unity Catalog.

Volume dapat dikelola atau eksternal.

Untuk informasi dan batasan selengkapnya, silakan lihat Apa itu volume Katalog Unity?.

Volume yang dikelola

Volume terkelola adalah volume penyimpanan yang diatur oleh Unity Catalog yang dibuat dalam lokasi penyimpanan dikelola dari skema yang berisi. Volume terkelola memungkinkan pembuatan penyimpanan yang diatur kebijakan untuk bekerja dengan file tanpa beban tambahan dari lokasi eksternal dan kredensial penyimpanan. Anda tidak perlu menentukan lokasi saat membuat volume terkelola, dan semua akses file untuk data dalam volume terkelola adalah melalui jalur yang dikelola oleh Katalog Unity.

Volume eksternal

Volume eksternal adalah volume penyimpanan yang diatur oleh Unity Catalog dan terdaftar pada direktori di dalam lokasi eksternal.

Penamaan dan referensi volume

Nama volume adalah pengidentifikasi yang dapat dikualifikasikan dengan katalog dan nama skema dalam perintah SQL.

Jalur untuk mengakses file dalam volume menggunakan format berikut:

/Volumes/<catalog_identifier>/<schema_identifier>/<volume_identifier>/<path>/<file_name>

Perhatikan bahwa Azure Databricks menormalkan pengidentifikasi ke huruf kecil.

Azure Databricks juga mendukung skema opsional dbfs:/ , sehingga jalur berikut juga berfungsi:

dbfs:/Volumes/<catalog_identifier>/<schema_identifier>/<volume_identifier>/<path>/<file_name>

Catatan

Anda juga dapat mengakses data dalam volume eksternal menggunakan URI penyimpanan cloud.

Mengelola file dalam volume penyimpanan

Berlaku untuk:centang ditandai ya Databricks SQL Connector

Menggunakan Konektor SQL Databricks, Anda dapat mengelola file dalam volume menggunakan perintah berikut:

  • PUT INTO untuk menyalin file dari penyimpanan lokal Anda ke dalam volume.
  • GET menyalin file dari volume ke penyimpanan lokal Anda.
  • REMOVE untuk menghapus file dari volume.

Contoh

--- Create an external volume under the directory “my-path”
> CREATE EXTERNAL VOLUME IF NOT EXISTS myCatalog.mySchema.myExternalVolume
        COMMENT 'This is my example external volume'
        LOCATION 's3://my-bucket/my-location/my-path'
 OK

--- Set the current catalog
> USE CATALOG myCatalog;
 OK

--- Set the current schema
> USE SCHEMA mySchema;
 OK

--- Create a managed volume; it is not necessary to specify a location
> CREATE VOLUME myManagedVolume
    COMMENT 'This is my example managed volume';
 OK

--- List the files inside the volume, all names are lowercase
> LIST '/Volumes/mycatalog/myschema/myexternalvolume'
 sample.csv

> LIST 'dbfs:/Volumes/mycatalog/myschema/mymanagedvolume'
 sample.csv

--- Print the content of a csv file
> SELECT * FROM csv.`/Volumes/mycatalog/myschema/myexternalvolume/sample.csv`
 20

> SELECT * FROM csv.`dbfs:/Volumes/mycatalog/myschema/mymanagedvolume/sample.csv`
 20
  • Last updated on