Not defterlerinde hata ayıklama

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

Hata ayıklayıcıya erişmek için not defterinizin aşağıdaki işlem kaynaklarından birine bağlı olması gerekir:

• Sunucusuz işlem
• Databricks Runtime 14.3 LTS ve üzeri 'nda erişim moduStandart (eski adıyla paylaşılan) olarak ayarlanmış şekilde işlem yapın
• Databricks Runtime 13.3 LTS ve üzeri sürümlerde erişim modu, Ayrılmış (eski adıyla tek kullanıcı) olarak ayarlandığında hesapla.
• Databricks Runtime 13.3 LTS ve üzerindeki erişim modu'i İzolasyonsuz Paylaşım olarak ayarlayarak hesaplama yapın

Hata ayıklayıcıyı etkinleştirme

Hata ayıklayıcısını etkinleştirmek için aşağıdaki adımları kullanı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. Düzenleyici ayarları bölümünde Python Not Defteri Etkileşimli Hata Ayıklayıcısı'nı açın.

Hata ayıklamayı başlatma

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

1. Bir hücrenin kenar çubuğuna tıklayarak bir veya daha fazla kesme noktası ekleyin. Kesme noktasını kaldırmak için yeniden tıklayın.

   

2. Aşağıdaki seçeneklerden birini kullanarak hata ayıklama oturumunu başlatın:

   • Hata Ayıklama Hücresini > Çalıştır'a tıklayın.
   • Option + Shift + D klavye kısayolunu kullanın.
   • Hücre çalıştırma menüsünden Hücreyi hata 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 çıktısının en altındaki 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ıklama eylemleri

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.
• Hata ayıklayıcının durdurulduğu satırı bulun.

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].

Çalışma alanı dosyalarına adımla

Not defterleri ve dosyalar için sekmeleri etkinleştirdiğinizde kesme noktaları ayarlayabilir ve diğer çalışma alanı dosyalarında tanımlanan işlevlere adım atabilirsiniz. Bir işleve adım atmak için simgesine tıklayın. İşlev başka bir çalışma alanı dosyasında tanımlanmışsa, hata ayıklayıcı bu dosyayı yeni bir sekmede açar.

Not

• Hata ayıklayıcı yalnızca çalışma alanında dosyalarda tanımlanan işlevlere adım atabilir. Python kitaplıklarına veya diğer not defterlerine girme henüz desteklenmiyor.
• İçe aktarıldıktan sonra dış dosyaları düzenlerseniz, not defteri oturumu modülün eski sürümünü kullanmaya devam edebilir. İçeri aktarılan modüllerde yapılan düzenlemelerin hata ayıklama sırasında etkili olduğundan emin olmak için Databricks Runtime 18.0+ veya sunucusuz işlem ortamı sürüm 4+'da Python modülleri için otomatik yüklemeyi kullanın.

Hata ayıklama konsolu

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.show() Pandas DataFrames için kullanındf.head().

Değişken gezgini

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.

Görünümü filtrelemek için arama kutusuna metin girin. Siz yazarken liste otomatik olarak filtreleniyor.

Databricks Runtime 12.2 LTS ve üzeri üzerinde Python için değişkenler bir hücre çalışırken güncelleştirilir. Scala, R ve Databricks Runtime 11.3 LTS ve altındaki Python için, bir hücrenin çalışması bittikten sonra değişkenler güncelleştirilir.

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

Hata ayıklama oturumunu sonlandırmak için, hücrenin sol üst köşesindeki veya not defterinin üst kısmındaki 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.

Databricks Yardımcısı ile hata ayıklama

Databricks Yardımcısı, kodunuzun hatalarını ayıklamanıza yardımcı olabilecek bağlama duyarlı bir yapay zeka yardımcısıdır. Daha fazla bilgi için Not defterleri için yardımcı komut kısayolları bakın.

Sınırlamalar

Daha fazla bilgi için bkz Databricks not defterlerinin bilinen sınırlamaları.