Bagikan melalui

Tutorial Databricks CLI

  • Artikel

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.

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:

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 yang benar dari Databricks CLI yang dapat dieksekusi. Untuk memperbaikinya, lihat Memverifikasi penginstalan CLI Anda.

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

Catatan

Tutorial ini mengasumsikan bahwa Anda ingin menggunakan autentikasi pengguna-ke-mesin (U2M) OAuth untuk mengautentikasi CLI menggunakan akun pengguna Azure Databricks Anda. Untuk mengonfigurasi CLI untuk menggunakan jenis autentikasi Databricks lainnya, lihat Autentikasi untuk Databricks CLI.

  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:

    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 dan yang sama--host, Anda mungkin perlu menentukan --hostopsi , , --account-iddan -p bersama-sama untuk membantu Databricks CLI menemukan informasi token OAuth yang cocok yang benar.--account-id

    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 yang sama --host , Anda mungkin perlu menentukan --host opsi dan -p bersama-sama untuk membantu Databricks CLI menemukan informasi token OAuth yang cocok dengan benar.

Langkah berikutnya

Setelah Anda menyiapkan Databricks CLI: