Bagikan melalui

grup perintah volumes

Note

Informasi ini berlaku untuk Databricks CLI versi 0.205 ke atas. Databricks CLI ada di Pratinjau Umum.

Penggunaan Databricks CLI tunduk pada Lisensi Databricks dan Pemberitahuan Privasi Databricks, termasuk ketentuan Data Penggunaan apa pun.

Grup volumes perintah dalam Databricks CLI berisi perintah untuk mengelola volume di Unity Catalog. Volume menyediakan fitur untuk mengakses, menyimpan, mengatur, mengelola, dan memproses file. Lihat Apa itu Unity Catalog volumes?.

buat volume databricks

Buat volume baru.

Pengguna dapat membuat volume eksternal atau volume terkelola. Volume eksternal akan dibuat di lokasi eksternal yang ditentukan, sementara volume terkelola akan terletak di lokasi default yang ditentukan oleh skema induk, atau katalog induk, atau metastore.

Agar pembuatan volume berhasil, pengguna harus memenuhi kondisi berikut:

  • Pemanggil harus menjadi admin metastore, atau menjadi pemilik katalog dan skema induk, atau memiliki USE_CATALOG hak istimewa pada katalog induk dan USE_SCHEMA hak istimewa pada skema induk.
  • Pemanggil harus memiliki CREATE VOLUME hak istimewa pada skema induk.

Untuk volume eksternal, kondisi berikut juga perlu dipenuhi:

  • Pemanggil harus memiliki CREATE EXTERNAL VOLUME hak istimewa pada lokasi eksternal.
  • Tidak ada tabel lain, atau volume yang ada di lokasi penyimpanan yang ditentukan. - Lokasi penyimpanan yang ditentukan tidak berada di bawah lokasi tabel lain, atau volume, atau katalog atau skema.
databricks volumes create CATALOG_NAME SCHEMA_NAME NAME VOLUME_TYPE [flags]

Arguments

CATALOG_NAME

    Nama katalog tempat skema dan volume berada

SCHEMA_NAME

    Nama skema tempat volume berada

NAME

    Nama volume

VOLUME_TYPE

    Jenis volume. Volume eksternal terletak di lokasi eksternal yang ditentukan. Volume terkelola terletak di lokasi default yang ditentukan oleh skema induk, atau katalog induk, atau Metastore. Lihat Volume terkelola versus eksternal. Nilai yang didukung: EXTERNAL, MANAGED

Opsi

--comment string

    Komentar yang dilampirkan ke volume.

--json JSON

    String JSON sebaris atau @path ke file JSON dengan isi permintaan.

--storage-location string

    Lokasi penyimpanan di cloud.

Bendera global

Examples

Contoh berikut membuat volume terkelola:

databricks volumes create my_catalog my_schema my_volume MANAGED

Contoh berikut membuat volume eksternal dengan komentar:

databricks volumes create my_catalog my_schema my_external_volume EXTERNAL --storage-location s3://my-bucket/my-volume --comment "External volume for data processing"

penghapusan volume databricks

Hapus volume dari katalog dan skema induk yang ditentukan.

Pemanggil harus menjadi admin metastore atau pemilik volume. Untuk kasus terakhir, pemanggil juga harus menjadi pemilik atau memiliki USE_CATALOG hak istimewa pada katalog induk dan USE_SCHEMA hak istimewa pada skema induk.

databricks volumes delete NAME [flags]

Arguments

NAME

    Nama volume tiga tingkat (sepenuhnya memenuhi syarat)

Opsi

Bendera global

Examples

Contoh berikut menghapus volume:

databricks volumes delete my_catalog.my_schema.my_volume

Daftar Volume Databricks

Mencantumkan volume untuk metastore saat ini di bawah katalog dan skema induk.

Volume yang dikembalikan difilter berdasarkan hak istimewa pengguna panggilan. Misalnya, admin metastore dapat mencantumkan semua volume. Pengguna reguler harus menjadi pemilik atau memiliki READ VOLUME hak istimewa pada volume untuk menerima volume dalam respons. Untuk kasus terakhir, pemanggil juga harus menjadi pemilik atau memiliki USE_CATALOG hak istimewa pada katalog induk dan USE_SCHEMA hak istimewa pada skema induk.

Tidak ada jaminan urutan elemen tertentu dalam array.

databricks volumes list CATALOG_NAME SCHEMA_NAME [flags]

Arguments

CATALOG_NAME

    Pengidentifikasi untuk katalog

SCHEMA_NAME

    Pengidentifikasi skema

Opsi

--include-browse

    Apakah akan menyertakan volume dalam respons di mana prinsipal hanya dapat mengakses metadata selektif.

--max-results int

    Jumlah maksimum volume yang akan dikembalikan (panjang halaman).

--page-token string

    Token buram hasil dari permintaan sebelumnya.

Bendera global

Examples

Contoh berikut mencantumkan semua volume dalam katalog dan skema:

databricks volumes list my_catalog my_schema

volume databricks dibaca

Dapatkan volume dari metastore untuk katalog dan skema tertentu.

Pemanggil harus merupakan admin metastore atau pemilik (atau memiliki hak istimewa READ VOLUME pada) volume. Untuk kasus terakhir, pemanggil juga harus menjadi pemilik atau memiliki USE_CATALOG hak istimewa pada katalog induk dan USE_SCHEMA hak istimewa pada skema induk.

databricks volumes read NAME [flags]

Arguments

NAME

    Nama volume tiga tingkat (sepenuhnya memenuhi syarat)

Opsi

--include-browse

    Apakah akan menyertakan volume dalam respons di mana prinsipal hanya dapat mengakses metadata selektif.

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang volume:

databricks volumes read my_catalog.my_schema.my_volume

Contoh berikut mendapatkan informasi volume termasuk menelusuri metadata:

databricks volumes read my_catalog.my_schema.my_volume --include-browse

pembaruan databricks volume

Perbarui volume yang ditentukan di bawah katalog dan skema induk yang ditentukan.

Pemanggil harus menjadi admin metastore atau pemilik volume. Untuk kasus terakhir, pemanggil juga harus menjadi pemilik atau memiliki USE_CATALOG hak istimewa pada katalog induk dan USE_SCHEMA hak istimewa pada skema induk.

Saat ini hanya nama, pemilik atau komentar volume yang dapat diperbarui.

databricks volumes update NAME [flags]

Arguments

NAME

    Nama volume tiga tingkat (sepenuhnya memenuhi syarat)

Opsi

--comment string

    Komentar yang dilampirkan ke volume.

--json JSON

    String JSON sebaris atau @path ke file JSON dengan isi permintaan.

--new-name string

    Nama baru untuk volume.

--owner string

    ID pengguna pemilik volume.

Bendera global

Examples

Contoh berikut memperbarui komentar volume:

databricks volumes update my_catalog.my_schema.my_volume --comment "Updated comment for my volume"

Contoh berikut mengubah pemilik volume:

databricks volumes update my_catalog.my_schema.my_volume --owner someone@example.com

Contoh berikut mengganti nama volume:

databricks volumes update my_catalog.my_schema.my_volume --new-name my_new_volume_name

Bendera global

--debug

  Apakah debug logging ingin diaktifkan?

-h atau --help

    Tampilkan bantuan untuk Databricks CLI atau grup perintah terkait atau perintah terkait.

--log-file tali

    String yang mewakili file yang akan digunakan untuk menulis log output. Jika bendera ini tidak ditentukan, maka defaultnya adalah menulis log output ke stderr.

--log-format Format

    Jenis format log, text atau json. Nilai defaultnya adalah text.

--log-level tali

    Untaian yang menggambarkan tingkat format log. Jika tidak ditentukan, maka tingkat format log akan dinonaktifkan.

-o, --output jenis

    Jenis output perintah, text atau json. Nilai defaultnya adalah text.

-p, --profile tali

    Nama profil dalam file ~/.databrickscfg yang digunakan untuk menjalankan perintah. Jika bendera ini tidak ditentukan maka jika ada, profil bernama DEFAULT digunakan.

--progress-format Format

    Format untuk menampilkan log kemajuan: default, , append, inplaceatau json

-t, --target tali

    Jika berlaku, target bundel yang akan digunakan

  • Last updated on