Bagikan melalui


grup perintah registered-models

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.

registered-models Grup perintah dalam Databricks CLI berisi perintah untuk mengelola model dalam registri model di Unity Catalog. Model terdaftar menyediakan kontrol akses terpusat, audit, silsilah data, dan penemuan model ML di seluruh ruang kerja Databricks. Lihat Mengelola siklus hidup model di Unity Catalog.

model-terdaftar databricks membuat

Buat model terdaftar baru di Unity Catalog.

Penyimpanan file untuk versi model dalam model terdaftar akan terletak di lokasi default yang ditentukan oleh skema induk, atau katalog induk, atau Metastore.

Agar pembuatan model terdaftar 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 MODEL hak istimewa atau CREATE FUNCTION pada skema induk.
databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

    Nama katalog tempat skema dan model terdaftar berada.

SCHEMA_NAME

    Nama skema tempat model terdaftar berada.

NAME

    Nama model terdaftar.

Opsi

--comment string

    Komentar yang dilampirkan pada model yang terdaftar.

--json JSON

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

--storage-location string

    Lokasi penyimpanan di cloud tempat file data versi model disimpan.

Bendera global

Examples

Contoh berikut membuat model terdaftar dalam katalog dan skema yang ditentukan:

databricks registered-models create main my_schema my_model

Contoh berikut membuat model terdaftar dengan komentar:

databricks registered-models create main my_schema my_model --comment "My model description"

Hapus model terdaftar di databricks

Hapus model terdaftar dan semua versi modelnya dari katalog dan skema induk yang ditentukan.

Pemanggil harus menjadi admin metastore atau pemilik model terdaftar. 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 registered-models delete FULL_NAME [flags]

Arguments

FULL_NAME

    Nama berjenjang tiga (sepenuhnya memenuhi syarat) dari model yang terdaftar.

Opsi

Bendera global

Examples

Contoh berikut menghapus model terdaftar:

databricks registered-models delete main.my_schema.my_model

databricks model-terdaftar hapus-alias

Menghapus sebuah alias model terdaftar.

Pemanggil harus menjadi admin metastore atau pemilik model terdaftar. 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 registered-models delete-alias FULL_NAME ALIAS [flags]

Arguments

FULL_NAME

    Nama berjenjang tiga (sepenuhnya memenuhi syarat) dari model yang terdaftar.

ALIAS

    Nama alias.

Opsi

Bendera global

Examples

Contoh berikut menghapus alias model terdaftar:

databricks registered-models delete-alias main.my_schema.my_model production

databricks registered-models get (perintah untuk mendapatkan model terdaftar di databricks)

Dapatkan model yang terdaftar.

Penelepon harus menjadi admin metastore atau pemilik (atau memiliki EXECUTE hak istimewa) model terdaftar. 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 registered-models get FULL_NAME [flags]

Arguments

FULL_NAME

    Nama berjenjang tiga (sepenuhnya memenuhi syarat) dari model yang terdaftar.

Opsi

--include-aliases

    Apakah akan menyertakan alias model terdaftar dalam respons.

--include-browse

    Apakah akan menyertakan model-model terdaftar dalam respons di mana prinsipal hanya dapat mengakses metadata tertentu.

Bendera global

Examples

Contoh berikut mendapatkan informasi tentang model terdaftar:

databricks registered-models get main.my_schema.my_model

Contoh berikut mendapatkan informasi tentang model terdaftar termasuk alias:

databricks registered-models get main.my_schema.my_model --include-aliases

daftar model terdaftar di databricks

Daftar model terdaftar. Anda dapat mencantumkan model terdaftar di bawah skema tertentu, atau mencantumkan semua model terdaftar di metastore saat ini.

Model yang dikembalikan difilter berdasarkan hak istimewa pengguna panggilan. Misalnya, admin metastore dapat mencantumkan semua model terdaftar. Pengguna reguler harus menjadi pemilik atau memiliki hak istimewa EXECUTE pada model terdaftar agar dapat menerima model-model terdaftar dalam sebuah 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 respons.

databricks registered-models list [flags]

Opsi

--catalog-name string

    Identifikasi katalog di mana model terdaftar akan dicantumkan.

--include-browse

    Apakah akan menyertakan model-model terdaftar dalam respons di mana prinsipal hanya dapat mengakses metadata tertentu.

--max-results int

    Jumlah maksimum model terdaftar untuk dikembalikan.

--page-token string

    Token buram untuk dikirim untuk halaman hasil berikutnya (penomoran halaman).

--schema-name string

    Pengidentifikasi skema di bawah mana model terdaftar dicantumkan.

Bendera global

Examples

Contoh berikut mencantumkan semua model terdaftar di metastore saat ini:

databricks registered-models list

Contoh berikut mencantumkan model terdaftar dalam katalog tertentu:

databricks registered-models list --catalog-name main

Contoh berikut mencantumkan model terdaftar dalam skema tertentu:

databricks registered-models list --catalog-name main --schema-name my_schema

databricks model-terdaftar set-alias

Atur alias pada model terdaftar yang ditentukan.

Pemanggil harus menjadi admin metastore atau pemilik model terdaftar. 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 registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]

Arguments

FULL_NAME

    Nama lengkap model terdaftar.

ALIAS

    Nama alias.

VERSION_NUM

    Nomor versi dari model yang ditunjukkan oleh alias.

Opsi

--json JSON

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

Bendera global

Examples

Contoh berikut menetapkan alias pada model terdaftar:

databricks registered-models set-alias main.my_schema.my_model production 1

pembaruan model terdaftar Databricks

Perbarui model terdaftar yang ditentukan.

Pemanggil harus menjadi admin metastore atau pemilik model terdaftar. 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 model terdaftar yang dapat diperbarui.

databricks registered-models update FULL_NAME [flags]

Arguments

FULL_NAME

    Nama berjenjang tiga (sepenuhnya memenuhi syarat) dari model yang terdaftar.

Opsi

--comment string

    Komentar yang dilampirkan pada model yang terdaftar.

--json JSON

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

'--nama-baru string'

    Nama baru untuk model terdaftar.

--owner string

    Identifikasi pengguna yang memiliki model yang terdaftar.

Bendera global

Examples

Contoh berikut memperbarui komentar model terdaftar:

databricks registered-models update main.my_schema.my_model --comment "Updated model description"

Contoh berikut memperbarui nama model terdaftar:

databricks registered-models update main.my_schema.my_model --new-name my_new_model

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