Bagikan melalui


grup perintah model-registry

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.

Note

Referensi API ini mendokumentasikan API untuk Registri Model Ruang Kerja. Databricks merekomendasikan penggunaan Model di Unity Catalog sebagai gantinya. Model di Unity Catalog menyediakan tata kelola model terpusat, akses lintas ruang kerja, silsilah data, dan penyebaran. Registri Model Ruang Kerja tidak akan digunakan lagi di masa mendatang.

model-registry Grup perintah dalam Databricks CLI memungkinkan Anda mengelola siklus hidup penuh Model MLflow. Registri Model Ruang Kerja adalah repositori model terpusat dan UI dan sekumpulan API yang memungkinkan Anda mengelola siklus hidup penuh Model MLflow.

databricks model-registry setujui-permintaan-transisi

Menyetujui permintaan transisi tahap versi model.

databricks model-registry approve-transition-request NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]

Arguments

NAME

    Nama model.

VERSION

    Versi model.

STAGE

    Tahap transisi yang ditargetkan. Nilai yang didukung: Archived, None, Production, Staging

ARCHIVE_EXISTING_VERSIONS

    Menentukan apakah akan mengarsipkan semua versi-versi model yang ada saat ini pada tahap target.

Opsi

--comment string

    Komentar yang disediakan pengguna tentang tindakan tersebut.

--json JSON

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

Bendera global

Databricks model-registry membuat-komentar

Pasang komentar pada versi model. Komentar dapat dikirimkan baik oleh pengguna atau secara terprogram untuk menampilkan informasi yang relevan tentang model. Misalnya, hasil pengujian atau kesalahan penyebaran.

databricks model-registry create-comment NAME VERSION COMMENT [flags]

Arguments

NAME

    Nama model.

VERSION

    Versi model.

COMMENT

    Komentar yang disediakan pengguna tentang tindakan tersebut.

Opsi

--json JSON

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

Bendera global

Databricks registri model membuat model

Buat model terdaftar baru dengan nama yang ditentukan dalam isi permintaan.

Menghasilkan RESOURCE_ALREADY_EXISTS jika model terdaftar dengan nama yang diberikan sudah ada.

databricks model-registry create-model NAME [flags]

Arguments

NAME

    Daftarkan model dengan nama ini

Opsi

--description string

    Deskripsi opsional untuk model terdaftar.

--json JSON

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

Bendera global

Penggunaan "databricks model-registry create-model-version" merupakan perintah untuk membuat versi model dalam registri di platform Databricks.

Membuat versi model.

databricks model-registry create-model-version NAME SOURCE [flags]

Arguments

NAME

    Daftarkan model dengan nama ini

SOURCE

    URI yang menunjukkan lokasi artefak model.

Opsi

--description string

    Deskripsi opsional untuk versi model.

--json JSON

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

--run-id string

    ID eksekusi MLflow untuk korelasi, jika sumber dihasilkan oleh eksperimen yang dijalankan di server pelacakan MLflow.

--run-link string

    Tautan eksekusi MLflow - ini adalah tautan yang tepat dari eksekusi yang menghasilkan versi model ini, berpotensi dihosting di instans MLflow lain.

Bendera global

Permintaan Transisi Buat Registri Model Databricks

Buat permintaan transisi tahap versi model.

databricks model-registry create-transition-request NAME VERSION STAGE [flags]

Arguments

NAME

    Nama model.

VERSION

    Versi model.

STAGE

    Tahap transisi yang ditargetkan. Nilai yang valid adalah:

  • Tidak Ada: Tahap awal versi model.
  • Penahapan: Tahap pra-produksi.
  • Produksi: Tahap produksi.
  • Diarsipkan: Tahap yang diarsipkan.

Nilai yang didukung: [Diarsipkan, Tidak Ada, Produksi, Penyiapan]

Opsi

--comment string

    Komentar yang disediakan pengguna tentang tindakan tersebut.

--json JSON

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

Bendera global

databricks model-registry buat-webhook

Note

Perintah ini sedang dalam Pratinjau Umum.

Membuat webhook registri.

databricks model-registry create-webhook [flags]

Arguments

None

Opsi

--description string

    Deskripsi yang ditentukan oleh pengguna untuk webhook.

--json JSON

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

--model-name string

    Nama model yang kejadian-kejadiannya akan memicu webhook ini.

--status RegistryWebhookStatus

    Aktifkan atau nonaktifkan pemicu webhook, atau masukkan webhook ke mode uji. Nilai yang didukung: [AKTIF, NONAKTIF, MODE_UJI]

Bendera global

databricks model-registry hapus-komentar

Menghapus komentar pada versi model.

databricks model-registry delete-comment ID [flags]

Arguments

ID

    Pengidentifikasi unik komentar yang akan dihapus.

Opsi

Bendera global

model-registri databricks delete-model

Menghapus model terdaftar.

databricks model-registry delete-model NAME [flags]

Arguments

NAME

    Pengidentifikasi nama unik model yang terdaftar.

Opsi

Bendera global

databricks registri-model hapus-tanda-model

Hapus tag untuk model terdaftar.

databricks model-registry delete-model-tag NAME KEY [flags]

Arguments

NAME

    Nama model terdaftar tempat tag dicatat.

KEY

    Nama tag. Nama harus sama persis; penghapusan wild-card tidak didukung. Ukuran maksimum adalah 250 byte.

Opsi

Bendera global

databricks registry-model hapus-versi-model

Hapus versi model.

databricks model-registry delete-model-version NAME VERSION [flags]

Arguments

NAME

    Nama model terdaftar

VERSION

    Nomor versi model

Opsi

Bendera global

registrasi-model databricks hapus-tanda-versi-model

Hapus tag versi model.

databricks model-registry delete-model-version-tag NAME VERSION KEY [flags]

Arguments

NAME

    Nama model terdaftar tempat tag dicatat.

VERSION

    Nomor versi model di bawah mana tag tercatat.

KEY

    Nama tag. Nama harus sama persis; penghapusan wild-card tidak didukung. Ukuran maksimum adalah 250 byte.

Opsi

Bendera global

databricks model-registry permintaan penghapusan transisi

Batalkan permintaan transisi tahap versi model.

databricks model-registry delete-transition-request NAME VERSION STAGE CREATOR [flags]

Arguments

NAME

    Nama model.

VERSION

    Versi model.

STAGE

    Tahap sasaran permintaan transisi. Nilai yang valid adalah:

  • Tidak Ada: Tahap awal versi model.
  • Penahapan: Tahap pra-produksi.
  • Produksi: Tahap produksi.
  • Diarsipkan: Tahap yang diarsipkan.

Nilai yang didukung: [Diarsipkan, Tidak Ada, Produksi, Penyiapan]

CREATOR

    Nama pengguna pengguna yang membuat permintaan ini. Dari permintaan transisi yang cocok dengan detail yang ditentukan, hanya satu transisi yang dibuat oleh pengguna ini yang akan dihapus.

Opsi

--comment string

    Komentar yang disediakan pengguna tentang tindakan tersebut.

Bendera global

penghapusan webhook registri model databricks

Note

Perintah ini sedang dalam Pratinjau Umum.

Menghapus webhook pada registri sistem.

databricks model-registry delete-webhook [flags]

Arguments

None

Opsi

--id string

    ID Webhook diperlukan untuk menghapus webhook registri.

Bendera global

Registri model Databricks dapatkan-versi-terbaru

Dapatkan versi terbaru dari model yang sudah terdaftar.

databricks model-registry get-latest-versions NAME [flags]

Arguments

NAME

    Pengidentifikasi nama unik model yang terdaftar.

Opsi

--json JSON

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

Bendera global

model-registri databricks get-model

Dapatkan rincian model. Ini adalah versi ruang kerja Databricks dari endpoint MLflow yang juga mengembalikan ID ruang kerja Databricks model dan tingkat izin pengguna yang mengajukan permintaan pada model.

databricks model-registry get-model NAME [flags]

Arguments

NAME

    Pengidentifikasi nama unik model yang terdaftar.

Opsi

Bendera global

databricks model-registry dapatkan-versi-model

Dapatkan versi model.

databricks model-registry get-model-version NAME VERSION [flags]

Arguments

NAME

    Nama model terdaftar

VERSION

    Nomor versi model

Opsi

Bendera global

databricks model-registry get-model-version-download-uri (perintah untuk mendapatkan URI unduhan versi model)

Dapatkan URI untuk mengunduh versi model.

databricks model-registry get-model-version-download-uri NAME VERSION [flags]

Arguments

NAME

    Nama model terdaftar

VERSION

    Nomor versi model

Opsi

Bendera global

registri model databricks daftar-model

Cantumkan semua model terdaftar yang tersedia, hingga batas yang ditentukan dalam max_results.

databricks model-registry list-models [flags]

Arguments

None

Opsi

--max-results int

    Jumlah maksimum model terdaftar yang diinginkan.

--page-token string

    Token paginasi untuk melanjutkan ke halaman berikutnya berdasarkan kueri sebelumnya.

Bendera global

Daftar permintaan transisi di databricks model-registry

Dapatkan daftar semua permintaan transisi tahap terbuka untuk versi model.

databricks model-registry list-transition-requests NAME VERSION [flags]

Arguments

NAME

    Nama model.

VERSION

    Versi model.

Opsi

Bendera global

databricks model-registry daftar-webhooks

Note

Perintah ini sedang dalam Pratinjau Umum.

Daftarkan semua webhook dalam registri.

databricks model-registry list-webhooks [flags]

Arguments

None

Opsi

--model-name string

    Jika tidak ditentukan, semua webhook yang terkait dengan peristiwa yang ditentukan tercantum, terlepas dari model terkaitnya.

--page-token string

    Token yang menunjukkan halaman hasil artefak untuk diambil.

Bendera global

Penolakan permintaan transisi model-registry di Databricks

Tolak permintaan untuk transisi tahap versi model.

databricks model-registry reject-transition-request NAME VERSION STAGE [flags]

Arguments

NAME

    Nama model.

VERSION

    Versi model.

STAGE

    Tahap transisi yang ditargetkan. Nilai yang valid adalah:

  • Tidak Ada: Tahap awal versi model.
  • Penahapan: Tahap pra-produksi.
  • Produksi: Tahap produksi.
  • Diarsipkan: Tahap yang diarsipkan.

Nilai yang didukung: [Diarsipkan, Tidak Ada, Produksi, Penyiapan]

Opsi

--comment string

    Komentar yang disediakan pengguna tentang tindakan tersebut.

--json JSON

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

Bendera global

model-registri databricks mengubah nama model

Mengganti nama model terdaftar.

databricks model-registry rename-model NAME [flags]

Arguments

NAME

    Pengidentifikasi nama unik model yang terdaftar.

Opsi

--json JSON

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

--new-name string

    Jika disediakan, perbarui nama untuk registered_model ini.

Bendera global

databricks model-registri pencarian-versi-model

Cari versi model tertentu berdasarkan filter yang disediakan.

databricks model-registry search-model-versions [flags]

Arguments

None

Opsi

--filter string

    Kondisi filter string, contohnya "name='my-model-name'".

--max-results int

    Jumlah maksimum model yang diinginkan.

--page-token string

    Token untuk berpindah halaman ke halaman berikutnya berdasarkan kueri pencarian sebelumnya.

Bendera global

pencarian-model model-registry databricks

Cari model terdaftar berdasarkan filter yang ditentukan.

databricks model-registry search-models [flags]

Arguments

None

Opsi

--filter string

    Kondisi filter string, seperti "nama SEPERTI 'my-model-name'".

--max-results int

    Jumlah maksimum model yang diinginkan.

--page-token string

    Token paginasi untuk menuju ke halaman berikutnya berdasarkan kueri pencarian sebelumnya.

Bendera global

databricks registri-model setel-tag-model

Atur tag pada model terdaftar.

databricks model-registry set-model-tag NAME KEY VALUE [flags]

Arguments

NAME

    Nama unik model.

KEY

    Nama tag. Ukuran maksimum tergantung pada backend penyimpanan. Jika tag dengan nama ini sudah ada, nilai yang sudah ada sebelumnya akan digantikan oleh nilai yang ditentukan. Semua backend penyimpanan dijamin untuk mendukung nilai kunci hingga ukuran 250 byte.

VALUE

    Nilai string tag yang dicatat. Ukuran maksimum tergantung pada backend penyimpanan. Semua backend penyimpanan dijamin untuk mendukung nilai kunci hingga ukuran 5000 byte.

Opsi

--json JSON

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

Bendera global

Databricks registri-model mengatur-tanda-versi-model

Tetapkan tag versi model.

databricks model-registry set-model-version-tag NAME VERSION KEY VALUE [flags]

Arguments

NAME

    Nama unik model.

VERSION

    Nomor versi model.

KEY

    Nama tag. Ukuran maksimum tergantung pada backend penyimpanan. Jika tag dengan nama ini sudah ada, nilai yang sudah ada sebelumnya akan digantikan oleh nilai yang ditentukan. Semua backend penyimpanan dijamin untuk mendukung nilai kunci hingga ukuran 250 byte.

VALUE

    Nilai string tag yang dicatat. Ukuran maksimum tergantung pada backend penyimpanan. Semua backend penyimpanan dijamin untuk mendukung nilai kunci hingga ukuran 5000 byte.

Opsi

--json JSON

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

Bendera global

databricks model-registry test-registry-webhook

Note

Perintah ini sedang dalam Pratinjau Umum.

Uji webhook registri.

databricks model-registry test-registry-webhook ID [flags]

Arguments

ID

    Webhook ID

Opsi

--event RegistryWebhookEvent

    Jika peristiwa ditentukan, pemicu pengujian menggunakan peristiwa yang ditentukan. Nilai yang didukung: [ COMMENT_CREATED, MODEL_VERSION_CREATED, MODEL_VERSION_TAG_SET, MODEL_VERSION_TRANSITIONED_STAGE, MODEL_VERSION_TRANSITIONED_TO_ARCHIVED, MODEL_VERSION_TRANSITIONED_TO_PRODUCTION, MODEL_VERSION_TRANSITIONED_TO_STAGING, REGISTERED_MODEL_CREATED, TRANSITION_REQUEST_CREATED, TRANSITION_REQUEST_TO_ARCHIVED_CREATED, TRANSITION_REQUEST_TO_PRODUCTION_CREATED, TRANSITION_REQUEST_TO_STAGING_CREATED ]

--json JSON

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

Bendera global

tahap transisi registri model databricks

Mengubah tahap versi model. Ini adalah versi ruang kerja Databricks dari titik akhir MLflow yang juga menerima komentar yang terkait dengan transisi yang akan direkam.

databricks model-registry transition-stage NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]

Arguments

NAME

    Nama model.

VERSION

    Versi model.

STAGE

    Tahap transisi yang ditargetkan. Nilai yang valid adalah:

  • Tidak Ada: Tahap awal versi model.
  • Penahapan: Tahap pra-produksi.
  • Produksi: Tahap produksi.
  • Diarsipkan: Tahap yang diarsipkan.

Nilai yang didukung: [Diarsipkan, Tidak Ada, Produksi, Penyiapan]

ARCHIVE_EXISTING_VERSIONS

    Menentukan apakah akan mengarsipkan semua versi-versi model yang ada saat ini pada tahap target.

Opsi

--comment string

    Komentar yang disediakan pengguna tentang tindakan tersebut.

--json JSON

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

Bendera global

databricks model-registry memperbarui-komentar

Memposting suntingan pada komentar pada versi model.

databricks model-registry update-comment ID COMMENT [flags]

Arguments

ID

    Pengidentifikasi unik aktivitas

COMMENT

    Komentar yang disediakan pengguna tentang tindakan tersebut.

Opsi

--json JSON

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

Bendera global

perbarui-model registri-model databricks

Memperbarui model yang telah terdaftar.

databricks model-registry update-model NAME [flags]

Arguments

NAME

    Pengidentifikasi nama unik model yang terdaftar.

Opsi

--description string

    Jika disediakan, perbarui deskripsi untuk registered_model ini.

--json JSON

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

Bendera global

databricks model-registry update-model-version (perintah untuk memperbarui versi model pada registry di Databricks)

Perbarui versi model.

databricks model-registry update-model-version NAME VERSION [flags]

Arguments

NAME

    Nama model terdaftar

VERSION

    Nomor versi model

Opsi

--description string

    Jika disediakan, perbarui deskripsi untuk registered_model ini.

--json JSON

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

Bendera global

registri model databricks perbarui-webhook

Note

Perintah ini sedang dalam Pratinjau Umum.

Perbarui webhook pada registri.

databricks model-registry update-webhook ID [flags]

Arguments

ID

    Webhook ID

Opsi

--description string

    Deskripsi yang ditentukan oleh pengguna untuk webhook.

--json JSON

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

--status RegistryWebhookStatus

    Aktifkan atau nonaktifkan pemicu webhook, atau masukkan webhook ke mode uji. Nilai yang didukung: [AKTIF, NONAKTIF, MODE_UJI]

Bendera global

pencatatan model databricks mendapatkan tingkat izin

Dapatkan tingkat hak akses model yang telah terdaftar.

databricks model-registry get-permission-levels REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Model terdaftar untuk mendapatkan atau mengelola izin.

Opsi

Bendera global

databricks model-registry mendapatkan izin

Mendapatkan izin dari model terdaftar. Model yang terdaftar dapat mewarisi izin dari objek dasar.

databricks model-registry get-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Model terdaftar untuk mendapatkan atau mengelola izin.

Opsi

Bendera global

atur izin registri model Databricks

Atur izin model terdaftar, ganti izin yang ada jika ada. Menghapus semua izin langsung jika tidak ada yang ditentukan. Objek dapat mewarisi izin dari objek akarnya.

databricks model-registry set-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Model terdaftar untuk mendapatkan atau mengelola izin.

Opsi

--json JSON

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

Bendera global

izin pembaruan registri model databricks

Perbarui izin pada model terdaftar. Model yang terdaftar dapat mewarisi izin dari objek dasar.

databricks model-registry update-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Model terdaftar untuk mendapatkan atau mengelola izin.

Opsi

--json JSON

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

Bendera global

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