Bileşen Kod Düzenleyicisi'nde komut dosyası bileşeni yapılandırma
Komut dosyası bileşen özel kod yazmadan önce oluşturmak istediğiniz veri akışı bileşeni türünü seçin — kaynak, dönüştürme veya hedef — ve bileşenin meta veriler ve özelliklerinde yapılandırın, sonra Komut dosyası dönüştürme Düzenleyicisi.
Bileşen oluşturmak için türünü seçme
Veri akışının bölmesine komut dosyası bileşeni eklediğinizde, SSIS Tasarımcısı, Script bileşeni türünü seç iletişim kutusu görüntülenir.Kaynak, dönüştürme veya hedef bileşeni, önceden yapılandırın.İlk seçiminizi yaptıktan sonra bileşenin yapılandırmaya devam edebilirsiniz Komut dosyası dönüşümü Düzenleyicisi.
İçin küme komut dosyası bileşeni kullanımı için varsayılan komut dosyası dili komut dosyası dili üzerinde seçenek Genel sayfa seçenekleri iletişim kutusu.Daha fazla bilgi için bkz: Genel sayfası.
İki tasarım modunu anlama
De SSIS Tasarımcısı, komut dosyası bileşeni iki modu vardır: meta veriler Tasarım modunda ve kod tasarım modu.
Açtığınızda Komut dosyası dönüşümü Düzenleyicisi, bileşen meta veriler Tasarım moduna girer.Bu modda giriş sütunları seçin ekleyin veya çıkış ve çıktı sütunları yapılandırma, ancak kodu yazamazsınız.Bileşenin meta veriler yapılandırdıktan sonra komut dosyası yazmak için kod Tasarım moduna geçiş yapabilirsiniz.
Tıklatarak kod Tasarım moduna geçirdiğinizde Komut dosyasını düzenle, komut dosyası bileşeni ek değişiklikleri önlemek için meta veriler kilitler ve temel kodu girişleri ve çıkışları meta veriler otomatik olarak oluşturur.Otomatik kod tamamlandıktan sonra özel kodunuzu girin olacaktır.Kodunuzu erişim arabellekleri ve arabellekleri sütunlarda giriş satırları işlemek ve bağlantı yöneticileri ve değişkenleri paket, tüm türü kesin olarak belirtilmiş nesneleri almak için otomatik oluşturulan temel sınıfları kullanır.
Kod Tasarım modunda özel kodunuzu girdikten sonra tekrar meta veriler Tasarım moduna geçiş yapabilirsiniz.Girdiğiniz herhangi bir kod silinmez; Ancak, sonraki değişiklikler için meta veriler yeniden oluşturulabilir temel sınıfa neden.Daha sonra özel kodunuz tarafından başvurulan nesneler artık varolmayabilir veya değiştirilmiş olabilir çünkü bileşeninizin doğrulama başarısız olabilir.Bu durum, böylece yeniden oluşturulduktan temel sınıf karşı başarılı bir şekilde Derlenebilir kod el ile düzeltmeniz gerekir.
Meta veri Tasarım modunda bileşen yapılandırma
meta veriler Tasarım modunda giriş sütunları seçin ekleyin ve çıkış ve çıktı sütunları yapılandırma, ancak kodu yazamazsınız.Bileşenin meta veriler yapılandırdıktan sonra komut dosyası yazmak için kod Tasarım moduna geçin.
Özel Düzenleyicisi'nde yapılandırmanız gerekir özellikleri komut dosyası bileşeni'nin kullanımına bağlı olarak değişir.Komut dosyası bileşeni bir kaynak, dönüştürme veya hedef olarak yapılandırılabilir.Bileşen nasıl kullanıldığına bağlı olarak, bu bir giriş veya çıkış veya her ikisini birden destekler.Yazacak, özel kod giriş ve çıkış satır ve sütunları işler.
Giriş sütunlar sayfasında, komut dosyası dönüşümü Düzenleyicisi
The Input Columns page of the Script Transformation Editor is displayed for transformations and destinations, but not for sources.Bu sayfa, kendi özel komut dosyası kullanımına ve salt okunur belirtin veya/access onları okuma istediğiniz kullanılabilir giriş sütunları seçin.
Oluşturulacak proje kod, bu meta veriler üzerinde BufferWrapper proje tabanlı öğe için her giriş ve her sütun seçili giriş için bu sınıf yazılı erişeni özelliklerini içerir bir sınıf içerir.Tamsayı seçin, örneğin, CustomerID sütun ve bir dize MüşteriAdı adlı bir giriş sütun CustomerInput, BufferWrapper proje öğe içerecek bir CustomerInput , türetir sınıfı ScriptBufferve CustomerInput sınıf açığa çıkaran adlı bir tamsayı özellik CustomerID adlı bir dize özelliğini MüşteriAdı.Bu kuralı ile tür denetlemesi aşağıdaki gibi kodlar yazmanıza olanak sağlar:
Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName
Giriş sütunları belirli bir türü için yapılandırma hakkında daha fazla bilgi için veri akışı bileşeni, altında uygun örnek görmek Komut dosyası bileşenleri belirli türleri geliştirme.
Girişleri ve çıkışları sayfayı, komut dosyası dönüşümü Düzenleyicisi
The Input and Outputs page of the Script Transformation Editor is displayed for sources, transformations, and destinations.Bu sayfa, Ekle, Kaldır ve girdileri, çıktıları ve özel komut dosyanızda, aşağıdaki sınırlamalar içinde kullanmak istediğiniz çıktı sütunları yapılandırma:
Bir kaynak olarak kullanıldığında, Script bileşeni herhangi bir giriş vardır ve birden çok çıkış destekler.
Dönüştürme olarak kullanıldığında, Script bileşeni bir giriş ve birden fazla çıkışı destekler.
Hedef olarak kullanıldığında, Script bileşeni bir giriş destekler ve çıkış vardır.
Oluşturulacak proje kod, bu meta veriler üzerinde BufferWrapper proje tabanlı öğe her giriş ve çıkış için bir sınıf içerir.Örneğin adlı bir çýktý yaratmak, CustomerOutput, BufferWrapper proje öğe içerecek bir CustomerOutput , türetir sınıfı ScriptBufferve CustomerOutput sınıf oluşturulan her çıktı sütununa yazılan erişeni özelliklerini içerir.
Yalnızca çıktı sütunları yapılandırma giriş ve çıkışlarını sayfa.Dönüşümleri ve hedefleri için giriş sütunları seçebilirsiniz Giriş sütunları sayfa.BufferWrapper proje içinde oluşturduğunuz yazılı erişeni özelliklerini öğe için çıktı sütunu salt yazılır olacaktır.erişimci Özellikleri giriş sütunlar için salt okunur veya okuma/yazma türüne göre her sütun için seçmiş olduğunuz kullanım Giriş sütunları sayfa.
Girişleri ve çıkışları belirli bir türü için yapılandırma hakkında daha fazla bilgi için veri akışı bileşeni altında uygun örnek görmek Komut dosyası bileşenleri belirli türleri geliştirme.
Not
Doğrudan bir çıktı olarak bir hata çıktı Script bileşenindeki hata satırları otomatik olarak işlenmesi için yapılandıramazsınız rağmen ek bir çıktı oluşturmak ve bu çıktıya uygun olduğunda doğrudan satır komut dosyası kullanarak çıkış hata işlevselliğini yeniden üretebilir.Daha fazla bilgi için bkz: Hata çıktı Script bileşeni için taklit etme.
ExclusionGroup ve SynchronousInputID özelliklerini çıkışları
The ExclusionGroup property has a non-zero value only in transformations with synchronous outputs, where your code performs filtering or branching and directs each row to one of the outputs that share the same non-zero ExclusionGroup value.Örneğin, varsayılan çıkış veya bir hata çıktı satırları dönüştürme yönlendirebilirsiniz.Bu senaryo için ek çıkışlar oluşturduğunuzda, emin olun küme değeri SynchronousInputID özellik ile eşleşen tam ID bileşenin giriş.
The SynchronousInputID property has a non-zero value only in transformations with synchronous outputs.Yoksa bu değer özellik sıfır, çıkış zaman uyumsuz olduğu anlamına gelir.Burada satır geçirilir aracılığıyla seçili çıktı veya çıkışları tüm yeni satırları eklemeden, zaman uyumlu çıktı için bu özellik içermesi gereken ID bileşenin giriş.
Not
Zaman Komut dosyası dönüşümü Düzenleyicisi ilk çıkışı, düzenleyici kümeleri oluşturur SynchronousInputID özellik için çıktı ID bileşenin giriş.Ancak, izleyen çıkışlarını düzenleyen oluşturur, düzenleyici ayarlar SynchronousInputID özelliklerini bu çıkışları için sıfır.
İle zaman uyumlu çıkışlarına bir bileşeni oluşturuyorsanız, her çıktı olması gerekir, SynchronousInputID özelliği küme için ID bileşenin giriş.Bu nedenle, ilk çıkış olmalıdır sonra Düzenleyici oluşturur her çıktı, SynchronousInputID değerini değiştirdiği için sıfırdan ID bileşenin giriş.
İle zaman uyumsuz çıkışlarına bir bileşeni oluşturuyorsanız, her çıktı olması gerekir, SynchronousInputID özelliği küme sıfır.Bu nedenle, ilk çıkış olması gerekir, SynchronousInputID değerini değiştirdiği dan ID bileşenin giriş için sıfır.
Satır için iki zaman uyumlu çıkışlarına Script bileşeni suna örnek için bkz: Zaman uyumlu dönüşümü Script bileşeni ile oluşturma.
Oluşturulan komut dosyası nesne adları
Script bileşeni girdileri ve çıktıları, adlarını ayrıştırmak girişleri ve çıkışları sütun adlarını ayrıştırmak ve bu adları temelinde sınıfların özellikleri BufferWrapper proje oluşturur ve öğe.Bulunan adları Unicode kategorilere ait karakterleri içerip içermediğini UppercaseLetter, LowercaseLetter, TitlecaseLetter, ModifierLetter, OtherLetter, veya DecimalDigitLetter, geçersiz karakterler atlanıyor oluşturulan adlar.Örneğin boşluk bırakılır, bu nedenle iki sütun adları olan giriş FirstName veadhem de sütun adı sahip olarak yorumlanır ad, beklenmedik ile sonuçlar.Bu durumdan kaçınmak için yalnızca bu bölümde listelenen kategorilerdeki Unicode karakterleri girdileri ve çıktıları ve komut dosyası bileşeni tarafından kullanılan giriş ve çıkış sütun adlarını içermelidir.
Sayfayı komut dosyası dönüşümü Düzenleyicisi'nin komut dosyası
Üzerinde Script sayfa Komut dosyası görev Düzenleyicisi, benzersiz bir ad ve açıklama için Script görev atamak.Aşağıdaki özelliklerin değerlerini de atayabilirsiniz.
Not
De SQL Server 2008 Integration Services (SSIS), tüm komut dosyalarının ön derlemesi.Önceki sürümlerde ön kodları ayarlayarak derlemesi olup olmadığını belirttiğiniz bir Precompile özellik için görev.
ValidateExternalMetadata özelliği
Boole değeri ValidateExternalMetadata özellik, tasarım sırasında dış veri kaynaklarına karşı doğrulama bileşeni yapıp yapmayacağını belirtir saat, ya da bunu gerçekleştirene kadar doğrulama ertelemek saat.Varsayılan olarak, bu değer özellik olan True; yani, dış meta veri geçerliliği tasarım sırasında hem de saat ve çalışma saat.Bu özellik için değer ayarlamak isteyebilirsiniz False ne zaman bir dış veri kaynağına, tasarım sırasında kullanılamaz saat: Örneğin, ne saat paket yüklemeleri kaynak veya hedef yalnızca çalışma zamanında oluşturur.
ReadOnlyVariables ve ReadWriteVariables özellikleri
Bu özelliklerin salt okunur değişkenler için kullanılabilir duruma getirir veya okuma/yazma erişimi bir bileşen kod içinde değerleri olarak varolan değişkenlerini virgülle ayrılmış listesini girin.Değişkenleri kod erişilir ReadOnlyVariables ve ReadWriteVariables Otomatik temel sınıfa özellikleriDaha fazla bilgi için bkz: Değişkenleri kullanarak Script bileşeni.
Not
Değişken adları durum duyarlıdır.
ScriptLanguage
You can select either Microsoft Visual Basic 2008 or Microsoft Visual C# 2008 as the programming language for the Script component.
Komut düğmesini düzenlemek
The Edit Script button opens the Microsoft Visual Studio Tools for Applications (VSTA) IDE in which you write your custom script.Daha fazla bilgi için bkz: Kodlama ve kod bileşen hata ayıklama.
Bağlantı yöneticileri sayfasında, komut dosyası dönüşümü Düzenleyicisi
Üzerinde Bağlantı yöneticileri sayfa Komut dosyası dönüşümü Düzenleyicisi, özel komut dosyanızı kullanmak istediğiniz bağlantı yöneticileri ekleyip.Normalde, bir kaynak veya hedef bileşeni oluşturduğunuzda, bağlantı yöneticileri başvurmak gerekir.
Oluşturulacak proje kod, bu meta veriler alarak ComponentWrapper Proje öğe içeren bir Connections koleksiyon sınıfı olan bir yazılı erişimci özellik için her seçili Bağlantı Yöneticisi.Her yazılı erişimci özellik Bağlantı Yöneticisi ile aynı ada sahiptir ve Bağlantı Yöneticisi bir başvuru geri bildirir bir örnek , IDTSConnectionManager100.Örneğin eklediğiniz adlı bir Bağlantı Yöneticisi'ni, MyADONETConnection , Bağlantı yöneticileri sayfa Editörü, bir başvuru için Bağlantı Yöneticisi'ni komut dosyanıza aşağıdaki kodu kullanarak alabilirsiniz:
Dim myADONETConnectionManager As IDTSConnectionManager100 = _
Me.Connections.MyADONETConnection
Daha fazla bilgi için bkz: Veri kaynakları Script bileşenindeki bağlanma.
|
.gif "Integration Services simgesi (küçük)")
Integration Services ile güncel kalın