Bagikan melalui

Men-debug buku catatan

  • Artikel

Penting

Fitur ini ada di Pratinjau Publik.

Halaman ini menjelaskan cara menggunakan debugger interaktif bawaan di buku catatan Databricks. Debugger hanya tersedia untuk Python.

Debugger interaktif menyediakan titik henti, eksekusi langkah demi langkah, inspeksi variabel, dan lebih banyak alat untuk membantu Anda mengembangkan kode di buku catatan dengan lebih efisien.

Persyaratan

Buku catatan Anda harus dilampirkan ke kluster yang memenuhi persyaratan berikut:

  • Databricks Runtime versi 13.3 LTS atau lebih tinggi.
  • Mode akses harus Pengguna tunggal (Ditetapkan) atau Tidak ada isolasi yang dibagikan.

Aktifkan debugger

Gunakan langkah-langkah berikut untuk mengaktifkan debugger, :

  1. Klik nama pengguna Anda di kanan atas ruang kerja dan pilih Pengaturan dari daftar dropdown.
  2. Di bar samping Pengaturan , pilih Pengembang.
  3. Di bagian Fitur eksperimental, alihkan Python Notebook Interactive Debugger.

Mulai penelusuran kesalahan

Untuk memulai debugger, ikuti langkah-langkah berikut:

  1. Tambahkan satu atau beberapa titik henti dengan mengklik selokan sel. Untuk menghapus titik henti, klik lagi.

    membuat dan menghapus video titik henti

  2. Mulai sesi penelusuran kesalahan dengan menggunakan salah satu opsi berikut:

    • Klik Jalankan > sel Debug.
    • Gunakan pintasan keyboard Opsi + Shift + D.
    • Dari menu eksekusi sel, pilih Sel debug.

    men-debug item sel di menu eksekusi sel

Sesi debug dimulai secara otomatis dan menjalankan sel yang dipilih.

Anda juga dapat memulai debugger jika sel memicu kesalahan. Di bagian bawah output sel, klik Tombol debug.

Saat sesi debug aktif, toolbar Toolbar debug debug muncul di bagian atas sel.

Tindakan penelusuran kesalahan

toolbar debugger yang dianotasi

Dalam sesi debug, Anda bisa melakukan hal berikut:

  • Mengatur atau menghapus titik henti.
  • Lihat nilai variabel pada titik henti.
  • Telusuri kode tersebut.
  • Masuk atau keluar dari fungsi.

Ketika kode mencapai titik henti, kode berhenti sebelum baris dijalankan, bukan setelahnya.

Gunakan tombol di toolbar debugger untuk menelusuri kode. Saat Anda menelusuri kode, baris saat ini disorot dalam sel. Anda dapat melihat nilai variabel di panel penjelajah variabel di bilah sisi kanan.

Saat Anda menelusuri fungsi, variabel fungsi lokal muncul di panel variabel, ditandai [local].

Konsol debug

Saat Anda memulai sesi penelusuran kesalahan, konsol debug secara otomatis muncul di panel bawah. Konsol ini memungkinkan Anda menjalankan kode Python untuk memeriksa atau memanipulasi variabel saat dijeda pada titik henti. Kode yang dijalankan di buku catatan utama tidak berjalan selama sesi penelusuran kesalahan. Untuk menjalankan kode di konsol, tekan Enter. Untuk ekspresi multibaris, gunakan Shift + Enter untuk berpindah ke baris baru.

debug_console

Catatan

  • Konsol debug dirancang untuk evaluasi cepat dan waktu habis jika eksekusi kode melebihi 15 detik.
  • Perintah display tidak didukung di konsol debug. Untuk melihat data sampel dari DataFrame, gunakan df.show() untuk PySpark DataFrames atau df.head() untuk Pandas DataFrames.

Penjelajah variabel

Anda dapat menggunakan panel ikon penjelajah variabel penjelajah variabel di sisi kanan untuk melihat nilai variabel Anda. Mengklik Periksa secara otomatis menjalankan kode di konsol debug untuk menghasilkan nilai variabel Anda.

contoh panel penjelajah variabel

Untuk memfilter tampilan, masukkan teks ke dalam kotak pencarian. Daftar secara otomatis difilter saat Anda mengetik.

Untuk Python pada Databricks Runtime 12.2 LTS ke atas, variabel diperbarui saat sel berjalan. Untuk Scala, R, dan untuk Python pada Databricks Runtime 11.3 LTS dan di bawahnya, variabel diperbarui setelah sel selesai berjalan.

Mengakhiri sesi debugger

Untuk mengakhiri sesi penelusuran kesalahan, klik tombol hentikan debugger di kiri atas sel atau klik tombol hentikan buku catatan di bagian atas buku catatan. Sesi debug juga secara otomatis berakhir setelah 30 menit jika pengguna tidak menggunakan toolbar penelusuran kesalahan atau konsol debug.

Debug dengan Asisten Databricks

Asisten Databricks adalah asisten AI sadar konteks yang dapat membantu Anda men-debug kode Anda. Lihat Menggunakan Asisten Databricks di sel buku catatan untuk informasi selengkapnya.

Batasan

Lihat Buku catatan Databricks batasan yang diketahui untuk informasi selengkapnya.