Databricks etkileşimli hata ayıklayıcısını kullanma

Önemli

Bu özellik Genel Önizlemededir.

Bu sayfada, Databricks not defterindeki yerleşik etkileşimli hata ayıklayıcının nasıl kullanılacağı açıklanmaktadır. Hata ayıklayıcısı yalnızca Python için kullanılabilir.

Etkileşimli hata ayıklayıcı, not defterlerinde daha verimli bir şekilde kod geliştirmenize yardımcı olmak için kesme noktaları, adım adım yürütme, değişken inceleme ve daha fazla araç sağlar.

Gereksinimler

Not defterinizin aşağıdaki gereksinimleri karşılayan bir kümeye eklenmesi gerekir:

• Databricks Runtime sürüm 13.3 LTS veya üzeri.
• Erişim modu Tek kullanıcı (Atanan) veya Yalıtım paylaşılmadı olmalıdır.

Hata ayıklayıcıyı etkinleştirme veya devre dışı bırakma

Hata ayıklayıcıyı etkinleştirmek veya devre dışı bırakmak için aşağıdakileri yapın:

1. Çalışma alanının sağ üst kısmındaki kullanıcı adınıza tıklayın ve açılan listeden Ayarlar'ı seçin.
2. Ayarlar kenar çubuğunda Geliştirici'yi seçin.
3. Deneysel özellikler bölümünde Python Not Defteri Etkileşimli Hata Ayıklayıcısı'nı açın.

Hata ayıklayıcıyı başlatma

Hata ayıklayıcıyı başlatmak için şu adımları izleyin:

1. Hücrenin cilt payı içine tıklayarak bir veya daha fazla kesme noktası ekleyin. Kesme noktasını kaldırmak için yeniden tıklayın.

   

2. Aşağıdakilerden birini yapın:

   • Hata Ayıklama Hücreyi Çalıştır'a > tıklayın.
   • Option + Shift + D klavye kısayolunu kullanın.
   • Hücre çalıştırma menüsünden Hücre hatalarını ayıkla'yı seçin.

   

Hata ayıklama oturumu otomatik olarak başlar ve seçili hücreyi çalıştırır.

Ayrıca, bir hücre hata tetikliyorsa hata ayıklayıcıyı başlatabilirsiniz. Hücre çıkışının en altında öğesine tıklayın .

Hata ayıklama oturumu etkin olduğunda, hücrenin en üstünde hata ayıklama araç çubuğu görüntülenir.

Hata ayıklayıcısını kullanma

Hata ayıklama oturumunda aşağıdakileri yapabilirsiniz:

• Kesme noktalarını ayarlayın veya kaldırın.
• Bir kesme noktasında değişkenlerin değerlerini görüntüleyin.
• Kodda adım adım ilerleyin.
• İşlevin içine veya dışına adım atın.

Kod bir kesme noktasına ulaştığında, satır çalıştırılmadan önce durur, sonra değil.

Kodda adım adım ilerleyebilmek için hata ayıklayıcı araç çubuğundaki düğmeleri kullanın. Kodda adım adım ilerlediğinizde, hücrede geçerli satır vurgulanır. Değişken değerlerini sağ kenar çubuğundaki değişken gezgini bölmesinde görüntüleyebilirsiniz.

Bir işlevde adım adım ilerlediğinizde, değişken bölmesinde yerel işlev değişkenleri görünür ve işaretlidir [local].

Hata ayıklama konsolunu kullanma

Hata ayıklama oturumu başlattığınızda, hata ayıklama konsolu otomatik olarak alt panelde görüntülenir. Bu konsol, kesme noktasında duraklatıldığında değişkenleri incelemek veya işlemek için Python kodu yürütmenizi sağlar. Ana not defterinde yürütülen kod, hata ayıklama oturumu sırasında çalışmaz. Konsolda kod çalıştırmak için Enter tuşuna basın. Çok satırlı ifadeler için Shift + Enter tuşlarını kullanarak yeni bir satıra geçin.

Not

• Hata ayıklama konsolu hızlı değerlendirmeler için tasarlanmıştır ve kod yürütme 15 saniyeyi aşarsa zaman aşımına uğrar.
• display Komut, hata ayıklama konsolunda desteklenmez. DataFrame'den örnek verileri görüntülemek için PySpark DataFrames veya df.head() Pandas DataFrames için kullanındf.show().

Değişken gezginini kullanma

Değişkenlerinizin değerlerini görüntülemek için sağ taraftaki değişken gezgini panelini kullanabilirsiniz. İncele'ye tıklanması, hata ayıklama konsolunda otomatik olarak kod yürüterek değişkeninizin değerini verir.

Hata ayıklayıcı oturumlarını sonlandırma

Hata ayıklama oturumunu sonlandırmak için hücrenin sol üst kısmına tıklayın veya not defterinin üst kısmına tıklayın . Kullanıcı hata ayıklama araç çubuğunu veya hata ayıklama konsolunu kullanmazsa hata ayıklama oturumu da 30 dakika sonra otomatik olarak sonlanır.

Sınırlamalar

Daha fazla bilgi için bkz . Bilinen sınırlamalar Databricks not defterleri .