Tutorial Databricks CLI

Utilitas antarmuka baris perintah Databricks (juga dikenal sebagai Databricks CLI) menyediakan antarmuka yang mudah digunakan untuk mengotomatiskan platform Azure Databricks dari terminal, prompt perintah, atau skrip otomatisasi Anda.

Artikel ini menunjukkan cara menggunakan komputer pengembangan lokal Anda untuk memulai dengan cepat menggunakan Databricks CLI. Lihat Apa itu Databricks CLI?.

Tutorial langsung berikut mengasumsikan:

• Untuk Linux atau macOS, Anda telah menginstal Homebrew .

  Catatan

  Jika Anda tidak dapat menggunakan Homebrew, untuk cara lain menginstal CLI, lihat Menginstal atau memperbarui Databricks CLI.

• Untuk Windows, Anda telah menginstal winget, Chocolatey, atau Subsistem Windows untuk Linux (WSL). Untuk petunjuk penginstalan, lihat dokumentasi sistem operasi Anda.

  Catatan

  Menginstal Databricks CLI dengan Chocolatey bersifat Eksperimental.

  Jika Anda tidak dapat menggunakan winget, Chocolatey, atau WSL, untuk cara lain menginstal CLI, lihat Menginstal atau memperbarui Databricks CLI.

Selesaikan langkah-langkah berikut:

1. Jika belum diinstal, instal Databricks CLI sebagai berikut:

   Linux, macOS

   Gunakan Homebrew untuk menginstal Databricks CLI dengan menjalankan dua perintah berikut:

   brew tap databricks/tap
   brew install databricks
   

   Windows

   Anda dapat menggunakan winget, Chocolatey atau Subsistem Windows untuk Linux (WSL) untuk menginstal Databricks CLI. Jika Anda tidak dapat menggunakan winget, Chocolatey, atau WSL, Anda harus melewati prosedur ini dan menggunakan Prompt Perintah atau PowerShell untuk menginstal Databricks CLI dari sumber sebagai gantinya.

   Catatan

   Menginstal Databricks CLI dengan Chocolatey bersifat Eksperimental.

   Untuk menggunakan winget untuk menginstal Databricks CLI, jalankan dua perintah berikut, lalu mulai ulang Prompt Perintah Anda:

   winget search databricks
   winget install Databricks.DatabricksCLI
   

   Untuk menggunakan Chocolatey untuk menginstal Databricks CLI, jalankan perintah berikut:

   choco install databricks-cli
   

   Untuk menggunakan WSL untuk menginstal Databricks CLI:

   1. Instal curl dan zip melalui WSL. Untuk informasi selengkapnya, lihat dokumentasi sistem operasi Anda.

   2. Gunakan WSL untuk menginstal Databricks CLI dengan menjalankan perintah berikut:

      curl -fsSL https://raw.githubusercontent.com/databricks/setup-cli/main/install.sh | sh
      

2. Konfirmasikan bahwa Databricks CLI diinstal dengan menjalankan perintah berikut, yang menampilkan versi CLI Databricks yang diinstal saat ini. Versi ini harus 0.205.0 atau lebih tinggi:

   databricks -v
   

   Catatan

   Jika Anda menjalankan databricks tetapi mendapatkan kesalahan seperti command not found: databricks, atau jika Anda menjalankan databricks -v dan nomor versi 0,18 atau di bawah ini tercantum, ini berarti bahwa komputer Anda tidak dapat menemukan versi databricks CLI yang benar yang dapat dieksekusi. Untuk memperbaikinya, lihat Memverifikasi penginstalan CLI Anda.

Setelah Anda menginstal Databricks CLI, selesaikan langkah-langkah berikut:

1. Gunakan Databricks CLI untuk memulai manajemen token OAuth secara lokal dengan menjalankan perintah berikut untuk setiap akun target atau ruang kerja.

   Untuk operasi tingkat akun, dalam perintah berikut, ganti tempat penampung berikut:

   • Ganti <account-console-url> dengan Azure Databricks https://accounts.azuredatabricks.netAnda .
   • Ganti <account-id> dengan ID akun Azure Databricks Anda. Lihat Menemukan ID akun Anda.

   databricks auth login --host <account-console-url> --account-id <account-id>
   

   Untuk operasi tingkat ruang kerja, dalam perintah berikut, ganti <workspace-url> dengan URL per ruang kerja Azure Databricks Anda, misalnya https://adb-1234567890123456.7.azuredatabricks.net.

   databricks auth login --host <workspace-url>
   

2. Databricks CLI meminta Anda untuk menyimpan informasi yang Anda masukkan sebagai profil konfigurasi Azure Databricks. Tekan Enter untuk menerima nama profil yang disarankan, atau masukkan nama profil baru atau yang sudah ada. Profil yang ada dengan nama yang sama ditimpa dengan informasi yang Anda masukkan. Anda dapat menggunakan profil untuk mengalihkan konteks autentikasi dengan cepat di antara beberapa akun atau ruang kerja.

   Untuk mendapatkan daftar profil yang ada, di terminal atau prompt perintah terpisah, gunakan Databricks CLI untuk menjalankan perintah databricks auth profiles. Untuk melihat pengaturan profil tertentu yang sudah ada, jalankan perintah databricks auth env --profile <profile-name>.

3. Di browser web Anda, selesaikan instruksi di layar untuk masuk ke akun atau ruang kerja Azure Databricks Anda.

4. Untuk melihat nilai token OAuth profil saat ini dan tanda waktu kedaluwarsa token yang akan datang, jalankan salah satu perintah berikut:

   Untuk operasi tingkat akun, jalankan perintah berikut:

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url> --account-id <account-id>
   • databricks auth token --host <workspace-url> --account-id <account-id> -p <profile-name>

   Jika Anda memiliki beberapa profil dengan nilai --host dan --account-id yang sama, Anda mungkin perlu menentukan opsi --host, --account-id, dan -p bersama-sama untuk membantu Databricks CLI menemukan informasi token OAuth yang cocok.

   Untuk operasi tingkat ruang kerja, jalankan perintah berikut:

   • databricks auth token -p <profile-name>
   • databricks auth token --host <workspace-url>
   • databricks auth token --host <workspace-url> -p <profile-name>

   Jika Anda memiliki beberapa profil dengan nilai --host yang sama, Anda mungkin perlu menentukan opsi --host dan -p bersama-sama untuk membantu Databricks CLI menemukan informasi token OAuth yang cocok.

Langkah berikutnya

Setelah Anda menyiapkan Databricks CLI:

• Untuk mempelajari cara menggunakan CLI, lihat Penggunaan dasar untuk Databricks CLI.
• Untuk gambaran umum perintah CLI yang tersedia, lihat perintah Databricks CLI.
• Jika CLI tidak berjalan atau menghasilkan hasil yang tidak terduga, lihat Memverifikasi penginstalan CLI Anda.