Bileşen Kod Düzenleyicisi'nde komut dosyası bileşeni'ni yapılandırma
Komut dosyası bileşen özel kod yazmadan önce oluşturmak istediğiniz veri akışı bileşen türünü seçmeniz gerekir; kaynak, dönüştürme ya da hedef — ve bileşenin meta veriler ve özelliklerinde yapılandırınKomut dosyası dönüştürme Düzenleyicisi.
Bileşen oluşturma türünü seçme
Zaman veri akışı bölmesine komut dosyası bileşeni eklemeSSISTasarımcı,Komut dosyası bileşeni türünü seçin iletişim kutusu görüntülenir.Bileşen kaynak, dönüştürme veya hedef olarak, önceden.İlk bu seçimi yaptıktan sonra bileşenin yapılandırma devam edebilirKomut dosyası dönüştürme Düzenleyicisi.
komut dosyası kullanan kullanan dosyası kullanan bileşeni için varsayılan kod dilini ayarlamak içinkomut dosyası kullanan kullanan dosyası kullanan diliGenel sayfasındaki Seçenekler iletişim kutusu. seçeneği Daha fazla bilgi için bkz:Genel sayfa.
Tasarım zamanı iki mod anlama
InSSISTasarımcı, komut dosyası bileşeni iki modu vardır: Tasarım modunda meta veriler ve kodu tasarım modunu.
AçtığınızdaKomut dosyası dönüştürme Düzenleyicisimeta veriler tasarım modunu. , bileşen girer Bu mod, girdi sütun seçin ve eklemek veya çıkış ve çıktı sütunları, 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.
Zaman tıklatarak kod Tasarım moduna geçmeKomut dosyası Düzenle, komut dosyası bileşeni ek değişiklikler engellemek için meta veriler kilitler ve sonra otomatik olarak temel kodu giriş ve çıkış. meta veriler oluşturur Autogenerated kod tamamlandıktan sonra özel kodunuzu girmek olacaktır.Kod erişim arabellek ve arabellekleri, sütun satır giriş işlemi ve bağlantı yöneticileri ve değişkenleri paketin tüm kesinlikle yazılan 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.Bu, herhangi bir kod silmez; ancak yeniden temel sınıf meta veriler sonraki değişiklikler neden.Daha sonra özel kodunuz tarafından başvurulan nesne artık yok veya değiştirilmiş, bileşen doğrulaması başarısız olabilir.Bu durumda, böylece başarılı bir şekilde karşı regenerated temel sınıf Derlenebilir kod el ile düzeltmeniz gerekir.
meta veriler tasarım modunda bileşen yapılandırma
meta veriler tasarım modunda, giriş sütunları seçin ve ekleyebilir ve yapılandırabilirsiniz çıkışları ve çıktı sütunları, 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üzenleyicisinde yapılandırmalısınız özellikler, komut dosyası bileşeni kullanımı bağlıdır.Komut dosyası bileşeni, bir kaynak, dönüştürme ve bir hedef yapılandırılabilir.Bileşen nasıl kullanıldığını bağlı olarak, bu giriş veya çıkış veya her ikisini de destekler.Yazar, özel kod, giriş ve çıkış satırlarını ve sütunlarını işler.
Girişleri sütunlar sayfa, dönüştürme komut dosyası 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 veya okuma/erişim için yazma istediğiniz kullanılabilir giriş sütunları seçin.
Bu meta veriler üzerinde BufferWrapper projenin oluşturulacak Proje kodu temel öğe her giriş ve seçili sütunun her giriş için bu sınıf yazılı erişimci özellikleri içeren bir sınıf içerir.Örneğin, bir tamsayı seçinMüşteri Kimliği sütun ve giriş dizesi MüşteriAdı sütundan CustomerInput , BufferWrapper projesi adlı öğe içerecek CustomerInput, türetilmiş sınıf ScriptBufferve CustomerInputMüşteriAdı sınıf açığa çıkaran adlı bir tamsayı özellik CustomerID ve bir dize özelliğini adlı. Bu tür denetimi aşağıdaki gibi kod yazmak mümkün kılar:
Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName
Giriş sütunlar veri akışı bileşeni, belirli bir tür için yapılandırma hakkında daha fazla bilgi için ilgili örneğin altında Bkz:Belirli bir komut dosyası bileşenleri türleri geliştirme.
Giriş ve çıkış sayfa, dönüştürme komut dosyası Düzenleyicisi
The Input and Outputs page of the Script Transformation Editor is displayed for sources, transformations, and destinations.Bu sayfada eklemek, kaldırmak ve giriş, çıkış ve özel komut, aşağıdaki sınırlamalar içinde kullanmak istediğiniz çıktı sütunları yapılandırın:
Bir kaynak olarak kullanıldığında, komut dosyası bileşeni herhangi bir giriş vardır ve birden çok çıkış'ı destekler.
Bir dönüştürme kullanıldığında, bir giriş ve çıkış birden çok komut dosyası bileşeni destekler.
Hedef olarak kullanıldığında, komut dosyası bileşeni destekleyen bir giriş ve çıkış yok var.
Bu meta veriler üzerinde BufferWrapper projenin oluşturulacak Proje kodu temel öğe her giriş ve çıkış için bir sınıf içerir.Örneğin, adlandırılmış bir çıktı oluşturmakCustomerOutput, BufferWrapper proje öğesi içeriği CustomerOutput, türetilmiş sınıf ScriptBufferve CustomerOutputsınıfı, oluşturduğunuz her çıktı sütun yazılı erişimci özelliklerini içerecek.
, Çıktı sütunu yalnızca yapılandırabilirsinizGiriş ve çıkışları sayfa.Dönüşümleri ve hedefler için giriş sütunları seçebilirsinizGiriş sütunlar sayfa.BufferWrapper proje oluşturduğunuz yazılı erişimci özellikler öğe çıktı sütunu için salt olacaktır.Erişimci özelliklerini giriş sütunlar salt okunur olarak veya okuma/yazma, her sütun için seçmiş olduğunuz kullanım tipine göreGiriş sütunlar sayfa.
Giriş ve çıkış belirli bir veri türü için yapılandırma hakkında daha fazla bilgi akışı bileşen bakın altında uygun örnekBelirli bir komut dosyası bileşenleri türleri geliştirme.
Not
Komut dosyası bileşen hata satırları otomatik olarak işlenmesi için bir hata çıktı olarak bir çıkış doğrudan yapılandıramazsınız olsa da, ek bir çıktı oluşturmak ve uygun olduğunda bu çıktıyı doğrudan satır komut dosyası kullanarak çıkış hata işlevselliğini yeniden oluşturabilirsiniz.Daha fazla bilgi için bkz:Komut dosyası bileşeni için bir hata çıktı benzetme.
ExclusionGroup ve SynchronousInputID özelliklerini çıkış
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, dönüştürme satırları varsayılan çıkış veya bir hata çıktı yönlendirebilirsiniz.Bu senaryo için ek çıkış oluşturduğunuzda, emin olun küme değerininSynchronousInputIDözellik ile eşleşen tamIDbileşenin giriş.
The SynchronousInputID property has a non-zero value only in transformations with synchronous outputs.Yoksa bu değeri özellik sıfır, çıkış zaman uyumsuz olduğu anlamına gelir.Burada satır geçirilen ile çıkış ve seçili çıktı için tüm yeni satırları eklemeden, zaman uyumlu bir çıktı için bu özellik bulunması gerekirIDbileşenin giriş.
Not
,Komut dosyası dönüştürme Düzenleyicisi ilk çıkış oluşturur, ayarlar Düzenleyici SynchronousInputIDçıktısına özellik IDbileşenin girdi.Düzenleyici Düzenleyici sonraki çıkışları oluşturur, ancak ayarlarSynchronousInputIDözelliklerini bu çıkış sıfır.
İle eş zamanlı çıkış bileşeni oluşturuyorsanız, her çıktı olmalıdır,SynchronousInputIDözelliği küme içinIDbileşenin giriş.Bu nedenle, ilk çıkış olmalıdır sonra Düzenleyici oluşturduğu her çıktı,SynchronousInputIDdeğeri değiştiğinde sıfıra gelenIDbileşenin giriş.
Bileşeni ile uyumsuz çıkış oluşturuyorsanız, her çıktı olmalıdır,SynchronousInputIDözellik ayarlamak için sıfır.Bu nedenle, ilk çıkış olmalıdır,SynchronousInputIDdeğeri değiştiğinde gelenIDbileşenin giriş sıfır.
Satır için bir komut dosyası bileşeni, iki eşzamanlı çıkış yönlendirme örneği için bkz:Zaman uyumlu bir dönüştürme komut dosyası bileşeni ile oluşturma.
Oluşturulan komut nesnesi adları
Komut dosyası bileşeni girişleri ve çıkışları, adlarını ayrıştırmak için kullandığı giriş ve çıkış sütun adlarını ayrıştırmak ve bu adları temel sınıflar ve özellikleri BufferWrapper proje öğesi oluşturur.Bulunan adları karakterleri, değil ait Unicode kategorileri ekleyinUppercaseLetter,LowercaseLetter,TitlecaseLetter,ModifierLetter,OtherLetter, orDecimalDigitLettergeçersiz karakterleri bırakılan oluşturulan adlar.Örneğin, boşluk kesildiğinde, bu nedenle iki giriş sütun adları olanAdıadıher ikisi de sütun adı ad , beklenmeyen sonuçlar. ile olarak yorumlanır ve Ayrıntılar Bu durumu önlemek için giriş ve çıkışları ve komut dosyası bileşeni tarafından kullanılan giriş ve çıkış sütunların adları yalnızca Unicode kategorileri bu bölümde listelenen karakter içermelidir.
Komut dosyası, dönüştürme komut dosyası düzenleyicisi sayfa
,Komut dosyası sayfanın benzersiz bir ad ve açıklama için komut dosyası görev. atamak Kod görev DüzenleyicisiAşağıdaki özelliklerin değerlerini de atayabilirsiniz.
Not
InSQL Server 2008 Integration Services (SSIS), tüm komut dosyalarını derlemesi.Önceki sürümlerinde, komut dosyaları olarak derlemesi olup olmadığını belirttiğiniz birPrecompileözellik görev.
ValidateExternalMetadata özellik
The BooleValidateExternalMetadataözellik belirtir olup bileşeni gerçekleştirme doğrulama tasarım zamanında, dış veri kaynaklarına karşı veya yoksa, ertelemek doğrulama kadar çalışma saat.Varsayılan olarak, bu özelliğin değeri değil.True; yani, dış meta veriler olan tasarım sırasında her ikisi de geçerli saat ve çalışma saat.Bu özellik değerini ayarlamak isteyebilirFalse, dış veri kaynağı kullanılamaz tasarım sırasında saat: Örneğin, paket kaynak yükler veya hedef oluşturur yalnızca çalışma zamanı.
ReadOnlyVariables ve ReadWriteVariables özellikleri
Değişken için salt okunur veya okuma/yazma erişimi bileşenini komut dosyası kodu içinde bu özelliklerin değerleri olarak mevcut değişkenleri virgülle sınırlanmış listesini girin.Değişkenlerine erişilir koduReadOnlyVariables()veReadWriteVariables()autogenerated temel class. özellikleriDaha fazla bilgi için bkz:Komut dosyası bileşen değişkenleri kullanma.
Not
Değişken adları büyük/küçük 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üğmesi düzenleme
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öneticisi sayfa, dönüştürme komut dosyası Düzenleyicisi
,Bağlantı Yöneticisi sayfa Dönüştürme komut dosyası Düzenleyicisi'ni, ekler ve kullanmak istediğiniz kendi özel script. bağlantı Yöneticiler kaldırma Normal olarak, kaynak veya hedef bileşeni oluşturduğunuzda, bağlantı Yöneticiler başvuru gerekir.
Kod oluşturulacak proje Bu meta veriler temel alanComponentWrapperProje öğesi içeren birConnectionskoleksiyon sýnýfýný olan bir yazılı bir erişimci özellik her seçili Bağlantı Yöneticisi.Her yazılı erişimci özellik, Bağlantı Yöneticisi ile aynı ada sahip ve örnek olarak Bağlantı Yöneticisi bir başvuru verirIDTSConnectionManager100.Örneğin, adı Bağlantı Yöneticisi eklenmişMyADONETConnection,Bağlantı Yöneticisi Sayfa Düzenleyicisi Bağlantı Yöneticisi bir başvuru komut dosyanıza aşağıdaki kodu kullanarak alabilirsiniz:
Dim myADONETConnectionManager As IDTSConnectionManager100 = _
Me.Connections.MyADONETConnection
Daha fazla bilgi için bkz:Veri kaynakları Kod bileşenindeki bağlanılıyor.
|
.gif "Integration Services icon (small)")
tümleştirme Services ile güncel kalınSee Also