Menginstal atau memperbarui Databricks CLI

Catatan

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

Halaman ini menjelaskan cara menginstal atau memperbarui Databricks CLI. Lihat Databricks CLI. Untuk mengonfigurasi autentikasi untuk Databricks CLI, lihat Autentikasi untuk Databricks CLI.

Instalasi

Untuk menginstal Databricks CLI versi 0.205 atau lebih tinggi:

Databricks CLI juga tersedia dari dalam ruang kerja Azure Databricks. Lihat Menjalankan perintah CLI Databricks.

Pemutakhiran

Untuk memperbarui penginstalan Databricks CLI versi 0.205 atau yang lebih baru sebelumnya:

Penginstalan homebrew untuk macOS

Untuk opsi penginstalan ini, Anda menggunakan Homebrew untuk mengunduh dan menginstal rilis CLI Databricks terbaru secara otomatis.

Dari terminal Anda, jalankan perintah Homebrew berikut untuk menginstal CLI:

brew tap databricks/tap
brew trust databricks/tap
brew install databricks

Perintah brew trust diperlukan mulai Homebrew 6.0.0, yang mengharuskan tap pihak ketiga dipercaya secara eksplisit sebelum Homebrew memuat formula mereka. Pengguna lama yang menambahkan tap sebelum memutakhirkan ke Homebrew 6.0.0 juga harus menjalankan brew trust databricks/tap.

Anda juga dapat menginstal dalam satu langkah tanpa memercayai seluruh tap:

brew install databricks/tap/databricks

Kemudian lanjutkan dengan Autentikasi untuk Databricks CLI.

Jika Anda tidak yakin apakah Anda telah menginstal Homebrew, atau jika perintah Homebrew sebelumnya gagal, ikuti instruksi yang lebih panjang ini:

  1. Periksa apakah Homebrew sudah diinstal dengan menjalankan perintah berikut dari prompt shell Linux atau Terminal macOS. Jika Homebrew diinstal, nomor versi Homebrew ditampilkan:

    brew -v
    
  2. Jika Homebrew belum diinstal, instal dengan menjalankan perintah berikut:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    

    Kemudian jalankan perintah berikut untuk memverifikasi penginstalan Homebrew, yang menampilkan nomor versi Homebrew:

    brew -v
    
  3. Gunakan Homebrew untuk menambahkan repositori databricks/homebrew-tap di GitHub ke daftar repositori Homebrew Tap yang tersedia, dengan menjalankan perintah berikut:

    brew tap databricks/tap
    
  4. Percayalah pada ketukan. Mulai Homebrew 6.0.0, tap pihak ketiga harus secara eksplisit diberi kepercayaan sebelum Homebrew memuat formula di dalamnya. Jalankan perintah berikut:

    brew trust databricks/tap
    

    Pengguna yang sudah ada yang mengetuk sebelum memutakhirkan ke Homebrew 6.0.0 juga harus menjalankan perintah ini.

  5. Gunakan Homebrew untuk menginstruksikan databricks/homebrew-tap repositori untuk mengunduh dan menginstal Databricks CLI dengan menjalankan perintah berikut:

    brew install databricks
    
  6. Konfirmasi apakah Databricks CLI diinstal dengan benar. Untuk melakukan ini, lihat versi Databricks CLI menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

    Jika nomor versi 0.205.0 atau lebih tinggi tercantum, Databricks CLI diinstal dengan benar.

  7. Lanjutkan dengan Autentikasi untuk Databricks CLI.

Penginstalan WinGet untuk Windows

Untuk opsi penginstalan ini, Anda menggunakan winget untuk mengunduh dan menginstal rilis CLI Databricks terbaru secara otomatis.

  1. Dari Command Prompt Anda, jalankan dua winget perintah berikut untuk menginstal CLI, lalu restart Command Prompt Anda.

    winget search databricks
    winget install Databricks.DatabricksCLI
    
  2. Konfirmasi apakah Databricks CLI diinstal dengan benar. Untuk melakukan ini, lihat versi Databricks CLI dengan menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

  1. Lanjutkan dengan Autentikasi untuk Databricks CLI.

Penginstalan Chocolatey untuk Windows

Catatan

Menginstal Databricks CLI dengan Chocolatey bersifat Eksperimental.

Untuk opsi penginstalan ini, Anda menggunakan Chocolatey untuk mengunduh dan menginstal rilis CLI Databricks terbaru secara otomatis.

  1. Dari Prompt Perintah Anda, jalankan perintah berikut choco untuk menginstal CLI:

    choco install databricks-cli
    
  2. Konfirmasi apakah Databricks CLI diinstal dengan benar. Untuk melakukan ini, lihat versi Databricks CLI dengan menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

    Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

  3. Lanjutkan dengan Autentikasi untuk Databricks CLI.

penginstalan curl untuk Linux, macOS, dan Windows

Untuk opsi penginstalan ini, Anda menggunakan curl untuk mengunduh dan memanggil skrip untuk menginstal rilis Databricks CLI terbaru.

Untuk Windows, Databricks merekomendasikan agar Anda menggunakan Subsistem Windows untuk Linux (WSL). Anda juga harus menginstal unzip . Untuk petunjuk penginstalan, lihat dokumentasi sistem operasi Anda. Jika Anda tidak dapat menggunakan WSL, lewati prosedur ini dan gunakan Prompt Perintah atau PowerShell untuk menginstal Databricks CLI dari sumber sebagai gantinya.

  1. curl harus diinstal. Anda dapat memeriksa apakah curl sudah diinstal dengan menjalankan perintah berikut dari prompt shell Linux, Terminal macOS, atau Bash di WSL. Jika curl diinstal, curl nomor versi ditampilkan:

    curl -V
    
  2. Jika curl belum diinstal, instal dengan mengikuti instruksi di curlhalaman Rilis dan Unduhan untuk sistem operasi dan arsitektur Anda. Untuk mendapatkan arsitektur komputer Anda, lihat dokumentasi sistem operasi Anda.

    Kemudian jalankan perintah berikut untuk memverifikasi curl penginstalan, yang menampilkan curl nomor versi:

    curl -V
    
  3. Gunakan curl untuk mengunduh dan menginstal Databricks CLI dengan menjalankan perintah berikut. Perintah ini membedakan huruf besar dan huruf kecil.

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

    Catatan

    Untuk melihat konten skrip sebelum Anda menjalankannya, lihat file install.sh di repositori Penyiapan Databricks CLI di GitHub.

    Untuk Windows, Anda harus menjalankan perintah ini sebagai administrator.

    Untuk Linux dan macOS, jika pesan kesalahan menyatakan bahwa /usr/local/bin tidak dapat ditulis, jalankan perintah lagi dengan sudo.

    Perintah ini mengunduh dan menginstal Databricks CLI di jalur /usr/local/bin/databricks di macOS dan Linux, dan C:\Windows\databricks.exe di Windows.

    Jika karena alasan tertentu CLI Databricks sudah diinstal, kesalahan berikut muncul: "Jalur target <path> sudah ada." Untuk memperbaikinya, Anda harus menghapus Databricks CLI secara manual dari jalur sebelumnya, lalu menjalankan curl perintah lagi.

  4. Konfirmasi apakah Databricks CLI diinstal dengan benar. Untuk melakukan ini, lihat versi Databricks CLI dengan menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

    Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

  5. Lanjutkan dengan Autentikasi untuk Databricks CLI.

Instalasi Source pada Linux, macOS, dan Windows

Untuk opsi penginstalan ini, Anda mengunduh .zip file secara manual lalu mengekstrak Databricks CLI secara manual dari file yang diunduh .zip .

  1. Unduh berkas Databricks CLI .zip terbaru ke mesin pengembangan lokal Anda, seperti yang terdaftar di bagian Releases dari repositori Databricks CLI di GitHub. Rilis terbaru memiliki label Latest di sampingnya dalam daftar rilis. Versi pra-perilisan terbaru memiliki penanda Pre-release dan lebih cocok untuk eksperimen serta pengadopsi awal. File .zip yang Anda unduh dari bagian Assets untuk rilis harus cocok dengan sistem operasi dan arsitektur komputer pengembangan Anda:

    Filename Arsitektur
    databricks_cli_X.Y.Z_darwin_amd64.zip macOS, Intel 64-bit / x86_64
    databricks_cli_X.Y.Z_darwin_arm64.zip macOS, Apple Silicon / M Series / arm64
    databricks_cli_X.Y.Z_linux_amd64.zip Linux, Intel 64-bit / x86_64
    databricks_cli_X.Y.Z_linux_arm64.zip Linux, ARM 64-bit / arm64
    databricks_cli_X.Y.Z_windows_386.zip Windows, Intel 32-bit / x86
    databricks_cli_X.Y.Z_windows_amd64.zip Windows dan Intel 64-bit / AMD64
    databricks_cli_X.Y.Z_windows_arm64.zip Windows, ARM 64-bit / ARM64

    Untuk mendapatkan arsitektur komputer Anda, lihat dokumentasi sistem operasi Anda. Contohnya:

    • Linux: Perintah terminal uname -m, lscpu, atau sudo lshw -c cpu.
    • macOS: Apple> menu Tentang Mac Ini, atau perintah Terminal uname -m.
    • Windows: Command Prompt atau perintah PowerShell echo %PROCESSOR_ARCHITECTURE%.

    Jika Anda perlu memverifikasi integritas salah satu file .zip ini, Databricks menyediakan file checksum bernama databricks_cli_X.Y.Z_SHA256SUMS dalam daftar yang sama dengan file .zip. Untuk menjalankan verifikasi checksum, lihat dokumentasi sistem operasi Anda.

  2. Ekstrak isi file yang diunduh .zip . Untuk mengekstrak .zip file, lihat dokumentasi sistem operasi Anda.

  3. Dalam konten yang diekstrak, folder dengan nama yang sama seperti file .zip muncul. Di dalam folder ini ada Databricks CLI. Anda dapat meninggalkan Databricks CLI di sana, atau Anda dapat menyalin atau memindahkannya ke lokasi lain.

  4. Konfirmasi apakah Databricks CLI diinstal dengan benar. Untuk melakukannya, di prompt shell Linux, Terminal macOS, atau Command Prompt Windows, lihat versi Databricks CLI menggunakan opsi -v atau dengan menjalankan perintah version:

    databricks -v
    
    # Or:
    databricks version
    

    Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

    Catatan

    Untuk macOS, Anda mungkin perlu mengotorisasi sistem Anda agar dapat menjalankan Databricks CLI terlebih dahulu. Lihat Membuka app Mac dari pengembang yang tidak dikenal.

  5. Lanjutkan dengan Autentikasi untuk Databricks CLI.

pembaruan Homebrew untuk Linux atau macOS

Untuk opsi pembaruan ini, Anda menggunakan Homebrew untuk memperbarui penginstalan Databricks CLI versi 0.205 atau yang lebih baru secara otomatis ke versi terbaru.

  1. Dari prompt shell Linux atau Terminal macOS, gunakan Homebrew untuk mengunduh dan memperbarui ke versi terbaru Databricks CLI dengan menjalankan perintah berikut:

    brew upgrade databricks
    
  2. Konfirmasi apakah Databricks CLI diperbarui dengan benar. Untuk melakukan ini, lihat versi Databricks CLI dengan menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

    Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

    Untuk daftar versi Databricks CLI, lihat bagian Releases dari repositori Databricks CLI di GitHub. Rilis terbaru memiliki label Latest di sampingnya dalam daftar rilis.

Petunjuk / Saran

Untuk menurunkan versi Databricks CLI, lihat instruksi di repositori databricks/homebrew-tap di GitHub.

WinGet update untuk Windows

Untuk opsi pembaruan ini, Anda menggunakan winget untuk mengunduh dan memperbarui versi Databricks CLI sebelumnya versi 0.205 ke atas ke versi terbaru.

  1. Dari Prompt Perintah Anda, gunakan winget untuk mengunduh dan memperbarui ke versi terbaru Databricks CLI dengan menjalankan perintah berikut:

    winget upgrade Databricks.DatabricksCLI
    
  2. Konfirmasi apakah Databricks CLI diinstal dengan benar. Untuk melakukan ini, lihat versi Databricks CLI dengan menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

    Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

    Untuk daftar versi Databricks CLI, lihat bagian Releases dari repositori Databricks CLI di GitHub. Rilis terbaru memiliki label Latest di sampingnya dalam daftar rilis.

pembaruan Chocolatey untuk Windows

Catatan

Memperbarui Databricks CLI menggunakan Chocolatey bersifat Eksperimental.

Untuk opsi pembaruan ini, Anda menggunakan Chocolatey untuk mengunduh dan memperbarui versi Databricks CLI sebelumnya versi 0.205 ke atas ke versi terbaru.

  1. Dari Prompt Perintah Anda, gunakan choco untuk mengunduh dan memperbarui ke versi terbaru Databricks CLI dengan menjalankan perintah berikut:

    choco upgrade databricks-cli
    
  2. Konfirmasi apakah Databricks CLI diinstal dengan benar. Untuk melakukan ini, lihat versi Databricks CLI dengan menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

    Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

    Untuk daftar versi Databricks CLI, lihat bagian Releases dari repositori Databricks CLI di GitHub. Rilis terbaru memiliki label Latest di sampingnya dalam daftar rilis.

curl update untuk Linux, macOS, dan Windows

Untuk opsi pembaruan ini, Anda menggunakan curl untuk mengunduh dan memperbarui penginstalan Databricks CLI versi 0.205 sebelumnya ke versi terbaru secara otomatis.

Untuk Windows, Databricks merekomendasikan agar Anda menggunakan Subsistem Windows untuk Linux (WSL). Anda harus memiliki unzip terpasang. Untuk petunjuk penginstalan, lihat dokumentasi sistem operasi Anda. Jika Anda tidak dapat menggunakan WSL, Anda harus mengabaikan prosedur ini dan menggunakan Command Prompt atau PowerShell untuk memperbarui Databricks CLI dari sumber alih-alih.

  1. Hapus penginstalan Databricks CLI yang ada dari jalur /usr/local/bin/databricks di macOS dan Linux, atau C:\Windows\databricks.exe di Windows.

  2. Dari prompt shell Linux, Terminal macOS, atau Windows Command Prompt, gunakan curl untuk mengunduh dan menginstal versi terbaru Databricks CLI dengan menjalankan perintah berikut (perhatikan bahwa Anda harus menentukan karakter huruf besar dan huruf kecil yang benar untuk -fsSL):

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

    Catatan

    Untuk melihat konten skrip sebelum Anda menjalankannya, lihat file install.sh di repositori Penyiapan Databricks CLI di GitHub.

    Untuk Windows, Anda harus menjalankan perintah ini sebagai administrator.

    Untuk Linux dan macOS, jika pesan kesalahan menyatakan bahwa /usr/local/bin tidak dapat ditulis, jalankan perintah lagi dengan sudo.

    Perintah ini mengunduh dan menginstal Databricks CLI di jalur /usr/local/bin/databricks di macOS dan Linux, dan C:\Windows\databricks.exe di Windows.

    Jika kesalahan berikut muncul, Anda harus menghapus Databricks CLI secara manual dari jalur sebelumnya, lalu menjalankan curl perintah lagi: "Jalur <path> target sudah ada."

  3. Konfirmasi apakah Databricks CLI diperbarui dengan benar. Untuk melakukan ini, dari terminal Anda, lihat versi Databricks CLI dengan menggunakan -v opsi atau dengan menjalankan version perintah:

    databricks -v
    
    # Or:
    databricks version
    

    Jika output adalah versi 0.205.0 atau lebih tinggi, Databricks CLI diinstal dengan benar.

    Untuk daftar versi Databricks CLI, lihat bagian Releases dari repositori Databricks CLI di GitHub. Rilis terbaru memiliki label Latest di sampingnya dalam daftar rilis.

Pembaruan sumber untuk Linux, macOS, dan Windows

Untuk opsi pembaruan ini, Anda mengunduh file .zip secara manual lalu mengekstrak databricks CLI yang dapat dieksekusi secara manual dari file .zip yang diunduh.

  1. Jika perlu, hapus file executable Databricks CLI, file .zip, dan folder hasil ekstrak file .zip, dari instalasi manual dari sumber yang dilakukan sebelumnya.
  2. Lanjutkan dengan mengikuti instruksi di penginstalan Source untuk Linux, macOS, dan Windows.