grup perintah air

Important

Fitur ini ada di Pratinjau Umum.

Grup air perintah dalam Databricks CLI mengirimkan dan mengelola beban kerja GPU, seperti pelatihan dan inferensi, dengan AI Runtime.

Untuk bidang konfigurasi beban kerja, lihat referensi Workload YAML. Untuk mengirimkan beban kerja pertama Anda, lihat Databricks CLI quickstart untuk AI Runtime.

data bricks air run

Kirim beban kerja dari konfigurasi YAML. Output mencakup ID run pekerjaan dan URL run job.

databricks air run --file YAML_PATH [flags]

Arguments

None

Opsi

-f, --file string

    Jalur ke konfigurasi beban kerja YAML. Opsi ini diperlukan.

--watch

    Node stream 0 akan dilog sampai run mencapai status terminal. Standar: false.

--override stringArray

    Ganti field YAML menggunakan FIELD_PATH=VALUE. Ulangi opsi ini untuk menimpa beberapa kolom.

--dry-run

    Validasi konfigurasi tanpa mengirimkan beban kerja. Standar: false.

--idempotency-key string

    Mengembalikan run yang sudah ada ketika kunci sebelumnya digunakan. Override idempotency_token di YAML. Maksimum: 64 karakter.

Bendera global

Examples

Contoh berikut mengirimkan beban kerja dari train.yaml:

databricks air run --file train.yaml

Kirim jalur konfigurasi sebagai argumen terpisah untuk -h menampilkan bantuan konfigurasi beban kerja:

databricks air run -h config
databricks air run -h config.compute
databricks air run -h config.compute.accelerator_type

databricks air get

Dapatkan detail untuk lari.

databricks air get JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    ID run pekerjaan yang dikembalikan oleh databricks air run.

Opsi

Bendera global

Databricks Air List

Daftar berjalan. Secara default, perintah ini menampilkan run aktif yang diajukan oleh pengguna saat ini.

databricks air list [flags]

Arguments

None

Opsi

--limit int

    Jumlah maksimum run yang harus ditampilkan. Standar: 20.

--all-status

    Sertakan run dalam status terminal. Standar: false.

--all-users

    Sertakan run yang diajukan oleh pengguna lain. Standar: false.

--filter stringArray

    Filter berjalan menggunakan KEY=VALUE. Ulangi opsi ini untuk meminta beberapa kondisi. Kunci yang didukung adalah accelerator_type, experiment, num_accelerators, dan user.

Bendera global

Data Bricks Air Log

Stream atau ambil log untuk lari.

databricks air logs JOB_RUN_ID [flags]

Arguments

JOB_RUN_ID

    ID run pekerjaan yang dikembalikan oleh databricks air run.

Opsi

--node int

    Pilih indeks node berbasis nol. Standar: 0.

--tail int

    Jumlah garis log yang sudah ada untuk dicetak. Standar: 10000.

--minutes int

    Ambil log dari beberapa menit terakhir. Tidak dapat digabungkan dengan --tail. Standar: 0.

--retry int

    Pilih percobaan ulang. 0 adalah upaya awal dan -1 merupakan yang terbaru. Standar: -1.

--download-to string

    Unduh log lengkap ke sebuah direktori. Mengunduh semua node kecuali --node sudah diatur. Tidak dapat digabungkan dengan --tail atau --minutes.

Bendera global

Databricks Air Cancel

Batalkan satu atau lebih run berdasarkan job run ID, atau batalkan semua run aktif yang diajukan oleh pengguna saat ini.

databricks air cancel [JOB_RUN_ID...] [flags]

Arguments

JOB_RUN_ID

    Satu atau lebih ID yang dijalankan pekerjaan. Tidak dapat digabungkan dengan --all.

Opsi

--all

    Batalkan semua run aktif yang diajukan oleh pengguna saat ini. Standar: false.

-y, --yes

    Lewati prompt konfirmasi yang digunakan oleh --all. Standar: false.

Bendera global

Daftar Databricks Air Pools

Daftarkan kapasitas GPU yang telah disediakan untuk workspace saat ini.

Gunakan ID kapasitas yang telah disediakan di compute.pool_id.

databricks air pools list [flags]

Arguments

None

Opsi

Bendera global

Databricks Air Pools Get

Dapatkan detail kapasitas GPU yang sudah disiapkan.

databricks air pools get [POOL_ID] [flags]

Arguments

POOL_ID

    ID kapasitas yang ditentukan. Argumen ini hanya opsional jika workspace memiliki tepat satu kapasitas yang telah diprovision.

Opsi

Bendera global

Databricks Air Images push

Dorong gambar kontainer ke Registri Artefak.

Untuk prasyarat dan instruksi dalam mendorong sebuah gambar, lihat Push image with the Databricks CLI.

databricks air images push [flags]

Arguments

None

Opsi

-s, --source string

    Gambar kontainer sumber sebagai nama dengan tag opsional (NAME[:TAG]) atau ringkasan (NAME@DIGEST). Jika dihilangkan di terminal interaktif, perintah akan meminta nilainya.

--catalog string

    Katalog Unity tujuan Katalog. Jika dihilangkan di terminal interaktif, perintah akan meminta nilainya.

--schema string

    Skema Unity Catalog tujuan. Jika dihilangkan di terminal interaktif, perintah akan meminta nilainya.

--artifact string

    Artefak tujuan sebagai ARTIFACT[:TAG]. Default menggunakan nama dan tag gambar sumber, atau latest tag ketika sumber tidak memiliki tag.

--pull

    Ambil gambar sumber dari registrynya sebelum mendorong, bukan menggunakan kembali gambar lokal yang tersedia. Standar: false.

Bendera global

Databricks Air Convert-to-DABS

Konversi konfigurasi YAML beban kerja menjadi Databricks Asset Bundle. Perintah lokal ini menulis dan meluncurkan databricks.yml file di bawah generated_artifacts/.

Perintah ini adalah jembatan opsional ke alur kerja produksi lanjutan. Anda dapat terus menggunakan databricks air run tanpa mengonversi konfigurasi.

Untuk alur kerja bundle, lihat Jadwalkan beban kerja GPU dan susun tugas.

databricks air convert-to-dabs YAML_PATH [flags]

Arguments

YAML_PATH

    Jalur ke konfigurasi beban kerja YAML.

Opsi

--output-dir string

    Direktori tempat perintah menulis bundel. Sumber kode harus berada di dalam direktori ini. Default: direktori yang berisi file YAML input.

--force

    Timpa file bundle yang dihasilkan yang sudah ada. Standar: false.

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

Migrasi dari CLI Python lama

CLI Databricks dan CLI berbasis air Python yang sudah tidak digunakan menggunakan nama dan flag perintah yang berbeda. Skrip pembaruan menggunakan pemetaan berikut:

Python CLI Databricks CLI (antarmuka baris perintah)
air run -f train.yaml databricks air run -f train.yaml
air run -f train.yaml --override A=X B=Y databricks air run -f train.yaml --override A=X --override B=Y
air get run <run-id> databricks air get <run-id>
air list runs databricks air list --all-status
air list runs --active databricks air list
air -h config databricks air run -h config
air logs <run-id> databricks air logs <run-id>
air cancel <run-id> databricks air cancel <run-id>

Sumber daya tambahan

  • Terakhir diperbarui pada