Aracılığıyla paylaş


SSIS paketi olay işleyicileri

Çalıştırma sırasında yürütülebilir dosyaları (paketler ve Foreach döngü, döngü için sıra ve görev ana konteyner) olaylarını. Örneğin, bir hata oluştuğunda OnError olay ortaya çıkar. Paketi işlevselliği genişletebilir ve paketleri zamanında yönetmeyi kolaylaştırmak için bu olayları özel olay işleyicileri oluşturabilirsiniz. Olay işleyicileri aşağıdaki görevleri gerçekleştirebilirsiniz:

  • Bir paket veya görev çalışmasını bitirdiğinde geçici veri depolama kadar temiz.

  • Bir paketi çalıştırmadan önce kaynak kullanılabilirliğini değerlendirmek için sistem bilgileri alabilirsiniz.

  • Başvuru tablosundaki Arama başarısız olduğunda bir tabloda veri yenilemek.

  • Bir hata veya uyarı oluştuğunda veya bir görev başarısız olduğunda bir e-posta iletisi gönderin.

Olay hiçbir olay işleyicisi varsa, olay sonraki konteyner paket kapsayıcı hiyerarşisinde yukarıya yükseltilir. Bu kapsayıcı, bir olay işleyicisi varsa, olay olay işleyici çalışır. Aksi halde, olay sonraki konteyner konteyner hiyerarşisinde yukarıya yükseltilir.

Aşağıdaki diyagram içeren bir sql Yürüt görev için döngü kapsayıcı olan basit bir paket gösterir.

Paket, For Döngüsü, görev ana bilgisayarı, SQL Yürüt görevi

Paket için bir olay işleyicisi vardır sadece kendi OnErrorolay. sql Yürüt görev çalışır, bir hata oluştuğunda, OnErrorolay işleyicisi paketi çalıştırır. Aşağıdaki çizimde, neden arama sırasını gösterir OnErroryürütmek için olay işleyicisi paket.

Olay işleyicisi akışı

Olay işleyicileri bir olay işleyici derlemesi bir üyesidir ve tüm kapsayıcılara bu koleksiyonu içerir. Paketi kullanarak oluşturursanız, SSIStasarımcı, olay işleyicisi koleksiyonlarında üyelerini görebilirsiniz Olay işleyicileri klasörleri Paketi Explorer sekmesini SSIStasarımcı.

Olay işleyicisi kapsayıcı aşağıdaki şekillerde yapılandırabilirsiniz:

  • Bir ad ve açıklama için olay işleyici belirtin.

  • Olay işleyicisi başarısız olur ve olay işleyicisi önce oluşan hataları sayısı başarısız olursa, paket başarısız olup olay işleyicisi çalışıp gösterir.

  • Olay işleyicisi çalıştırma sırasında döndürür yerine gerçek yürütme sonuca dönmek için bir yürütme sonuç belirtir.

  • Olay işleyicisi hareket seçeneğini belirtin.

  • Olay işleyicisi kullanan oturum açma modunu belirtin.

Olay işleyicisi Content

Bir olay işleyicisi oluşturma, bir paket oluşturmak için benzer; görevler ve denetimi akışı sıralanamadı, konteyner, olay işleyicisi vardır ve olay işleyicisi de veri akışı içerebilir. SSISTasarımcısı içerir Olay işleyicisini özel olay işleyicisi oluşturma sekmesi. Daha fazla bilgi için, bkz. Creating Package Event Handlers.

Olay işleyicileri programatik olarak da oluşturabilirsiniz. Daha fazla bilgi için, bkz. Olayları programlı olarak işleme.

Çalışma Zamanı olayları

Aşağıdaki tabloda olay işleyicileri, Integration Servicessağlar ve olay işleyicisi çalıştırmak neden çalışma zamanı olaylarını açıklar.

Olay işleyicisi

Olay

OnError

Olay işleyicisini OnError olay. Bir hata oluştuğunda, bu olay bir yürütülebilir program tarafından oluşturulur.

OnExecStatusChanged

Olay işleyicisini OnExecStatusChanged olay. Yürütme durumu değiştiğinde bu olay bir yürütülebilir program tarafından oluşturulur.

OnInformation

Olay işleyicisini OnInformation olay. Bu olay, doğrulama ve rapor bilgilerini bir yürütülebilir yürütme sırasında oluşturulur. Bu olay, sadece bilgi, hata veya uyarılar veriyor.

OnPostExecute

Olay işleyicisini OnPostExecute olay. Hemen çalışması bittikten sonra bu olay bir yürütülebilir program tarafından oluşturulur.

OnPostValidate

Olay işleyicisini OnPostValidate olay. Onun doğrulama tamamlandığında bu olay bir yürütülebilir program tarafından oluşturulur.

OnPreExecute

Olay işleyicisini OnPreExecute olay. Hemen çalıştırmadan önce bu olay bir yürütülebilir program tarafından oluşturulur.

OnPreValidate

Olay işleyicisini OnPreValidate olay. Bu olay, onun doğrulama başladığında bir yürütülebilir program tarafından oluşturulur.

OnProgress

Olay işleyicisini OnProgress olay. Ölçülebilir ilerleme yürütülebilir dosya tarafından yapıldığında bu olay bir yürütülebilir program tarafından oluşturulur.

OnQueryCancel

Olay işleyicisini OnQueryCancel olay. Bu olay, çalışan durdurmak olup olmadığını belirlemek için bir yürütülebilir program tarafından oluşturulur.

OnTaskFailed

Olay işleyicisini OnTaskFailed olay. Bu olay başarısız olduğunda bir görev tarafından oluşturulur.

OnVariableValueChanged

Olay işleyicisini OnVariableValueChanged olay. Bu olay, bir değişken değeri değiştiğinde bir yürütülebilir program tarafından oluşturulur. Olay, değişken tanımlandığı yürütülebilir program tarafından oluşturulur. Eğer bu olay ortaya değil RaiseChangeEvent özelliği değişken için False. Daha fazla bilgi için, bkz. SSIS paketi değişkenleri.

OnWarning

Olay işleyicisini OnWarning olay. Uyarı oluştuğunda, bu olay bir yürütülebilir program tarafından oluşturulur.

Bir olay işleyicisi yapılandırma

Özellikleri ayarlayabilirsiniz Özellikler pencere SQL Server Veri Akışı Araçları (SSDT)ya da programlı.

Bu özellikleri ayarlama hakkında bilgi için SQL Server Veri Akışı Araçları (SSDT)bakın Görev veya kapsayıcı özelliklerini ayarlama.

Program aracılığıyla bu özellikleri ayarlama hakkında daha fazla bilgi için bkz: DtsEventHandler.

ilişkili Görevler

Bir paket için bir olay işleyicisi ekleme hakkında daha fazla bilgi için bkz: Paket için bir olay işleyicisi ekleme.

İlişkili İçerik

Integration Services simgesi (küçük) Integration Services ile güncel kalın

En son karşıdan yüklemeler, makaleler, örnekler ve Microsoft video yanı sıra topluluk seçili çözümleri için ziyaret Integration ServicesMSDN sayfası:


Bu güncelleştirmelerle ilgili otomatik bildirim almak için, sayfadaki RSS akışlarına abone olun.