Kontrol Akışında Hata Ayıklama

Şunlar için geçerlidir:SQL Server Azure Data Factory'de SSIS Tümleştirme Çalışma Zamanı

SQL Server Veri Araçları (SSDT) ve Microsoft Integration Services, Integration Services paketindeki denetim akışı sorunlarını gidermek için kullanabileceğiniz özellikler ve araçlar içerir.

• Integration Services, kapsayıcılarda ve görevlerde kesme noktalarını destekler.

• SSIS Tasarımcısı, çalışma zamanında ilerleme durumu raporlaması sağlar.

• SQL Server Veri Araçları (SSDT), hata ayıklama pencereleri sağlar.

Breakpoints

SSIS Tasarımcısı kesme koşullarını etkinleştirerek ve paketin yürütülmesi askıya alınmadan önce bir kesme noktasının kaç kez gerçekleşebileceğini belirterek kesme noktaları ayarla iletişim kutusunu sağlar. Kesme noktaları paket düzeyinde veya tek tek bileşen düzeyinde etkinleştirilebilir. Kesme koşulları görev veya kapsayıcı düzeyinde etkinleştirilirse, Denetim Akışı sekmesinin tasarım yüzeyinde görevin veya kapsayıcının yanında kesme noktası simgesi görünür. Pakette kesme koşulları etkinse, Denetim Akışı sekmesinin etiketinde kesme noktası simgesi görüntülenir.

Kesme noktasına basıldığında kesme noktası simgesi, kesme noktasının kaynağını belirlemenize yardımcı olacak şekilde değişir. Paket çalışırken kesme noktaları ekleyebilir, silebilir ve değiştirebilirsiniz.

Integration Services, tüm görevlerde ve kapsayıcılarda etkinleştirebileceğiniz on kesme koşulu sağlar. Kesme Noktalarını Ayarla iletişim kutusunda, kesme noktalarını aşağıdaki koşullarda etkinleştirebilirsiniz:

Durdurma koşulu	Description
Görev veya kapsayıcı OnPreExecute olayını aldığında.	Bir görev yürütülmek üzereyken çağrılır. Bu olay, çalıştırılmadan hemen önce bir görev veya kapsayıcı tarafından tetiklenir.
Görev veya kapsayıcı OnPostExecute olayını aldığında.	Görevin yürütme mantığı tamamlandıktan hemen sonra çağrılır. Bu olay, çalıştırıldıktan hemen sonra bir görev veya kapsayıcı tarafından oluşturulur.
Görev veya kapsayıcı OnError olayını aldığında.	Hata oluştuğunda görev veya kapsayıcı tarafından çağrılır.
Görev veya kapsayıcı OnWarning olayını aldığında.	Görev bir hatayı haklı çıkarmayan, ancak uyarıyı garanti eden bir durumda olduğunda çağrılır.
Görev veya kapsayıcı OnInformation olayını aldığında.	Görev bilgi sağlamak için gerektiğinde çağrılır.
Görev veya kapsayıcı OnTaskFailed olayını aldığında.	Başarısız olduğunda görev konağı tarafından çağrılır.
Görev veya kapsayıcı OnProgress olayını aldığında.	Görev yürütmeyle ilgili ilerleme durumunu güncelleştirmek için çağrıldı.
Görev veya kapsayıcı OnQueryCancel olayını aldığında.	Görev işleme sırasında istediğiniz zaman çağrılabilir, bu sayede yürütmeyi iptal edebilirsiniz.
Görev veya kapsayıcı OnVariableValueChanged olayını aldığında.	Bir değişkenin değeri değiştiğinde Integration Services çalışma zamanı tarafından çağrılır. Bu olayı tetiklemek için, değişkenin RaiseChangeEvent değeri true olarak ayarlanmalıdır. **Uyarı** Bu kesme noktasıyla ilişkili değişken kapsayıcı kapsamında tanımlanmalıdır. Değişken paket kapsamında tanımlanmışsa kesme noktasına ulaşılmaz.
Görev veya kapsayıcı OnCustomEvent olayını aldığında.	Görevler tarafından özel görev tanımlı olayları tetiklemek için çağrılır.

Tüm görevler ve kapsayıcılar için kullanılabilen kesme koşullarına ek olarak, bazı görevler ve kapsayıcılar kesme noktalarını ayarlamak için özel kesme koşulları içerir. Örneğin, döngünün her yinelemesinin başlangıcında yürütmeyi askıya alan bir kesme noktası ayarlayan For Loop kapsayıcısı üzerinde bir kesme koşulu etkinleştirebilirsiniz.

Kesme noktasına esneklik ve güç eklemek için, aşağıdaki seçenekleri belirterek kesme noktasının davranışını değiştirebilirsiniz:

• İsabet sayısı, ya da yürütme askıya alınmadan önce kesilme koşulunun gerçekleştiği en fazla sayıdır.

• İsabet sayısı türü veya kesme koşulunun kesme noktasını ne zaman tetikleyeceğini belirten kural.

Her zaman türü dışında isabet sayısı türleri, isabet sayısı tarafından daha fazla nitelenir. Örneğin, tür "İsabet sayısı eşittir" ve isabet sayısı 5 ise, durdurma koşulu altıncı kez gerçekleştiğinde yürütme askıya alınır.

Aşağıdaki tabloda isabet sayısı türleri açıklanmaktadır.

İsabet sayısı türü	Description
Her zaman	Kesme noktasına isabet edildiğinde yürütme her zaman duraklatılır.
İsabet sayısı eşittir	Kesme noktasının gerçekleşme sayısı isabet sayısına eşit olduğunda yürütme askıya alınır.
İsabet sayısı, eşit veya daha büyüktür	Kesme noktasının gerçekleşme sayısı isabet sayısına eşit veya ondan büyük olduğunda yürütme askıya alınır.
Çoklu isabet sayısı	İsabet sayısının katı bir değere ulaştığında yürütme askıya alınır. Örneğin, bu seçeneği 5 olarak ayarlarsanız, yürütme her beşinci seferde askıya alınır.

Kesme noktalarını ayarlamak için

• Görev veya Kapsayıcıda Kesme Noktaları Ayarlayarak Pakette Hata Ayıklama

İlerleme Durumu Raporlama

SSIS Tasarımcısı iki tür ilerleme raporlaması içerir: Denetim Akışı sekmesinin tasarım yüzeyinde renk kodlama ve İlerleme sekmesinde ilerleme iletileri.

Bir paketi çalıştırdığınızda, SSIS Tasarımcısı yürütme durumunu gösteren bir renk kullanarak her görevi veya kapsayıcıyı görüntüleyerek yürütme ilerleme durumunu gösterir. Öğesinin çalışmak için beklediğini, şu anda çalıştığını, başarıyla tamamlandığını veya başarısız bir şekilde sona erdiğini rengine göre anlayabilirsiniz. Paket yürütmeyi durdurduktan sonra renk kodlaması kaybolur.

Aşağıdaki tabloda yürütme durumunu görüntülemek için kullanılan renkler açıklanmaktadır.

Renk	Çalıştırma durumu
Gray	Çalıştırılmayı bekliyor
Yellow	Koşmak
Green	Başarıyla tamamlandı
Vurgulanan	Hatalarla çalıştırıldı

İlerleme durumu sekmesi görevleri ve kapsayıcıları yürütme sırasına göre listeler ve başlangıç ve bitiş zamanlarını, uyarıları ve hata iletilerini içerir. Paket yürütmeyi durdurduktan sonra, ilerleme bilgileri Yürütme Sonuçları sekmesinde kullanılabilir durumda kalır.

Uyarı

İlerleme Durumu sekmesinde iletilerin görüntülenmesini etkinleştirmek veya devre dışı bırakmak için SSISmenüsündeki İlerleme Raporlama hatalarını ayıkla seçeneğini değiştirin.

Aşağıdaki diyagramda İlerleme sekmesi gösterilmektedir .

Windows hatalarını ayıklama

SQL Server Veri Araçları (SSDT), kesme noktalarıyla çalışmak ve kesme noktaları içeren paketlerde hata ayıklamak için kullanabileceğiniz birçok pencere içerir. Her pencere hakkında daha fazla bilgi edinmek için pencereyi açın ve ardından F1 tuşuna basarak pencerenin Yardım'ını görüntüleyin.

Bu pencereleri SQL Server Veri Araçları'nda (SSDT) açmak için Hata Ayıkla menüsüne tıklayın, Pencereler üzerine gelin ve Kesme Noktaları, Çıkış'a veya Hemen Penceresi'ne tıklayın.

Aşağıdaki tabloda her pencere açıklanmaktadır.

Pencere	Description
Breakpoints	Bir paketteki kesme noktalarını listeler ve kesme noktalarını etkinleştirme ve silme seçenekleri sağlar.
Çıktı	SQL Server Veri Araçları'ndaki (SSDT) özellikler için durum iletilerini görüntüler.
Hemen	İfadelerin hatalarını ayıklamak ve değerlendirmek ve değişken değerlerini yazdırmak için kullanılır.

Görev veya Kapsayıcıda Kesme Noktaları Ayarlayarak Pakette Hata Ayıklama

Bu yordamda bir pakette, görevde, For Döngüsü kapsayıcısında, Foreach Döngüsü kapsayıcısında veya Sıralı kapsayıcıda kesme noktalarının nasıl ayarlanacağı açıklanır.

Pakette, görevde veya kapsayıcıda kesme noktaları ayarlamak için

1. SQL Server Veri Araçları'nda (SSDT), istediğiniz paketi içeren Integration Services projesini açın.

2. Kesme noktalarını ayarlamak istediğiniz pakete çift tıklayın.

3. SSIS Tasarımcısı'nda aşağıdakileri yapın:

   • Paket nesnesinde kesme noktaları ayarlamak için Denetim Akışı sekmesine tıklayın, imleci tasarım yüzeyinin arka planında herhangi bir yere getirin, sağ tıklayın ve kesme noktalarını düzenle'ye tıklayın.

   • Paket denetim akışında kesme noktaları ayarlamak için Denetim Akışı sekmesine tıklayın, bir göreve, For Döngüsü kapsayıcısına, Foreach Döngüsü kapsayıcısına veya Sıralı kapsayıcıya sağ tıklayın ve kesme noktalarını düzenle'ye tıklayın.

   • Olay işleyicisinde kesme noktaları ayarlamak için Olay İşleyicisi sekmesine tıklayın, bir göreve, For Döngüsü kapsayıcısına, Foreach Döngüsü kapsayıcısına veya Sıralı kapsayıcıya sağ tıklayın ve ardından Kesme Noktalarını Düzenle'ye tıklayın.

4. Kesme Noktalarını <Ayarla kapsayıcı adı> iletişim kutusunda, etkinleştirileceği kesme noktalarını seçin.

5. İsteğe bağlı olarak, her kesme noktası için isabet sayısı türünü ve isabet sayısı numarasını değiştirin.

6. Paketi kaydetmek için Dosya menüsünde Seçili Öğeleri Kaydet'e tıklayın.

Kesme Noktalarını Ayarlama

Kesme noktalarının etkinleştirileceği olayları belirtmek ve kesme noktasının davranışını denetlemek için Kesme Noktalarını Ayarla iletişim kutusunu kullanın.

Options

Enabled
Bir olayda kırılma noktasını etkinleştirmek için seçeneği belirleyin.

Kesme Koşulu
Kesme noktalarının ayarlanacağı kullanılabilir olayların listesini görüntüleyin.

İsabet Sayısı Türü
Kesme noktasının ne zaman etkin olduğunu belirtin.

Değer	Description
Her Zaman	Kesme noktasına isabet edildiğinde yürütme her zaman duraklatılır.
İsabet sayısı eşittir	Kesme noktasının gerçekleşme sayısı isabet sayısına eşit olduğunda yürütme askıya alınır.
Büyük veya eşit olanı seç	Kesme noktasının gerçekleşme sayısı isabet sayısına eşit veya ondan büyük olduğunda yürütme askıya alınır.
İsabet sayısı çarpanı	İsabet sayısının katı bir değere ulaştığında yürütme askıya alınır. Örneğin, bu seçeneği 5 olarak ayarlarsanız, yürütme her beşinci seferde askıya alınır.

İsabet Sayısı
Hangi isabet sayısında durdurmanın tetikleneceğini belirtin. Kesme noktası her zaman etkinse bu seçenek kullanılamaz.

Ayrıca Bkz.

Paket Geliştirme için Sorun Giderme Araçları
Betik Görevi ve Betik Bileşeninde Kesme Noktaları Ayarlayarak Betikte Hata Ayıklama