Oluşturma, dağıtma ve özel nesneler hata ayıklama

Makale
10/29/2012

Sizin için özel bir nesne kodunu yazdım sonra Integration Services, derleme oluşturmak gerekir, o dağıtmak, içine entegre SSIStasarımcı kullanılmak üzere paketleri, yapmak ve sınamak ve görüneceği şekilde hata ayıklamak için

Oluşturma, dağıtma ve Tümleştirme Hizmetleri özel nesne hata ayıklama adımları

Özel işlevler için nesne zaten yazdım. Şimdi bunu test etmek ve kullanıcıların kullanabilmesi için var. Merdiven are çok benzer için oluşturduğunuz özel nesneler her türlü Integration Services.

Oluşturma, dağıtma ve bu hata ayıklama izleyin adımları şunlardır:

Oturum derleme kesin adıyla üretilecek.
Yapı derleme.
Dağıtmak derleme taşıyarak veya uygun kopyalayarak Integration Servicesklasör.
Yüklemek derleme genel derleme önbelleğine (gac).

Nesne araç otomatik olarak eklenir.
Sorun giderme dağıtım, gerekirse.
Sınav ve hata ayıklama kodunuzu.

Derleme imzalama

Derleme paylaşılması amaçlanmıştır zaman, genel birleştirme önbelleğine yüklenmesi gerekir. Derleme genel derleme önbelleğine eklendikten sonra montaj uygulamaları tarafından gibi kullanılabilir SQL Server Veri Akışı Araçları (SSDT). Genel derleme önbelleğinde derleme derleme genel benzersiz garanti güçlü bir adla imzalanmalıdır zorunludur. Kesin adlandırılmış derleme adı, kültür, ortak anahtarı ve sürüm numarası derleme içeren tam bir adı vardır. Çalışma Zamanı, derleme bulmak ve aynı adı taşıyan diğer derlemeler den ayırmak için bu bilgileri kullanır.

Güçlü bir ada sahip bir derleme imzalamak için siz sahip veya ortak/özel anahtar çifti oluşturmak. Bu kamu ve özel şifreleme anahtar çifti oluşturma zaman kesin adlandırılmış derleme oluşturmak için kullanılır.

Followto oturum derleme gerekir ve güçlü isimler hakkında adımlar için aşağıdaki konulara bakınız .NET Frameworksdk belgelerine:

Derlemeler kesin adlandırılmış
Bir anahtar çifti oluşturma
Güçlü bir ada sahip bir derleme imzalama

Sen-ebilmek kolayca işaret ile güçlü bir isim, montaj Visual Studiokurmak zaman. İçinde Proje özelliklerini Seç iletişim kutusunda imza sekmesi. Seçeneğini işareti derleme ve anahtar (.snk) dosyasının yolunu girin.

Meclis Binası

Proje imzalanmasından sonra inşa veya gerekir üzerinde kullanılabilen komutları kullanarak proje ya da çözüm yeniden inşa menüsü SQL Server Veri Akışı Araçları. Çözüm için de güçlü bir isim ile imzalanmış olması gerekir, ve aynı zamanda inşa edilecek özel bir kullanıcı arabirimi, ayrı bir proje içerebilir.

Sonraki iki adımı gerçekleştirmek için en uygun yöntem — derleme dağıtma ve genel birleştirme önbelleğine yükleyerek — bir post-build olay içinde bu adımları komut dosyası için Visual Studio. Yapı olayları mevcut derlemek sayfa proje özelliklerinin bir Visual BasicProje ve Build Events bir C# projesi için sayfa. Tam yolunu komut istemi yardımcı programları gibi gerekli gacutil.exe. Boşluk içeren yollar etrafında ve etrafında boşluk içeren yolları genişletme makroları $(TargetPath) gibi tırnak işaretleri gereklidir.

Özel günlük sağlayıcı için bir post-build olay komut satırı örneği aşağıda verilmiştir:

"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -u $(TargetName)
"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -i $(TargetFileName)
copy $(TargetFileName) "C:\Program Files\Microsoft SQL Server\100\DTS\LogProviders "

"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -u $(TargetName)
"C:\Program Files\Microsoft Visual Studio 9.0\SDK\v3.5\Bin\gacutil.exe" -i $(TargetFileName)
copy $(TargetFileName) "C:\Program Files\Microsoft SQL Server\100\DTS\LogProviders "

Derleme dağıtma

SSISTasarımcısı tarafından ne zaman oluşturulan klasörler bir dizi içinde bulunan dosyalar numaralandırılıyor paketleri kullanıma özel nesneler bulur SQL Server Integration Servicesyüklenir. Ne zaman varsayılan SQL Serveryükleme ayarları kullanılır, bu klasörler kümesi altında bulunan C:\Program Files\Microsoft SQL Server\100\DTS. Ancak bir kurulum programı için özel nesne oluşturursanız, değerini kontrol etmelisiniz HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Microsoft SQL Server\100\SSIS\Setup\DtsPathBu klasörün konumunu doğrulamak için kayıt defteri anahtarı.

Sen-ebilmek koymak derleme klasöründe bulunan iki yolu vardır:

Taşımak veya derlenmiş derleme oluşturduktan sonra uygun klasöre kopyalayın. (Kolaylık sağlamak için copy komutu bir Post-build olay ekleyebilirsiniz.)
Derleme doğrudan uygun klasörü oluşturun.

Aşağıdaki dağıtım klasörleri altında C:\Program Files\Microsoft SQL Server\100\DTSözel nesneler çeşitli türleri için kullanılır:

Özel nesne	Dağıtım klasörü
Görev	Görevler
Bağlantı Yöneticisi	Bağlantıları
Günlük sağlayıcı	LogProviders
Veri akışı bileşen	PipelineComponents

[!NOT]

Derlemeler, numaralandırma kullanılabilir görevleri, Bağlantı Yöneticisi, vb. desteklemek için bu klasörlere kopyalanır. Bu nedenle yalnızca özel kullanıcı arabirimi için özel nesneler için bu klasörleri içeren derlemeler dağıtmak zorunda değil.

Derleme genel derleme önbelleğinde yükleme

Görev derleme genel derleme önbelleğine (gac) yüklemek için komut satırı aracını kullanma gacutil.exe, ya da derlemeler sürükleyin %system%\assemblydizini. Kolaylık sağlamak için da aramaya dahil edebilirsiniz gacutil.exebir Post-build olay.

Aşağıdaki komut, adlı bir bileşeni yükler MyTask.dllkullanarak gac içine gacutil.exe.

gacutil /iF MyTask.dll

Sen kapatmak ve yeniden SSISözel nesne yeni bir sürümünü yükledikten sonra tasarımcı. Genel birleştirme önbelleğine özel nesne'nın önceki sürümlerini yüklediyseniz, yeni sürümü yüklemeden önce kaldırmalısınız. Derleme uninstall, koşmak gacutil.exeve derleme adını belirtmek /useçeneği.

Genel birleştirme önbelleği hakkında daha fazla bilgi için bkz genel birleştirme önbelleği Aracı (Gactutil.exe) .NET FrameworkAraçlar.

Bir görev veya veri akışı bileşeni araç ekleme

Size özel nesne dağıtılan ve genel derleme önbelleğinde yüklü sonra onu kullanılabilir SQL Server Veri Akışı Araçları (SSDT)gibi herhangi bir nesne ile dahil SQL Server Integration Services. Ancak, onu eklemeniz gerekir araç açıkça.

Araç için özel bir bileşen eklemek için

Araç kutusunu sağ tıklatın ve ardından Choose Items.
İçinde Choose Toolbox Items iletişim kutusunda, tıklatın SSIS denetim akış öğeler bir görev için SEKME veya SSIS veri akışı öğeleri sekmesinde veri akışı bileşeni için.
Bileşeniniz yanındaki onay kutusunu tıklatın ve ardından Tamam.

[!NOT]

Bileşen listesinde görüntülenmiyorsa, tıklayabilirsiniz göz bileşeni kendiniz bulun. Ancak bu durumda o düzgün yüklenmemiş olabilir.

Dağıtım sorunlarını giderme

Özel nesne görünüyorsa araç ya da listesi kullanılabilir nesneler, ama sen are değil güçlü-e doğru bir paket eklemek için aşağıdakileri deneyin:

Genel birleştirme önbelleği, bileşenin birden çok sürümü için bak. Genel birleştirme önbelleği bileşeni birden çok sürümü varsa, tasarımcı bileşeninizi yüklemek mümkün olmayabilir. Genel derleme önbelleğinden derleme tüm örneklerini silin ve yeniden derleme.
Derleme yalnızca tek bir örneğini dağıtım klasöründe bulunduğundan emin olun.
Araç sıfırlayın.
Ekleme Visual Studioiçin devenv.exeve hiçbir ayrıcalık gerçekleşeceğinden emin olmak için başlatma kodunuzu adım için bir kesme noktası.

Sınama ve hata ayıklama kodunuzu

Başlatmak için hata ayıklama özel nesne çalıştırma yöntemleri için basit bir yaklaşım olduğunu dtexec.exedan Visual Studiosonra özel nesne oluşturma ve bileşen kullanan bir paketi çalıştırın.

Gibi bileşen tasarım zamanı yöntemleri hata ayıklamak istiyorsanız Validateyöntemi, ikinci bir örneğini bileşen kullanan bir paketi açın Visual Studiove ekleyin, devenv.exeişlem.

Ayrıca bir paketi açıp çalışan bileşen çalıştırma yöntemleri hata ayıklamak istiyorsanız SSISde iliştirebilirsiniz böylece tasarımcı, paketi yürütme bir duraklama zorlamak gerekir DtsDebugHost.exeişlem.

Nesne çalıştırma yöntemleri için dtexec.exe ekleyerek hata ayıklamak için

Kayıt ve Debug yapılandırma projenizde oluşturmak, o dağıtmak ve bu konuda ileride açıklandığı genel birleştirme önbelleğine yüklemek.
Tarih Debug sekmesini Proje Özellikleriseçin dış programı başlatmak olarak Başlatmak eylembulun dtexec.exe, hangi varsayılan olarak C:\Program Files\Microsoft SQL Server\100\DTS\Binn yüklü.
İçinde komut satırı seçenekleri altındaki metin kutusuna Başlatma seçenekleri, senin bileşen kullanan bir paketi çalıştırmak için gerekli komut satırı bağımsız değişkenleri girin. Çoğu komut satırı bağımsız değişkenini dtsx dosya yolunu ve dosya adını /f [ILE] anahtarı oluşacaktır. Daha fazla bilgi için, bkz. dtexec Utility.
Kesme noktaları, uygun yerlere, bileşen çalıştırma yöntemleri kaynak kodu ayarlayın.
Projenizi çalıştırın.

SQL Server veri araçları ekleyerek özel nesne tasarım zamanı yöntemleri hata ayıklamak için

Kayıt ve Debug yapılandırma projenizde oluşturmak, o dağıtmak ve bu konuda ileride açıklandığı genel birleştirme önbelleğine yüklemek.
Kesme noktaları, uygun yerlere özel nesne tasarım zamanı yöntemleri kaynak kodu ayarlayın.
İkinci bir örneğini açın Visual Studiove bir Integration Servicesözel nesne kullanan bir paketi içeren proje.
Gelen ilk örneğini Visual Studioikinci örneğine ekleyin devenv.exeseçerek paketi yüklü işlemi Ekle dan Debug menü ilk örneği.
İkinci örneğinden paketi çalıştırın Visual Studio.

Özel nesne çalıştırma yöntemleri için SQL Server veri araçları ekleyerek hata ayıklamak için

Önceki yordamda listelenen adımları tamamladıktan sonra size iliştirebilirsiniz böylece paketi yürütme bir duraklama zorla DtsDebugHost.exe. Bir kesme noktası ekleyerek bu duraklama zorlayabilir OnPreExecuteolay, ya da Script görev projenize eklemek ve kalıcı ileti kutusunu görüntüleyen komut girerek.
Paketi çalıştırın. Duraklama meydana geldiğinde, örneğine geçiş Visual Studiohangi kod projenizi açın ve Seç içinde işlemi Ekle dan Debug menü. Örneğine eklemek emin olun DtsDebugHost.exeyer yönetilebilir, x 86 içinde türü değil örneği olarak listelenen sütun x 86 sadece.
Duraklatılmış paketi ve kesme noktası devam ya tıklatarak Tamam Script görev tarafından harekete geçirilen ileti kutusunu kapatmak ve paketi yürütme ve hata ayıklama devam edin.