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.
.gif "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.
.gif "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
|
.gif "Integration Services simgesi (küçük)")
Integration Services ile güncel kalın