Transact-SQL hata ayıklayıcısı

Şunlar için geçerlidir: SQL Server

Transact-SQL hata ayıklayıcısı, kodun çalışma zamanı davranışını araştırarak Transact-SQL kodundaki hataları bulmanıza yardımcı olur. Veritabanı Altyapısı Sorgu Düzenleyicisi penceresini hata ayıklama moduna ayarladıktan sonra, belirli kod satırlarında yürütmeyi duraklatabilir ve bu Transact-SQL deyimleri tarafından kullanılan veya döndürülen bilgileri ve verileri inceleyebilirsiniz.

T-SQL hata ayıklama visual studio için SQL Server Veri Araçları'nda kullanılabilir.

Transact-SQL kodunda adım adım ilerleyin

Transact-SQL hata ayıklayıcısı, Veritabanı Altyapısı Sorgu Düzenleyicisi penceresi hata ayıklama modundayken Transact-SQL kodda gezinmek için kullanabileceğiniz aşağıdaki seçenekleri sağlar:

• Tek tek Transact-SQL deyimlerinde kesme noktaları ayarlayın.

  Kesme noktası, verileri inceleyebilmeniz için yürütmenin duraklatılmasını istediğiniz noktayı belirtir. Hata ayıklayıcıyı başlattığınızda, Sorgu Düzenleyicisi penceresindeki ilk kod satırında duraklatılır. İlk kesme noktasına çalıştırmak için Devam'ı kullanın. Pencerenin duraklatıldığı herhangi bir konumdan sonraki kesme noktasına çalıştırmak için Devam'ı da kullanabilirsiniz. Kesme noktalarını düzenleyerek kesme noktasının yürütmeyi duraklatması gereken koşullar, Çıktı penceresine yazdırılacak bilgiler ve kesme noktasının konumunu değiştirme gibi eylemleri belirtebilirsiniz.

• Sonraki deyime geçin.

  Bu seçenek, bir ifade dizisi içerisinde tek tek gezinmenizi ve onların davranışlarını gözlemlemenizi sağlar.

• Saklı yordama veya işleve yapılan bir çağrının içine veya üzerine adım atın.

  Saklı yordamda hata olmadığından eminseniz, üzerinden geçebilirsiniz. Yordam tam olarak yürütülür ve sonuçlar koda döndürülür.

  Saklı yordam veya işlevde hata ayıklamak istiyorsanız modüle girebilirsiniz. Modülün kaynak koduyla doldurulan yeni bir Veritabanı Altyapısı Sorgu Düzenleyicisi penceresi açılır. Pencere debug modundadır ve çalıştırma, modülün ilk ifadesinde duraklatılır. Daha sonra, örneğin kodda adım adım ilerleyerek veya kesme noktası (breakpoint) ayarlayarak modül kodu içinde gezinebilirsiniz.

Hata ayıklayıcının kodda gezinmenize nasıl olanak sağladığı hakkında daha fazla bilgi için bkz. Transact-SQL kodda ilerleme.

Hata ayıklayıcı bilgilerini görüntüleme

Hata ayıklayıcısı belirli bir Transact-SQL deyiminde yürütmeyi her duraklatışında, geçerli yürütme durumunu görüntülemek için aşağıdaki hata ayıklayıcı pencerelerini kullanabilirsiniz:

• Yerel halk ve İzleme. Bu pencereler şu anda ayrılmış Transact-SQL ifadelerini görüntüler. İfadeler, tek bir skaler ifade olarak değerlendirilen Transact-SQL yan tümceleridir. Transact-SQL hata ayıklayıcısı, @@ ile başlayan adlara sahip Transact-SQL değişkenlere, parametrelere veya yerleşik işlevlere başvuran ifadelerin görüntülenmesini destekler. Bu pencereler, ifadelere atanmış olan veri değerlerini de görüntüler.

• QuickWatch. Bu pencere, bir Transact-SQL ifadesinin değerini görüntüler ve bu ifadenin gözcü penceresine kaydedilmesini sağlar.

• Kesme noktaları. Bu pencere, şu anda ayarlanmış kesme noktalarını görüntüler ve bunları yönetmenizi sağlar.

• Stack'i çağır. Bu pencerede geçerli yürütme konumu görüntülenir. Ayrıca, yürütmenin özgün Sorgu Düzenleyicisi penceresinden geçerli yürütme konumuna ulaşmak için tüm işlevler, saklı yordamlar veya tetikleyiciler aracılığıyla nasıl geçtiği hakkında bilgi sağlar.

• Çıkış. Bu pencerede hata ayıklayıcıdan gelen sistem iletileri gibi çeşitli iletiler ve program verileri görüntülenir.

• Sonuçlar ve İletiler. Sorgu Düzenleyicisi penceresindeki bu sekmeler, daha önce yürütülen Transact-SQL deyimlerinin sonuçlarını görüntüler.

Bilinen sorunlar ve sınırlamalar

T-SQL hata ayıklayıcısı yalnızca SQL Server örnekleri için geçerlidir. Hata ayıklayıcı, Azure SQL Veritabanı, Azure SQL Yönetilen Örneği veya Fabric'teki SQL veritabanı üzerinde çalışan Transact-SQL kod hata ayıklamayı desteklemez.

Belirli koşullar altında, T-SQL hata ayıklayıcısında satır vurgulama ve kesme noktaları, SQL betiğinde adım adım ilerlerken gerçek yürütme noktasıyla uyumsuz hale gelebilir. Bu sorun, betiğin en üstündeki bir yorum veya GO ifadelerinden sonraki boş satırlar da dahil olmak üzere farklı senaryolarda meydana gelebilir.

Transact-SQL hata ayıklayıcı görevleri

Görev Açıklaması	Article
Transact-SQL hata ayıklayıcısını uzaktan hata ayıklama için yapılandırmayı açıklar.	Transact-SQL hata ayıklayıcısını çalıştırmadan önce güvenlik duvarı kurallarını yapılandırma
Hata ayıklayıcının işlemini başlatma, durdurma ve denetlemeyi açıklar.	Transact-SQL hata ayıklayıcısını çalıştırma
Kodda adım adım ilerletmek için Transact-SQL hata ayıklayıcısının nasıl kullanılacağını açıklar.	Transact-SQL kodunda adım adım ilerleyin
Saklı yordam kodunda adım adım ilerletmek için Transact-SQL hata ayıklayıcısının nasıl kullanılacağını açıklar.	Saklı yordamlarda hata ayıklama
Parametreler, değişkenler ve sistem bilgileri gibi Transact-SQL verileri görüntülemek için hata ayıklayıcının nasıl kullanılacağını açıklar.	Transact-SQL hata ayıklayıcı bilgileri