Bagikan melalui


grup perintah experiments

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.

experiments Grup perintah dalam Databricks CLI memungkinkan Anda membuat, mengedit, menghapus, dan mengelola eksperimen di MLflow. Lihat Mengatur jalannya pelatihan dengan eksperimen MLflow.

eksperimen databricks membuat eksperimen

Buat eksperimen dengan nama. Mengembalikan ID eksperimen yang baru dibuat. Memvalidasi bahwa eksperimen lain dengan nama yang sama belum ada dan gagal jika eksperimen lain dengan nama yang sama sudah ada.

Melemparkan RESOURCE_ALREADY_EXISTS jika eksperimen dengan nama yang diberikan ada.

databricks experiments create-experiment NAME [flags]

Arguments

NAME

    Nama eksperimen.

Opsi

--artifact-location string

    Lokasi tempat semua artefak untuk eksperimen disimpan.

--json JSON

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

Bendera global

membuat-run eksperimen Databricks

Buat pengulangan baru dalam eksperimen. Eksekusi biasanya merupakan eksekusi tunggal dari pembelajaran mesin atau alur ETL data. MLflow menggunakan eksekusi untuk melacak mlflowParam, mlflowMetric, dan mlflowRunTag yang terkait dengan satu eksekusi.

databricks experiments create-run [flags]

Arguments

None

Opsi

--experiment-id string

    ID eksperimen terkait.

--json JSON

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

--run-name string

    Nama eksekusi.

--start-time int

    Tanda waktu Unix dalam milidetik saat eksekusi dimulai.

--user-id string

    ID pengguna yang menjalankan eksekusi.

Bendera global

eksperimen databricks menghapus eksperimen

Tandai eksperimen serta metadata terkait, eksekusi, metrik, parameter, dan tag agar dapat dihapus. Jika eksperimen menggunakan FileStore, artefak yang terkait dengan eksperimen juga dihapus.

databricks experiments delete-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID eksperimen terkait.

Opsi

--json JSON

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

Bendera global

eksperimen databricks hapus-berjalan

Tandai proses untuk dihapus.

databricks experiments delete-run RUN_ID [flags]

Arguments

RUN_ID

    ID eksekusi yang akan dihapus.

Opsi

--json JSON

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

Bendera global

eksperimen databricks menghapus eksekusi

Penghapusan massal berjalan dalam eksperimen yang dibuat sebelum atau pada tanda waktu yang ditentukan. Menghapus paling banyak max_runs per permintaan. Untuk memanggil API ini dari Notebook Databricks di Python, Anda dapat menggunakan cuplikan kode klien pada

databricks experiments delete-runs EXPERIMENT_ID MAX_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    ID eksperimen yang berisi eksekusi yang akan dihapus.

MAX_TIMESTAMP_MILLIS

    Tanda waktu pembuatan maksimum dalam milidetik sejak zaman UNIX untuk menghapus eksekusi. Hanya eksekusi yang dibuat sebelum atau pada tanda waktu ini yang dihapus.

Opsi

--json JSON

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

--max-runs int

    Bilangan bulat positif opsional yang menunjukkan jumlah maksimum eksekusi yang akan dihapus.

Bendera global

Penghapusan tag pada eksperimen Databricks

Menghapus tag saat dijalankan. Tag adalah metadata yang dapat diperbarui selama eksekusi dan setelah eksekusi selesai.

databricks experiments delete-tag RUN_ID KEY [flags]

Arguments

RUN_ID

    ID dari eksperimen di mana tag dicatat. Required.

KEY

    Nama tag. Ukuran maksimum adalah 255 byte. Required.

Opsi

--json JSON

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

Bendera global

Eksperimen Databricks get-by-name

Dapatkan metadata untuk eksperimen dengan nama yang ditentukan.

Perintah ini akan mengembalikan eksperimen yang dihapus, tetapi lebih suka eksperimen aktif jika eksperimen aktif dan dihapus memiliki nama yang sama. Jika beberapa eksperimen yang dihapus memiliki nama yang sama, API akan mengembalikan salah satunya.

RESOURCE_DOES_NOT_EXIST Melemparkan jika tidak ada eksperimen dengan nama yang ditentukan.

databricks experiments get-by-name EXPERIMENT_NAME [flags]

Arguments

EXPERIMENT_NAME

    Nama eksperimen terkait.

Opsi

Bendera global

eksperimen Databricks "get-experiment"

Dapatkan metadata untuk eksperimen dengan ID yang ditentukan. Perintah ini berfungsi pada eksperimen yang dihapus.

databricks experiments get-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID eksperimen terkait.

Opsi

Bendera global

eksperimen databricks get-history

Dapatkan daftar semua nilai untuk metrik yang ditentukan untuk eksekusi tertentu.

databricks experiments get-history METRIC_KEY [flags]

Arguments

METRIC_KEY

    Nama metrik.

Opsi

--max-results int

    Jumlah maksimum rekaman Metrik untuk dikembalikan per permintaan yang dipaginasi.

--page-token string

    Token yang menunjukkan halaman riwayat metrik yang akan diambil.

--run-id string

    ID dari proses untuk mengambil nilai metrik.

--run-uuid string

    Tidak digunakan lagi, gunakan --run_id sebagai gantinya. ID dari proses untuk mengambil nilai metrik.

Bendera global

eksperimen databricks get-run

Dapatkan metadata, metrik, parameter, dan penanda untuk suatu run. Dalam kasus di mana beberapa metrik dengan kunci yang sama dicatat untuk suatu proses, hanya nilai dengan cap waktu terbaru yang dikembalikan.

Jika ada beberapa nilai dengan tanda waktu terbaru, kembalikan nilai maksimum ini.

databricks experiments get-run RUN_ID [flags]

Arguments

RUN_ID

    ID pelaksanaan yang akan diambil. Harus disediakan.

Opsi

--run-uuid string

    Tidak digunakan lagi, gunakan --run_id sebagai gantinya. ID pelaksanaan yang akan diambil.

Bendera global

eksperimen databricks daftar artefak

Menyusun daftar artefak untuk sebuah pelaksanaan. Mengambil prefiks artifact_path opsional yang jika ditentukan, respons hanya berisi artefak dengan awalan yang ditentukan. Maksimal 1000 artefak akan diambil untuk volume Katalog Unity. Gunakan databricks fs ls untuk mencantumkan artefak dalam volume Unity Catalog, yang mendukung penomoran halaman.

databricks experiments list-artifacts [flags]

Arguments

None

Opsi

--page-token string

    Token yang menunjukkan halaman hasil dari artefak yang akan diambil.

--path string

    Filter artefak yang cocok dengan jalur ini (jalur relatif dari direktori artefak akar).

--run-id string

    ID dari eksekusi yang artefaknya akan dicantumkan.

--run-uuid string

    Tidak digunakan lagi, gunakan --run_id sebagai gantinya. ID dari eksekusi yang artefaknya akan dicantumkan.

Bendera global

Daftar eksperimen Databricks

Dapatkan daftar semua eksperimen.

databricks experiments list-experiments [flags]

Arguments

None

Opsi

--max-results int

    Jumlah maksimum eksperimen yang diinginkan.

--page-token string

    Token yang menunjukkan halaman eksperimen untuk diambil.

--view-type ViewType

    Kualifikasi untuk jenis eksperimen yang akan dikembalikan. Nilai yang didukung: ACTIVE_ONLY, ALL, DELETED_ONLY

Bendera global

eksperimen databricks pencatatan-batch

Catat batch metrik, parameter, dan tag untuk suatu pelaksanaan. Jika ada data yang gagal dipertahankan, server akan merespons dengan kesalahan (kode status non-200). Untuk perilaku menimpa dan batas permintaan, lihat Eksperimen.

databricks experiments log-batch [flags]

Arguments

None

Opsi

--json JSON

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

--run-id string

    ID eksekusi untuk masuk.

Bendera global

eksperimen databricks masukan log

Note

Perintah ini bersifat eksperimental.

Mencatat input, seperti himpunan data dan model, ke dalam MLflow Run.

databricks experiments log-inputs RUN_ID [flags]

Arguments

RUN_ID

    ID dari pelaksanaan untuk dicatat di bawah

Opsi

--json JSON

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

Bendera global

log metrik eksperimen databricks

Catat metrik untuk dijalankan. Metrik adalah pasangan kunci-nilai (kunci string, nilai float) dengan tanda waktu terkait. Contohnya termasuk berbagai metrik yang mewakili akurasi model ML. Metrik dapat dicatat beberapa kali.

databricks experiments log-metric KEY VALUE TIMESTAMP [flags]

Arguments

KEY

    Nama metrik.

VALUE

    Menggandakan nilai metrik yang dicatat.

TIMESTAMP

    Tanda waktu Unix dalam milidetik pada saat metrik dicatat.

Opsi

--dataset-digest string

    Ikhtisar himpunan data yang terkait dengan metrik, misalnya.

--dataset-name string

    Nama himpunan data yang terkait dengan metrik.

--json JSON

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

--model-id string

    ID model yang dicatat yang terkait dengan metrik, jika berlaku.

--run-id string

    ID eksekusi untuk mencatat metrik.

--run-uuid string

    Tidak digunakan lagi, gunakan --run_id sebagai gantinya. ID eksekusi untuk mencatat metrik.

--step int

    Langkah untuk mencatat metrik.

Bendera global

pencatatan model eksperimen Databricks

Simpan model ke log.

Note

Perintah ini bersifat eksperimental.

databricks experiments log-model [flags]

Arguments

None

Opsi

--json JSON

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

--model-json string

    File MLmodel dalam format json.

--run-id string

    ID eksekusi untuk masuk.

Bendera global

eksperimen pada databricks catat parameter

Catat parameter yang digunakan untuk menjalankan. Param adalah pasangan kunci-nilai (kunci string, nilai string). Contohnya termasuk hiperparameter yang digunakan untuk pelatihan model ML dan tanggal dan nilai konstanta yang digunakan dalam alur ETL. Parameter hanya dapat dicatat satu kali untuk satu kali proses.

databricks experiments log-param KEY VALUE [flags]

Arguments

KEY

    Nama parameter. Ukuran maksimum adalah 255 byte.

VALUE

    Nilai string dari parameter yang dicatat. Ukuran maksimum adalah 500 byte.

Opsi

--json JSON

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

--run-id string

    ID operasi yang digunakan untuk mencatat param.

--run-uuid string

    [Tidak digunakan lagi, gunakan run_id sebagai gantinya] ID dari eksekusi untuk mencatat param.

Bendera global

eksperimen databricks percobaan pemulihan

Pulihkan eksperimen yang ditandai untuk dihapus. Ini juga memulihkan metadata terkait, eksekusi, metrik, parameter, dan tag. Jika eksperimen menggunakan FileStore, artefak yang mendasar yang terkait dengan eksperimen juga dipulihkan.

Memunculkan pengecualian RESOURCE_DOES_NOT_EXIST jika eksperimen tidak pernah dibuat atau telah dihapus secara permanen.

databricks experiments restore-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID eksperimen terkait.

Opsi

--json JSON

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

Bendera global

Eksekusi pemulihan eksperimen databricks

Memulihkan proses yang dihapus. Ini juga memulihkan metadata terkait, eksekusi, metrik, parameter, dan tag.

Menghasilkan kesalahan RESOURCE_DOES_NOT_EXIST jika eksekusi tidak pernah dibuat atau dihapus secara permanen.

databricks experiments restore-run RUN_ID [flags]

Arguments

RUN_ID

    ID pengoperasian yang akan dipulihkan.

Opsi

--json JSON

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

Bendera global

Eksekusi pemulihan eksperimen databricks

Pemulihan massal berjalan dalam eksperimen yang dihapus tidak lebih awal dari tanda waktu yang ditentukan. Memulihkan hingga paling banyak max_runs untuk setiap permintaan.

databricks experiments restore-runs EXPERIMENT_ID MIN_TIMESTAMP_MILLIS [flags]

Arguments

EXPERIMENT_ID

    ID dari eksperimen yang berisi pengujian untuk dipulihkan.

MIN_TIMESTAMP_MILLIS

    Tanda waktu penghapusan minimum dalam milidetik sejak epok UNIX untuk memulihkan rangkaian proses. Hanya eksekusi yang dihapus tidak lebih awal dari tanda waktu ini yang dipulihkan.

Opsi

--json JSON

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

--max-runs int

    Bilangan bulat positif opsional yang menunjukkan jumlah maksimum eksekusi untuk dipulihkan.

Bendera global

eksperimen databricks eksperimen pencarian

Mencari eksperimen yang memenuhi kriteria pencarian yang ditentukan.

databricks experiments search-experiments [flags]

Arguments

None

Opsi

--filter string

    String yang mewakili kondisi filter SQL

--json JSON

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

--max-results int

    Jumlah maksimum eksperimen yang diinginkan.

--page-token string

    Token yang menunjukkan halaman eksperimen untuk diambil.

--view-type ViewType

    Kualifikasi untuk jenis eksperimen yang akan dikembalikan. Nilai yang didukung: ACTIVE_ONLY, ALL, DELETED_ONLY

Bendera global

eksperimen databricks yang dijalankan pencarian

Mencari eksekusi yang memenuhi ekspresi. Ekspresi pencarian dapat menggunakan kunci mlflowMetric dan mlflowParam.

databricks experiments search-runs [flags]

Arguments

None

Opsi

--filter string

    Ekspresi filter terhadap parameter, metrik, dan tag, yang memungkinkan pengembalian subset dari jalinan.

--json JSON

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

--max-results int

    Jumlah maksimum pengulangan yang diinginkan.

--page-token string

    Token untuk halaman proses saat ini.

--run-view-type ViewType

    Menampilkan hanya yang aktif, hanya yang dihapus, atau semua pengoperasian. Nilai yang didukung: ACTIVE_ONLY, ALL, DELETED_ONLY

Bendera global

eksperimen databricks penetapan-tanda-eksperimen

Menetapkan tag pada eksperimen. Tag eksperimen adalah metadata yang dapat diperbarui.

databricks experiments set-experiment-tag EXPERIMENT_ID KEY VALUE [flags]

Arguments

EXPERIMENT_ID

    ID eksperimen untuk mencatat tag. Harus disediakan.

KEY

    Nama tag. Ukuran kunci hingga 250 byte didukung.

VALUE

    Nilai string tag yang dicatat. Nilai hingga 64KB didukung.

Opsi

--json JSON

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

Bendera global

eksperimen databricks set-tag

Menetapkan tag pada proses. Tag adalah metadata yang dapat diperbarui selama eksekusi dan setelah eksekusi selesai.

databricks experiments set-tag KEY VALUE [flags]

Arguments

KEY

    Nama tag. Ukuran kunci hingga 250 byte didukung.

VALUE

    Nilai string tag yang dicatat. Nilai hingga 64KB didukung.

Opsi

--json JSON

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

--run-id string

    ID dari proses untuk mencatat tag.

--run-uuid string

    Tidak digunakan lagi, gunakan --run_id sebagai gantinya. ID dari proses untuk mencatat tag.

Bendera global

eksperimen databricks pembaruan-eksperimen

Perbarui eksperimen.

databricks experiments update-experiment EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    ID eksperimen terkait.

Opsi

--json JSON

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

--new-name string

    Jika disediakan, nama eksperimen diubah menjadi nama baru.

Bendera global

Memperbarui eksekusi eksperimen Databricks

Perbarui eksekusi.

databricks experiments update-run [flags]

Arguments

None

Opsi

--end-time int

    Tanda waktu Unix dalam milidetik ketika eksekusi berakhir.

--json JSON

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

--run-id string

    ID eksekusi yang akan diperbarui.

--run-name string

    Nama proses yang diperbarui.

--run-uuid string

    Tidak digunakan lagi, gunakan --run_id sebagai gantinya. ID eksekusi yang akan diperbarui.

--status UpdateRunStatus

    Status operasi yang diperbarui. Nilai yang didukung: FAILED, , FINISHEDKILLED, RUNNING,SCHEDULED

Bendera global

eksperimen databricks mendapatkan tingkat izin

Peroleh level izin untuk eksperimen.

databricks experiments get-permission-levels EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperimen untuk mendapatkan atau mengelola izin.

Opsi

Bendera global

eksperimen databricks mendapatkan izin

Dapatkan izin eksperimen. Eksperimen dapat mewarisi izin dari objek akarnya.

databricks experiments get-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperimen untuk mendapatkan atau mengelola izin.

Opsi

Bendera global

pengaturan izin eksperimen databricks

Tetapkan izin eksperimen.

Mengatur izin pada objek, menggantikan izin yang ada jika ada. Menghapus semua izin langsung jika tidak ada yang ditentukan. Objek dapat mewarisi izin dari objek akarnya.

databricks experiments set-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperimen untuk mendapatkan atau mengelola izin.

Opsi

--json JSON

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

Bendera global

izin pembaruan eksperimen databricks

Perbarui perizinan eksperimen. Eksperimen dapat mewarisi izin dari objek akarnya.

databricks experiments update-permissions EXPERIMENT_ID [flags]

Arguments

EXPERIMENT_ID

    Eksperimen 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