Not defterlerinde hata ayıklama

Makale
01/29/2025

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 13.3 LTS ve üzerinde erişim modu Tek kullanıcı olarak ayarlanmış küme
Erişim modu Databricks Runtime 13.3 LTS ve üzerinde Yalıtım Paylaşılmıyor olarak ayarlanmış küme
Erişim modu Databricks Runtime 14.3 LTS ve üzerinde Paylaşılan olarak ayarlanmış küme

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

Hata ayıklayıcısını etkinleştirmek için aşağıdaki adımları kullanın:

Ç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.
Ayarlar kenar çubuğunda Geliştirici'yi seçin.
Deneysel özellikler 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:

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.
Aşağıdaki seçeneklerden birini kullanarak hata ayıklama oturumunu başlatı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ıklama eylemleri

ek açıklamalı hata ayıklayıcı araç çubuğu

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

debug_console

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.

örnek değişken gezgini paneli

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 hata ayıklayıcı durdurma düğmesi 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.

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ısı komut kısayolları bakın.

Sınırlamalar

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

Aracılığıyla paylaş