Bagikan melalui


grup perintah catalogs

Note

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

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

catalogs Grup perintah dalam Databricks CLI memungkinkan Anda mengelola katalog di Unity Catalog. Katalog adalah lapisan pertama dari namespace tiga tingkat Unity Catalog. Ini digunakan untuk mengatur aset data Anda. Lihat Apa itu Katalog Unity?.

Buat katalog Databricks

Buat instans katalog baru di metastore induk jika pemanggil adalah admin metastore atau memiliki CREATE_CATALOG hak istimewa.

databricks catalogs create NAME [flags]

Arguments

NAME

    Nama katalog

Opsi

--comment string

    Deskripsi teks bentuk bebas yang disediakan pengguna

--connection-name string

    Nama koneksi ke sumber data eksternal

--json JSON

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

--provider-name string

    Nama penyedia layanan berbagi delta

--share-name string

    Nama saham di bawah penyedia saham

--storage-root string

    URL akar penyimpanan untuk tabel terkelola dalam katalog

Bendera global

Examples

Contoh berikut membuat katalog bernama sales:

databricks catalogs create sales

Contoh berikut membuat katalog dengan komentar:

databricks catalogs create sales --comment "Sales data catalog"

penghapusan katalog databricks

Hapus katalog yang cocok dengan nama yang disediakan. Pemanggil harus menjadi admin metastore atau pemilik katalog.

databricks catalogs delete NAME [flags]

Arguments

NAME

    Nama katalog

Opsi

--force

    Penghapusan paksa meskipun katalog tidak kosong

Bendera global

Examples

Contoh berikut menghapus katalog bernama sales:

databricks catalogs delete sales

Contoh berikut memaksa penghapusan katalog yang tidak kosong:

databricks catalogs delete sales --force

mendapatkan katalog databricks

Dapatkan katalog yang ditentukan di metastore. Pemanggil harus merupakan admin metastore, pemilik katalog, atau pengguna yang memiliki USE_CATALOG hak istimewa yang ditetapkan untuk akun mereka.

databricks catalogs get NAME [flags]

Arguments

NAME

    Nama katalog

Opsi

--include-browse

    Apakah akan menyertakan katalog dalam respons yang mana prinsipal hanya dapat mengakses metadata secara selektif.

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang katalog bernama sales:

databricks catalogs get sales

Contoh berikut mendapatkan informasi katalog, termasuk katalog yang hanya dapat ditelusuri.

databricks catalogs get sales --include-browse

daftar katalog databricks

Mendaftar katalog di metastore. Jika penelepon adalah admin metastore, semua katalog penuh dapat diakses. Jika tidak, hanya katalog yang dimiliki oleh pemanggil (atau di mana pemanggil memiliki USE_CATALOG hak istimewa) yang akan diambil. Tidak ada jaminan urutan elemen tertentu dalam array.

databricks catalogs list [flags]

Opsi

--include-browse

    Apakah akan menyertakan katalog dalam respons yang mana prinsipal hanya dapat mengakses metadata secara selektif.

--max-results int

    Jumlah maksimum katalog yang akan dikembalikan

--page-token string

    Token paginasi buram untuk masuk ke halaman berikutnya berdasarkan kueri sebelumnya

Bendera global

Examples

Contoh berikut mencantumkan semua katalog:

databricks catalogs list

Contoh berikut mencantumkan katalog dengan maksimal 10 hasil:

databricks catalogs list --max-results 10

Contoh berikut mencantumkan katalog termasuk katalog khusus penelusuran:

databricks catalogs list --include-browse

pembaruan katalog databricks

Perbarui katalog yang cocok dengan nama yang disediakan. Pemanggil harus merupakan pemilik katalog, atau seorang administrator metastore (ketika mengubah bidang pemilik pada katalog).

databricks catalogs update NAME [flags]

Arguments

NAME

    Nama katalog

Opsi

--comment string

    Deskripsi teks bentuk bebas yang disediakan pengguna

--enable-predictive-optimization EnablePredictiveOptimization

    Apakah pengoptimalan prediktif harus diaktifkan untuk objek dan objek ini di bawahnya. Nilai yang didukung: DISABLE, ENABLE, INHERIT

--isolation-mode CatalogIsolationMode

    Apakah securable saat ini dapat diakses dari semua workspace atau sekumpulan workspace tertentu. Nilai yang didukung: ISOLATED, OPEN

--json JSON

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

--new-name string

    Nama baru untuk katalog

--owner string

    Nama pengguna pemilik katalog saat ini

Bendera global

Examples

Contoh berikut memperbarui komentar katalog:

databricks catalogs update sales --comment "Updated sales data catalog"

Contoh berikut mengganti nama katalog:

databricks catalogs update sales --new-name sales-prod

Contoh berikut mengubah pemilik katalog:

databricks catalogs update sales --owner someone@example.com

Contoh berikut memungkinkan pengoptimalan prediktif untuk katalog:

databricks catalogs update sales --enable-predictive-optimization ENABLE

Bendera dunia

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