Penggunaan dasar untuk Databricks CLI

Catatan

Informasi ini berlaku untuk Databricks CLI versi 0.205 ke atas, yang ada di Pratinjau Umum. Untuk menemukan versi Databricks CLI Anda, jalankan databricks -v.

Artikel ini memperlihatkan kepada Anda cara mencantumkan grup perintah dan perintah Databricks CLI, menampilkan bantuan Databricks CLI, dan bekerja dengan output Databricks CLI. Lihat Apa itu Databricks CLI?.

Artikel ini mengasumsikan bahwa Anda telah menginstal Databricks CLI dan menyiapkan CLI untuk autentikasi. Lihat Menginstal atau memperbarui Databricks CLI dan Autentikasi untuk Databricks CLI.

Mencantumkan grup perintah CLI

Anda mencantumkan grup perintah dengan menggunakan --help opsi atau -h . Contohnya:

databricks -h

Mencantumkan perintah CLI

Anda mencantumkan perintah untuk grup perintah apa pun dengan menggunakan --help opsi atau -h . Misalnya, untuk mencantumkan clusters perintah:

databricks clusters -h

Tampilkan bantuan perintah CLI

Anda menampilkan bantuan untuk perintah dengan menggunakan --help opsi atau -h . Misalnya, untuk menampilkan bantuan untuk clusters list perintah:

databricks clusters list -h

Menjalankan perintah

Informasi penggunaan lengkap dan sintaks untuk perintah individual dapat ditemukan dalam bantuan baris perintah, tetapi perintah Databricks CLI umumnya sesuai dengan sintaks berikut:

databricks <command-group> <command-name> <subcommand-name> [command-argument-value1] [--<flag1-name> <flag1-value>]

Tidak setiap perintah memiliki sub-perintah tambahan. Bendera global tersedia, dan beberapa perintah memiliki bendera tambahan. Misalnya, perintah berikut menghasilkan kluster yang tersedia, menggunakan bendera khusus perintah:

databricks clusters list --can-use-client JOBS

Gunakan jq untuk memfilter output JSON

Beberapa perintah Databricks CLI menghasilkan JSON, yang berarti Anda dapat menggunakan jq untuk memfilter output. Misalnya, untuk mencantumkan hanya nama tampilan kluster Azure Databricks dengan ID kluster yang ditentukan:

databricks clusters get 1234-567890-abcde123 | jq -r .cluster_name

My-11.3-LTS-Cluster

Anda dapat menginstal jq di macOS menggunakan Homebrew dengan brew install jq atau di Windows menggunakan Chocolatey dengan choco install jq. Untuk informasi lebih lanjut jqtentang, lihat Manual jq.

Parameter untai JavaScript Object Notation

Format parameter string ditangani secara berbeda di JSON tergantung pada sistem operasi Anda:

Linux atau macos

Anda harus mengapit parameter string JSON dalam tanda kutip ganda, dan Anda harus mengapit seluruh payload JSON dalam tanda kutip tunggal. Beberapa contoh:

'{"cluster_id": "1234-567890-abcde123"}'

'["20230323", "Amsterdam"]'

Windows

Anda harus mengapit parameter string JSON dan seluruh payload JSON dalam tanda kutip ganda, dan karakter tanda kutip ganda di dalam payload JSON harus didahului oleh \. Beberapa contoh:

"{\"cluster_id\": \"1234-567890-abcde123\"}"

"[\"20230323\", \"Amsterdam\"]"

Konfigurasi server proksi

Untuk merutekan permintaan dan respons CLI Databricks melalui server proksi, atur HTTPS_PROXY variabel lingkungan pada komputer tempat CLI Databricks diinstal ke URL server proksi.

Untuk mengatur variabel lingkungan, lihat dokumentasi sistem operasi Anda.