Bagikan melalui

Tutorial Databricks CLI

Catatan

Informasi ini berlaku untuk Databricks CLI versi 0.205 ke atas. Databricks CLI sedang dalam Pratinjau Umum.

Penggunaan Databricks CLI tunduk pada Lisensi Databricks dan Pemberitahuan Privasi Databricks, termasuk ketentuan Data Penggunaan apa pun.

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. Lihat Apa itu Databricks CLI?.

Artikel ini menunjukkan cara menginstal dan mengonfigurasi Databricks CLI dengan cepat.

Mengonfirmasi persyaratan komputer lokal

Tutorial ini mengasumsikan bahwa:

Menginstal Databricks CLI

  1. Instal Databricks CLI:

    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 Command Prompt 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

Mengonfigurasi akses ke ruang kerja Anda

Selanjutnya, konfigurasikan akses ke ruang kerja Databricks Anda.

Catatan

Tutorial ini 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 pada 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 sudah ada dengan nama yang sama akan diperbarui 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

  • Last updated on