Memecahkan masalah Databricks CLI

Catatan

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

Gunakan informasi berikut untuk memecahkan masalah dengan Databricks CLI.

Aktifkan pencatatan log

Jika perintah gagal atau tidak menghasilkan output yang diharapkan, Anda dapat menggunakan pengelogan untuk membantu mengidentifikasi apa yang mungkin salah. Anda dapat mencatat pesan yang dihasilkan Databricks CLI tentang berbagai peristiwa perintah, peringatan, dan kesalahan. Untuk mencatat pesan ini, tentukan opsi perintah Databricks CLI berikut:

Tanda	Deskripsi
--log-file	String yang mewakili file untuk menulis log output. Jika bendera ini tidak ditentukan, maka defaultnya adalah menulis log output ke stderr.
--log-format	text untuk menulis log output ke teks atau json menulis log output ke JSON. Jika bendera ini tidak ditentukan, maka log output ditulis sebagai teks.
--log-level	String yang mewakili tingkat format log. Tingkat log yang valid adalah error, , warninfo, debug, trace, dan disabled. Tingkat defaultnya adalah disabled, yang berarti tidak ada yang dicatat. --debug setara dengan --log-level debug.

Contoh perintah berikut mencatat pesan pelacakan untuk perintah yang ditentukan ke file bernama databricks-cli.log dalam format JSON.

databricks clusters list --log-file databricks-cli.log --log-format json --log-level trace

Kesalahan saat mengunduh Terraform

Kunci kedaluwarsa dalam beberapa versi Databricks CLI menyebabkan kesalahan berikut saat menjalankan databricks bundle deploy:

error downloading Terraform: unable to verify checksums signature: openpgp: key expired

Untuk mengatasi kesalahan ini, tingkatkan Databricks CLI ke versi patch terbaru, yang memperbarui mekanisme verifikasi untuk bekerja dengan kunci yang lebih baru. Tingkatkan ke versi yang di-patch yang sesuai dengan versi minor CLI Anda saat ini:

• Binary install: Unduh versi yang di-patch dari halaman rilis CLI Databricks di GitHub.

• setup-cli (sebagai skrip penginstalan atau Tindakan GitHub): Perbarui versi dalam konfigurasi Anda ke versi yang di-patch dari halaman rilis CLI Databricks di GitHub.

  Misalnya, untuk menggunakan 0.296.1 dengan Tindakan GitHub:

  - uses: databricks/setup-cli@main
    with:
      version: 0.296.1
  

Kesalahan kredensial tersimpan

Mulai dari Databricks CLI versi 1.0.0, Databricks CLI menyimpan token autentikasi user-to-machine (U2M) di penyimpanan aman asli OS (rantai kunci di macOS, Credential Manager di Windows, D-Bus Secret Service di Linux) alih-alih file JSON. Lihat Penyimpanan token. Jika alur kerja Anda dibangun di atas file JSON, alur kerja tersebut tidak akan berfungsi terhadap metode penyimpanan baru dan Anda mungkin mengalami masalah dalam skenario berikut:

• Ditingkatkan ke GA, belum login kembali. Databricks CLI tidak lagi membaca kredensial yang disimpan oleh versi yang lebih lama dan mengembalikan kesalahan:

  Stored credentials from older CLI versions are no longer used.
  Run "databricks auth login" to sign in again.
  
  If secure storage is not available in this environment, set
  DATABRICKS_AUTH_STORAGE=plaintext and re-run login.
  

  Jalankan databricks auth login untuk mengatasi hal ini.

• Pemeriksaan penyimpanan aman gagal saat masuk Selama databricks auth login, Databricks CLI memeriksa penyimpanan aman sebelum memulai alur OAuth. Jika pemeriksaan gagal (paling umum dalam kontainer Linux, sesi SSH, WSL1, dan server headless di mana D-Bus tidak berjalan), perilaku tergantung pada apakah penyimpanan aman dikonfigurasi secara eksplisit:

  • Mode default, tidak ada pengaturan penyimpanan eksplisit: Databricks CLI secara diam-diam kembali ke teks biasa dan menulis auth_storage = plaintext ke bagian [__settings__]~/.databrickscfg. Perintah berikutnya menggunakan teks biasa tanpa memeriksa ulang.
  • Mode aman eksplisit (DATABRICKS_AUTH_STORAGE=secure atau auth_storage = secure di profil konfigurasi): Databricks CLI mengembalikan kesalahan yang mengarah ke opsi cadangan DATABRICKS_AUTH_STORAGE=plaintext.

  Jika pemeriksaan mengalami time-out alih-alih langsung gagal (misalnya, keychain terkunci tetapi masih dapat diakses), Databricks CLI tetap menggunakan backend keychain dan prompt untuk membuka kunci OS berjalan secara paralel dengan alur OAuth di browser.

  Untuk mengonfirmasi mode penyimpanan mana yang digunakan Databricks CLI setelah masuk, jalankan databricks auth describe.

• Rantai kunci tidak dapat dijangkau saat membaca token yang disimpan. Tidak seperti saat masuk, Databricks CLI tidak mundur secara diam-diam ketika tidak dapat mencapai rantai kunci pada waktu baca token. Misalnya, jika Anda login di komputer desktop lalu kemudian terhubung lewat SSH dalam sesi tanpa antarmuka grafis, perintah yang memerlukan token tersimpan akan gagal dengan pesan kesalahan. Gunakan fallback teks biasa untuk mengatasi hal ini. Lihat Gunakan cadangan teks biasa.

Perintah tidak terselesaikan

Jika Anda menjalankan perintah seperti databricks cluster list dan tampaknya macet, perbarui versi Databricks CLI Anda ke versi terbaru. Versi CLI yang lebih lama akan mencoba memuat daftar lengkap meskipun jumlah item dalam daftar besar, dan perintah tampaknya tidak selesai.